W3cubDocs

/HTML

<li>

The <li> is used to represent an item in a list. It must be contained in a parent element: an ordered list (<ol>), an unordered list (<ul>), or a menu (<menu>). In menus and unordered lists, list items are usually displayed using bullet points. In ordered lists, they are usually displayed with an ascending counter on the left, such as a number or letter.

Content categories None.
Permitted content Flow content.
Tag omission The end tag can be omitted if the list item is immediately followed by another <li> element, or if there is no more content in its parent element.
Permitted parents An <ul>, <ol>, or <menu> element. Though not a conforming usage, the obsolete <dir> can also be a parent.
Implicit ARIA role listitem when child of an ol, ul or menu
Permitted ARIA roles menuitem, menuitemcheckbox, menuitemradio, option, none, presentation, radio, separator, tab, treeitem
DOM interface HTMLLIElement

Attributes

This element includes the global attributes.

value
This integer attribute indicates the current ordinal value of the list item as defined by the <ol> element. The only allowed value for this attribute is a number, even if the list is displayed with Roman numerals or letters. List items that follow this one continue numbering from the value set. The value attribute has no meaning for unordered lists (<ul>) or for menus (<menu>).
Note: This attribute was deprecated in HTML4, but reintroduced in HTML5.
type
This character attribute indicates the numbering type:
  • a: lowercase letters
  • A: uppercase letters
  • i: lowercase Roman numerals
  • I: uppercase Roman numerals
  • 1: numbers
This type overrides the one used by its parent <ol> element, if any.
Note: This attribute has been deprecated; use the CSS list-style-type property instead.

Examples

For more detailed examples, see the <ol> and <ul> pages.

Ordered list

<ol>
    <li>first item</li>
    <li>second item</li>
    <li>third item</li>
</ol>

Ordered list with a custom value

<ol type="I">
    <li value="3">third item</li>
    <li>fourth item</li>
    <li>fifth item</li>
</ol>	

Unordered list

<ul>
    <li>first item</li>
    <li>second item</li>
    <li>third item</li>
</ul>

Specifications

Browser compatibilityUpdate compatibility data on GitHub

Desktop
Chrome Edge Firefox Internet Explorer Opera Safari
li Yes 12 1 Yes Yes Yes
type Yes 12 1 Yes Yes Yes
value Yes 12 1 Yes Yes Yes
Mobile
Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
li Yes Yes 4 Yes Yes Yes
type Yes Yes 4 Yes Yes Yes
value Yes Yes 4 Yes Yes Yes

See also

  • Other list-related HTML Elements: <ul>, <ol>, <menu>, and the obsolete <dir>;
  • CSS properties that may be specially useful to style the <li> element:
    • the list-style property, to choose the way the ordinal is displayed,
    • CSS counters, to handle complex nested lists,
    • the margin property, to control the indent of the list item.

© 2005–2020 Mozilla and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/HTML/Element/li