HTML - <li>

The HTML <li> element (or HTML List Item Element) 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.

Example

 

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

The above HTML will output:

  1. first item
  2. second item
  3. third item
HTML
<ol type="I">
    <li value="3">third item</li>
    <li>fourth item</li>
    <li>fifth item</li>
</ol>	

The above HTML will output:

  1. third item
  2. fourth item
  3. fifth item
HTML
<ul>
    <li>first item</li>
    <li>second item</li>
    <li>third item</li>
</ul>
  • first item
  • second item
  • third item

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

Description  

The HTML <li> element (or HTML List Item Element) 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 parent elements An <ul>, <ol>, or <menu> element. Though not a conforming usage, the obsolete <dir> can also be a parent.
DOM interface HTMLLIElement
Element type Block

Browser Compatibility  

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Yes) 1.0 (1.7 or earlier) (Yes) (Yes) (Yes)
Feature Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (Yes) 1.0 (1.0) (Yes) (Yes) (Yes)

See Also  

  • Other list-related HTML Elements: <ul>, <li>, <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.
 

Specifications  

Specification Status Comment
WHATWG HTML Living Standard
The definition of '<li>' in that specification.
Living Standard  
HTML5
The definition of '<li>' in that specification.
Recommendation  
HTML 4.01 Specification
The definition of '<li>' in that specification.
Recommendation The type attribute has been deprecated.

License

© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/html/element/li

Element HTML HTML grouping content Reference