counter-increment

Стилевое свойство counter-increment предназначено для увеличения значения счётчика приращений, который задается свойством counter-reset. Такой счётчик подсчитывает количество отображений элементов на странице и может выводиться с помощью свойства content и псевдоэлементов ::after и ::before. Это позволяет создавать списки (в том числе многоуровневые), в которых нумерация и вид задаются через стили.

Краткая информация

Значение по умолчанию none
Наследуется Нет
Применяется Ко всем элементам
Анимируется Нет

Синтаксис

counter-increment: [<переменная> | <число>?]+ none
Описание Пример
<тип> Указывает тип значения. <размер>
A && B Значения должны выводиться в указанном порядке. <размер> && <цвет>
A | B Указывает, что надо выбрать только одно значение из предложенных (A или B). normal | small-caps
A || B Каждое значение может использоваться самостоятельно или совместно с другими в произвольном порядке. width || count
[ ] Группирует значения. [ crop || cross ]
* Повторять ноль или больше раз. [,<время>]*
+ Повторять один или больше раз. <число>+
? Указанный тип, слово или группа не является обязательным. inset?
{A, B} Повторять не менее A, но не более B раз. <радиус>{1,4}
# Повторять один или больше раз через запятую. <время>#

Значения

none
Запрещает увеличение счётчика для текущего селектора.
<переменная>

Задаёт одну или несколько переменных, для которых требуется изменить значение счётчика. Переменные разделяются между собой пробелом.
<число>
Определяет значение приращения счётчика. По умолчанию оно равно 1. Допускается использовать только положительные целые числа, отрицательные целые числа и ноль.

Возможные сочетания значений свойств counter-reset и counter-increment показаны в табл. 1.

Табл. 1. Изменение нумерации списка
Код Результат
li { list-style-type: none; }
ol { counter-reset: list -1; }
li::before {
  counter-increment: list;
  content: counter(list) ". ";
}

Список начинается с нуля.

0, 1, 2

li { list-style-type: none; }
ol { counter-reset: list; }
li::before {
  counter-increment: list 2;
  content: counter(list) ". ";
}

Выводятся все чётные числа.

2, 4, 6

li { list-style-type: none; }
ol { counter-reset: list -1; }
li::before {
  counter-increment: list list;
  content: counter(list) ". ";
}

Выводятся все нечётные числа.

1, 3, 5

li { list-style-type: none; }
ol { counter-reset: list 9; }
li::before {
  counter-increment: list;
  content: counter(list) ". ";
}

Список начинается с 10.

10, 11, 12

Пример

<!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>counter-increment</title> <style> body { counter-reset: heading; /* Инициируем счетчик */ } h2:before { counter-increment: heading; /* Указываем идентификатор счетчика */ content: "Глава " counter(heading) ". "; /* Выводим текст перед содержимым тега <h2> */ } </style> </head> <body> <h2>Теория ловли льва в пустыне</h2> <h2>Методы инверсной кинематики</h2> <h2>Ловля льва численными методами</h2> </body> </html>

Результат данного примера показан на рис. 1.

Применение свойства counter-increment

Рис. 1. Применение свойства counter-increment

Объектная модель

Объект.style.counterIncrement

Примечание

Для элементов, у которых установлено display: none, значение счётчика не меняется.

Спецификация

Спецификация Статус
CSS Lists and Counters Module Level 3 Рабочий проект
CSS Level 2 (Revision 1) Рекомендация

Браузеры

8 12 2 9.2 3 1
2.1 1 9.5 3

В таблице браузеров применяются следующие обозначения.

  • — элемент полностью поддерживается браузером;
  • — элемент браузером не воспринимается и игнорируется;
  • — при работе возможно появление различных ошибок, либо элемент поддерживается с оговорками.

Число указывает версию браузреа, начиная с которой элемент поддерживается.

См. также