CSS-справочникВ стандарте

CSS :user-invalid — как работает

CSS :user-invalid: принцип работы, корректный синтаксис, практический сценарий, ограничения, ошибки и актуальная совместимость.

Суть темы

У темы «:user-invalid» есть конкретная роль в области «псевдоклассы». Псевдокласс :user-invalid сопоставляет элемент с определённым состоянием или структурным условием. Для «:user-invalid» в интерфейсе, которым управляют только клавиатурой используйте порядок фокуса в дереве доступности и сравнивайте базовый и улучшенный вариант рядом.

Практическое правило для :user-invalid

Перед применением «:user-invalid» сформулируйте ожидаемое поведение, затем не полагайтесь только на hover и сохраняйте эквивалентное состояние клавиатурного фокуса. Для «:user-invalid» такое сравнение показывает реальную причину изменения.

Синтаксис :user-invalid

Для демонстрации «:user-invalid» используется короткий код с наблюдаемым результатом. Сохраните структуру примера, когда будете проверять другое значение.

css
.button:user-invalid {
  outline: 2px solid #2563eb;
  outline-offset: 3px;
}
Открыть в Playground

Как работает :user-invalid

Механика «:user-invalid» начинается с допустимого контекста и заканчивается наблюдаемым результатом. Селектор пересчитывается браузером при изменении состояния или структуры DOM; для «:user-invalid» отдельно проверьте порядок фокуса в дереве доступности.

Проверка в проекте

  • Не полагайтесь только на hover и сохраняйте эквивалентное состояние клавиатурного фокуса; результат относится непосредственно к «:user-invalid».
  • Проверить компонент внутри container query, не меняя размер окна при разборе «:user-invalid».
  • Проверьте «:user-invalid» в интерфейсе, которым управляют только клавиатурой через порядок фокуса в дереве доступности и запишите наблюдаемое изменение.
Выбор конструкции

Используйте «:user-invalid», когда требуется выбрать элемент по состоянию, положению или отношению к другим узлам; подтвердите выбор предметной проверкой: не полагайтесь только на hover и сохраняйте эквивалентное состояние клавиатурного фокуса. Для «:user-invalid» более простой вариант предпочтителен, если он сохраняет тот же смысл и поведение.

Практика с :user-invalid

Перенесите «:user-invalid» на контрольной странице и испытайте его в интерфейсе, которым управляют только клавиатурой. Сначала воспроизведите правильный результат, затем намеренно добавьте риск для «:user-invalid»: состояние :user-invalid не должно быть единственным способом увидеть важное действие или информацию.

псевдоклассы:user-invalid

Сценарий: в интерфейсе, которым управляют только клавиатурой.

Ошибки при работе с :user-invalid

01

Каскад

Состояние :user-invalid не должно быть единственным способом увидеть важное действие или информацию — это предметный риск для «:user-invalid».

02

Поддержка

Оптимизация кода до проверки корректности и доступности при использовании «:user-invalid».

03

Контекст

Загрузка тяжёлого ресурса до того, как он нужен пользователю; для «:user-invalid» проверьте это отдельно.

Поддержка :user-invalid

Для «:user-invalid» таблица собрана из закреплённой версии MDN Browser Compatibility Data. Указанная версия браузера показывает первое заявленное появление базовой поддержки «:user-invalid»; окончательное решение принимайте по аудитории конкретного проекта.

Chromeс версии 119Edgeс версии 119Firefoxс версии 88Safariс версии 16.5

Спецификация: источник 1, источник 2.

Вопросы о :user-invalid

Как понять, что «:user-invalid» выбрано правильно?

«:user-invalid» выбрано правильно, когда оно решает задачу «выбрать элемент по состоянию, положению или отношению к другим узлам», сохраняет результат в интерфейсе, которым управляют только клавиатурой и проходит предметную проверку: не полагайтесь только на hover и сохраняйте эквивалентное состояние клавиатурного фокуса.

Нужен ли запасной вариант для «:user-invalid»?

Запасной вариант для «:user-invalid» нужен, если целевой браузер или режим не обеспечивает выбранное поведение. Без улучшения «:user-invalid» должно сохранять смысл, содержимое и основное действие.

Спецификации и источники

Синтаксис и статус проверяются по HTML Living Standard, спецификациям CSS и MDN Browser Compatibility Data. Примеры и объяснения подготовлены для этого сервиса.