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

CSS @counter-style — как работает

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

Суть темы

У темы «@counter-style» есть конкретная роль в области «CSS @-правила». Правило @counter-style управляет частью таблицы стилей на уровне, отличном от обычной декларации. Для «@counter-style» на странице при отключённых изображениях используйте состояние при пустом содержимом и не добавляйте новую обёртку до объяснения её роли.

Практическое правило для @counter-style

Для «@counter-style» сначала соблюдайте допустимое место @-правила и порядок относительно других правил. После этого сравните исходное и изменённое состояние «@counter-style» на одном и том же содержимом.

Синтаксис @counter-style

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

css
@counter-style markers {
  system: cyclic;
  symbols: "◆" "◇";
  suffix: " ";
}
Открыть в Playground

Как работает @counter-style

Чтобы объяснить работу «@counter-style», проследите путь от структуры и входного значения до отображения или поведения. Интерпретируется на уровне таблицы стилей, а не как обычное свойство элемента. Контрольная точка для «@counter-style» — изменение при prefers-reduced-motion.

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

  • Соблюдайте допустимое место @-правила и порядок относительно других правил; результат относится непосредственно к «@counter-style».
  • Проверить вычисленное значение в DevTools и источник победившего правила при разборе «@counter-style».
  • Проверьте «@counter-style» на странице при отключённых изображениях через состояние при пустом содержимом и запишите наблюдаемое изменение.
Выбор конструкции

Оставляйте «@counter-style» в решении только после проверки на странице при отключённых изображениях. Если нативная конструкция решает задачу «@counter-style» с меньшим числом условий, используйте её.

Практика с @counter-style

Проверьте «@counter-style» в тестовом шаблоне с длинным текстом, клавиатурным управлением и узким экраном. Отдельная проверка для «@counter-style»: соблюдайте допустимое место @-правила и порядок относительно других правил.

CSS @-правила@counter-style

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

Ошибки при работе с @counter-style

01

Доступность

Неверное положение или синтаксис @counter-style может сделать весь блок недействительным — это предметный риск для «@counter-style».

02

Каскад

Использование физической стороны там, где нужен логический отступ при использовании «@counter-style».

03

Поддержка

Использование физической стороны там, где нужен логический отступ; для «@counter-style» проверьте это отдельно.

Поддержка @counter-style

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

Chromeс версии 91Edgeс версии 91Firefoxс версии 33Safariс версии 17

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

Вопросы о @counter-style

Как понять, что «@counter-style» выбрано правильно?

«@counter-style» выбрано правильно, когда оно решает задачу «управлять условием, ресурсом или областью применения блока CSS», сохраняет результат на странице при отключённых изображениях и проходит предметную проверку: соблюдайте допустимое место @-правила и порядок относительно других правил.

Нужен ли запасной вариант для «@counter-style»?

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

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

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