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

CSS :focus-visible — как работает

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

Назначение и границы

Практический смысл «:focus-visible» связан с тем, чтобы выбрать элемент по состоянию, положению или отношению к другим узлам. Псевдокласс :focus-visible сопоставляет элемент с определённым состоянием или структурным условием. Контрольная проверка «:focus-visible» проходит на странице при отключённых изображениях, а наблюдаемой точкой служит перестроение при смене writing-mode.

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

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

Синтаксис :focus-visible

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

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

Как работает :focus-visible

Селектор пересчитывается браузером при изменении состояния или структуры DOM. Для «:focus-visible» проверьте две контрольные точки — перестроение при смене writing-mode и состояние при пустом содержимом: так видно, на каком этапе появляется итоговое поведение этой темы.

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

  • Не полагайтесь только на hover и сохраняйте эквивалентное состояние клавиатурного фокуса; результат относится непосредственно к «:focus-visible».
  • Проверить Chrome, Firefox и Safari для новой или экспериментальной возможности при разборе «:focus-visible».
  • Проверьте «:focus-visible» на странице при отключённых изображениях через перестроение при смене writing-mode и запишите наблюдаемое изменение.
Выбор конструкции

Выбор «:focus-visible» оправдан, если задача относится к области «псевдоклассы», а риск «состояние :focus-visible не должно быть единственным способом увидеть важное действие или информацию» исключён проверкой. Для «:focus-visible» сравнивайте не внешний вид, а результат для пользователя.

Практика с :focus-visible

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

псевдоклассы:focus-visible

Сценарий: на странице при отключённых изображениях.

Ошибки при работе с :focus-visible

01

Каскад

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

02

Поддержка

Потеря содержимого при печати или отключении фоновых изображений при использовании «:focus-visible».

03

Контекст

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

Поддержка :focus-visible

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

Chromeс версии 86Edgeс версии 86Firefoxс версии 85Safariс версии 15.4

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

Вопросы о :focus-visible

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

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

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

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

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

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