<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>). В меню и неупорядоченных списках, элементы списка обычно отображаются с маркерами в виде круга. В упорядоченных списках, они обычно отображаются с маркерами в виде возрастающего счётчика слева, например числа или буквы.

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

<p>Apollo astronauts:</p>

<ul>
  <li>Neil Armstrong</li>
  <li>Alan Bean</li>
  <li>Peter Conrad</li>
  <li>Edgar Mitchell</li>
  <li>Alan Shepard</li>
</ul>

p,
li {
  font:
    1rem "Fira Sans",
    sans-serif;
}

p {
  font-weight: bold;
}
Категории контента Нет.
Допустимое содержимое Потоковый контент
Пропуск тегов Закрывающий тег может быть опущен, если за элементом непосредственно следует другой элемент <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
# the-li-element

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

BCD tables only load in the browser

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

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

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

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