<li>

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

HTML-элемент <li> используется для создания элементов списка. Он также должен находиться в родительском элементе: упорядоченном списке (<ol>), неупорядоченном списке (<ul>), или меню (<menu>). В меню и неупорядоченных списках, элементы списка обычно отображаются с маркерами в виде круга. В упорядоченных списках, они обычно отображаются с маркерами в виде возрастающего счётчика слева, например числа или буквы.

Интерактивный пример

Категории контента Нет.
Допустимое содержимое Потоковый контент
Пропуск тегов Закрывающий тег может быть опущен, если за элементом непосредственно следует другой элемент <li> или если в родительском элементе нет больше содержимого.
Допустимые родители Элементы <ul>, <ol>, или <menu>. Хотя и не соответствует использованию, устаревший <dir> тоже может быть родительским элементом.
Допустимые ARIA-роли menuitem, menuitemcheckbox, menuitemradio, option, presentation, radio, separator, tab, treeitem
DOM-интерфейс HTMLLIElement

Атрибуты

Этот элемент включает глобальные атрибуты.

value

Этот числовой атрибут указывает на текущий порядковый номер элемента в списке, заданного с помощью элемента <ol>. Единственное разрешённое значение этого атрибута — число, даже если список отображается с римскими цифрами или буквами. Элементы списка, которые идут после элемента с таким атрибутом, нумеруются с заданного значения. Атрибут value не имеет значения для неупорядоченных списков (<ul>) или для меню (<menu>).

Примечание: Этот атрибут был убран в HTML4, но заново добавлен в HTML5. [!NOTE] Предыдущие до Gecko 9.0, отрицательные значения неправильно конвертировались в 0. Начиная с Gecko 9.0 все числовые значения воспринимаются правильно.

type

Этот символьный атрибут указывает на тип нумерации:

  • a: строчные буквы
  • A: заглавные буквы
  • i: строчные римские цифры
  • I: заглавные римские цифры
  • 1: цифрыЭтот атрибут переопределяет тип унаследованный от родительского элемента <ol> или любого другого.

    Примечание: Этот атрибут был убран: используйте CSS-свойство list-style-type взамен.

Примеры

Для более подробных примеров смотрите страницы <ol> и <ul>.

Упорядоченный список

html
<ol>
  <li>Первый элемент</li>
  <li>Второй элемент</li>
  <li>Третий элемент</li>
</ol>

Упорядоченный список с пользовательским значением

html
<ol type="I">
  <li value="3">Третий элемент</li>
  <li>Четвёртый элемент</li>
  <li>Пятый элемент</li>
</ol>

Неупорядоченный список

html
<ul>
  <li>Первый элемент</li>
  <li>Второй элемент</li>
  <li>Третий элемент</li>
</ul>

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

Specification
HTML Standard
# the-li-element

Совместимость с браузерами

BCD tables only load in the browser

Смотрите также

  • Остальные списковые HTML-элементы: <ul>, <li>, <menu> и устаревший <dir>;

  • CSS-свойства, которые были бы полезны для стилизации <li> элементов:

    • свойство list-style, для выбора стиля маркера/порядкового номера,
    • CSS счётчики, для обработки сложных вложенных списков,
    • свойство margin, для контроля отступа между элементами списка.