refactor: using :user-*valid from now on (#936)

mfranzke · web-flow · commit d9dc1c1ddf60 · 2024-08-22T07:53:51.000Z
diff --git a/source/_patterns/01-elements/_form-elements.scss b/source/_patterns/01-elements/_form-elements.scss
@@ -94,14 +94,12 @@
 // TODO: maybe we could totally restructure this, work with a :not(select) instead, differentiate in between user-invalid and provide a fallback (https://github.com/db-ui/mono/pull/893), etc.
 %form-element-validation {
 	&:not([aria-invalid]) {
-		&:not(:placeholder-shown) {
-			&:valid {
-				--formElement---borderColor: #{$db-color-green-600};
-			}
-
-			&:invalid {
-				--formElement---borderColor: #{$db-color-red-500};
-			}
+		&:user-valid {
+			--formElement---borderColor: #{$db-color-green-600};
+		}
+
+		&:user-invalid {
+			--formElement---borderColor: #{$db-color-red-500};
 		}
 	}
 }
diff --git a/source/_patterns/01-elements/input/_input.md b/source/_patterns/01-elements/input/_input.md
@@ -24,7 +24,7 @@ The attribute doesn't even only take boolean values, but even also a list of spe
 
 Please have a look especially at the section for form validation within the overall [components/forms](../components-form/index.html) page.
 
-Additionally to the browser built-in pseudo-selector `:invalid` we're providing styling for the [`aria-invalid="true"` attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-invalid_attribute) as well.
+Additionally to the browser built-in pseudo-selector `:user-invalid` we're providing styling for the [`aria-invalid="true"` attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-invalid_attribute) as well.
 
 ## Accessibility support
 
diff --git a/source/_patterns/01-elements/input/input~invalid-attribute.md b/source/_patterns/01-elements/input/input~invalid-attribute.md
@@ -8,4 +8,4 @@ order: 7
 
 Please have a look especially at the section for form validation within the overall [components/forms](../components-form/index.html) page.
 
-Additionally to the browser built-in pseudo-selector `:invalid` we're providing styling for the [`aria-invalid="true"` attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-invalid_attribute) as well.
+Additionally to the browser built-in pseudo-selector `:user-invalid` we're providing styling for the [`aria-invalid="true"` attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-invalid_attribute) as well.
diff --git a/source/_patterns/01-elements/radio/_radio.md b/source/_patterns/01-elements/radio/_radio.md
@@ -7,6 +7,6 @@ state: complete
 
 Please have a look especially at the section for form validation within the overall [components/forms](../components-form/index.html) page.
 
-Additionally to the browser built-in pseudo-selector `:invalid` we're providing styling for the [`aria-invalid="true"` attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-invalid_attribute) as well.
+Additionally to the browser built-in pseudo-selector `:user-invalid` we're providing styling for the [`aria-invalid="true"` attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-invalid_attribute) as well.
 
 [inspirational sources for this page]: # "https://www.uiguideline.com/components/radio"
diff --git a/source/_patterns/01-elements/radio/radio.scss b/source/_patterns/01-elements/radio/radio.scss
@@ -47,7 +47,7 @@
 	&:checked {
 		border-width: to-em($pxValue: 6);
 	}
-	// * the invalid style using the :invalid pseudo class (and [aria-invalid="true"] equivalent, see #136 and #141)
+	// * the invalid style using the :user-invalid pseudo class (and [aria-invalid="true"] equivalent, see #136 and #141)
 	&:is(:user-invalid),
 	&[aria-invalid="true"] {
 		border-color: #c13e34;
diff --git a/source/_patterns/01-elements/select/_select.md b/source/_patterns/01-elements/select/_select.md
@@ -13,6 +13,6 @@ If you would like to even also match those visual requirements, you would need t
 
 Please have a look especially at the section for form validation within the overall [components/forms](../components-form/index.html) page.
 
-Additionally to the browser built-in pseudo-selector `:invalid` we're providing styling for the [`aria-invalid="true"` attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-invalid_attribute) as well.
+Additionally to the browser built-in pseudo-selector `:user-invalid` we're providing styling for the [`aria-invalid="true"` attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-invalid_attribute) as well.
 
 [inspirational sources for this page]: # "https://www.uiguideline.com/components/select-dropdown"
diff --git a/source/_patterns/01-elements/select/select~invalid-attribute.md b/source/_patterns/01-elements/select/select~invalid-attribute.md
@@ -8,4 +8,4 @@ order: 7
 
 Please have a look especially at the section for form validation within the overall [components/forms](../components-form/index.html) page.
 
-Additionally to the browser built-in pseudo-selector `:invalid` we're providing styling for the [`aria-invalid="true"` attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-invalid_attribute) as well.
+Additionally to the browser built-in pseudo-selector `:user-invalid` we're providing styling for the [`aria-invalid="true"` attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-invalid_attribute) as well.
diff --git a/source/_patterns/01-elements/textarea/_textarea.md b/source/_patterns/01-elements/textarea/_textarea.md
@@ -7,6 +7,6 @@ state: complete
 
 Please have a look especially at the section for form validation within the overall [components/forms](../components-form/index.html) page.
 
-Additionally to the browser built-in pseudo-selector `:invalid` we're providing styling for the [`aria-invalid="true"` attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-invalid_attribute) as well.
+Additionally to the browser built-in pseudo-selector `:user-invalid` we're providing styling for the [`aria-invalid="true"` attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-invalid_attribute) as well.
 
 [inspirational sources for this page]: # "https://www.uiguideline.com/components/textarea"
diff --git a/source/_patterns/01-elements/textarea/textarea~invalid-attribute.md b/source/_patterns/01-elements/textarea/textarea~invalid-attribute.md
@@ -8,4 +8,4 @@ order: 7
 
 Please have a look especially at the section for form validation within the overall [components/forms](../components-form/index.html) page.
 
-Additionally to the browser built-in pseudo-selector `:invalid` we're providing styling for the [`aria-invalid="true"` attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-invalid_attribute) as well.
+Additionally to the browser built-in pseudo-selector `:user-invalid` we're providing styling for the [`aria-invalid="true"` attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-invalid_attribute) as well.
diff --git a/source/_patterns/02-components/form/_form.md b/source/_patterns/02-components/form/_form.md
@@ -24,7 +24,7 @@ It's best to use the built-in and standard form validation, as these are standar
 
 Additionally this way you're following the principles of Progressive Enhancement - and in other words, any JavaScript only solution doesn't provide a graceful degradation and puts that whole functionality to the weakest layer in the stack even only.
 
-Nevertheless additionally to the browser built-in pseudo-selector `:invalid` we're providing styling for the [`aria-invalid="true"` attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-invalid_attribute) on the elements `input`, `radio`, `select` and `textarea`.
+Nevertheless additionally to the browser built-in pseudo-selector `:user-invalid` we're providing styling for the [`aria-invalid="true"` attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-invalid_attribute) on the elements `input`, `radio`, `select` and `textarea`.
 We can't toggle any given/static attribute in the DB UI Core product itself, as we don't want to use JavaScript in this basic product. As you'd also need to add individual error messages, please find some inspiration on the necessary HTML code implementation e.g. on <http://mars.dequecloud.com/demo/form-alert3.htm>
 
 Please find some more informations on the following pages:

Original file line number	Diff line number	Diff line change
`@@ -8,4 +8,4 @@ order: 7`
`8`	`8`
`9`	`9`	`Please have a look especially at the section for form validation within the overall [components/forms](../components-form/index.html) page.`
`10`	`10`
`11`		-Additionally to the browser built-in pseudo-selector `:invalid` we're providing styling for the [`aria-invalid="true"` attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-invalid_attribute) as well.
	`11`	+Additionally to the browser built-in pseudo-selector `:user-invalid` we're providing styling for the [`aria-invalid="true"` attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-invalid_attribute) as well.
Original file line number	Diff line number	Diff line change
`@@ -47,7 +47,7 @@`
`47`	`47`	`&:checked {`
`48`	`48`	`border-width: to-em($pxValue: 6);`
`49`	`49`	`}`
`50`		`- // * the invalid style using the :invalid pseudo class (and [aria-invalid="true"] equivalent, see #136 and #141)`
	`50`	`+ // * the invalid style using the :user-invalid pseudo class (and [aria-invalid="true"] equivalent, see #136 and #141)`
`51`	`51`	`&:is(:user-invalid),`
`52`	`52`	`&[aria-invalid="true"] {`
`53`	`53`	`border-color: #c13e34;`