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

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

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

Когда применять

«:focus-within» рассматривается не как изолированный синтаксис, а как часть области «псевдоклассы». Псевдокласс :focus-within сопоставляет элемент с определённым состоянием или структурным условием. Практический контекст для «:focus-within» — в форме с сообщением об ошибке; во время проверки не добавляйте новую обёртку до объяснения её роли.

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

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

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

Пример «:focus-within» оставляет только контекст, необходимый для области «псевдоклассы». Измените одно значение и проследите результат в браузере.

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

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

Чтобы объяснить работу «:focus-within», проследите путь от структуры и входного значения до отображения или поведения. Селектор пересчитывается браузером при изменении состояния или структуры DOM. Контрольная точка для «:focus-within» — состояние при пустом содержимом.

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

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

Оставляйте «:focus-within» в решении только после проверки в форме с сообщением об ошибке. Если нативная конструкция решает задачу «:focus-within» с меньшим числом условий, используйте её.

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

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

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

Сценарий: в форме с сообщением об ошибке.

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

01

Контекст

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

02

Устойчивость

Зависимость результата от placeholder вместо постоянной подписи при использовании «:focus-within».

03

Доступность

Дублирование интерактивной роли без нативного управления; для «:focus-within» проверьте это отдельно.

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

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

Chromeс версии 60Edgeс версии 79Firefoxс версии 52Safariс версии 10.1

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

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

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

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

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

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

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

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