CKTIS / CSS
:user-invalid — campos no válidos después de interactuar
La pseudoclase :user-invalid selecciona controles de formulario no válidos solo después de una interacción que justifique mostrar un error, como intentar enviar el formulario. Así se evita marcar como erróneos los campos intactos nada más abrir la página.
Versión: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintaxis
:user-invalid:user-invalid es una pseudoclase sin argumentos. En HTML, coincide con los elementos input, textarea y select sujetos a la validación de restricciones, que no cumplen esas restricciones y cuyo estado interno user validity está establecido en true. El nombre de ese estado no significa que el valor sea válido.
A diferencia de :invalid, tiene en cuenta el historial de interacción: un campo vacío con required puede ser no válido al cargar la página sin coincidir todavía con :user-invalid. Intentar enviar el formulario es un momento importante para mostrar los errores; no des por hecho, sin embargo, que basta siempre con obtener y perder el foco. Los detalles de una activación más temprana dependen de las reglas de HTML y del navegador.
Todo elemento que coincide con :user-invalid también coincide con :invalid. En cambio, :user-valid se refiere a entradas válidas tras una interacción adecuada; no es simplemente la negación de :user-invalid, porque un campo intacto puede no coincidir con ninguna de las dos.
El ejemplo combina un borde con un texto de error, en lugar de depender únicamente del color. CSS responde al estado de validación, pero no define las restricciones ni sustituye la validación de datos en el servidor.
Ejemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Showing errors with :user-invalid</title>
<style>
input { border: 2px solid #555; }
input:user-invalid { border-color: #b00020; }
.error { display: none; }
input:user-invalid + .error { display: block; }
</style>
</head>
<body>
<form id="demo">
<label for="email">Email (required)</label>
<input id="email" type="email" required aria-describedby="email-error">
<p id="email-error" class="error">Enter a valid email address.</p>
<button type="submit">Check</button>
<button type="reset">Reset</button>
</form>
<script>
const form = document.querySelector('#demo');
const field = document.querySelector('#email');
const error = document.querySelector('#email-error');
// Keep validation local, even if the field contains a valid address.
form.addEventListener('submit', event => event.preventDefault());
field.addEventListener('invalid', event => event.preventDefault());
function report(stage) {
const visible = getComputedStyle(error).display !== 'none';
console.log(`${stage}: :invalid=${field.matches(':invalid')}, :user-invalid=${field.matches(':user-invalid')}, error=${visible ? 'visible' : 'hidden'}`);
}
report('Before validation');
form.requestSubmit();
report('After empty submit attempt');
form.reset();
report('After reset');
</script>
</body>
</html>Resultado
Before validation: :invalid=true, :user-invalid=false, error=hidden After empty submit attempt: :invalid=true, :user-invalid=true, error=visible After reset: :invalid=true, :user-invalid=false, error=hidden
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.