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

CSS :in-range — как работает

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

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

«:in-range» рассматривается не как изолированный синтаксис, а как часть области «псевдоклассы». Псевдокласс :in-range сопоставляет элемент с определённым состоянием или структурным условием. Практический контекст для «:in-range» — в интерфейсе, которым управляют только клавиатурой; во время проверки проверяйте и светлую, и тёмную цветовую схему.

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

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

Синтаксис :in-range

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

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

Как работает :in-range

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

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

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

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

Практика с :in-range

Соберите «:in-range» в минимальном компоненте и проверьте предметное условие: не полагайтесь только на hover и сохраняйте эквивалентное состояние клавиатурного фокуса. Затем для «:in-range» замените содержимое длинным и сузьте контейнер до 320 px.

псевдоклассы:in-range

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

Ошибки при работе с :in-range

01

Контекст

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

02

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

Непредсказуемое наследование значения из внешнего компонента при использовании «:in-range».

03

Доступность

Проверка только мышью и только на широком экране; для «:in-range» проверьте это отдельно.

Поддержка :in-range

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

Chromeс версии 10Edgeс версии 13Firefoxс версии 29Safariс версии 5.1

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

Вопросы о :in-range

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

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

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

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

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

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