<li>: 列表項元素

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

<li> HTML 元素用於表示列表中的一項。它必須包含在父元素中:有序列表 (<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;
}

屬性

此元素包含全域性屬性

value

此整數屬性表示由 <ol> 元素定義的列表項的當前序號值。此屬性唯一允許的值是一個數字,即使列表以羅馬數字或字母顯示也是如此。此列表項之後的列表項將從設定的值開始繼續編號。此屬性對無序列表 (<ul>) 或選單 (<menu>) 沒有意義。

type 已棄用

此字元屬性指示編號型別

  • a:小寫字母
  • A:大寫字母
  • i:小寫羅馬數字
  • I:大寫羅馬數字
  • 1:數字

如果存在,此型別將覆蓋其父 <ol> 元素使用的型別。

注意:此屬性已棄用;請使用 CSS list-style-type 屬性代替。

示例

有關更詳細的示例,請參閱 <ol><ul> 頁面。

有序列表

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

結果

帶有自定義值的有序列表

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

結果

無序列表

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

結果

技術摘要

內容類別 無。
允許內容 流內容.
標籤省略 如果列表項後面立即是另一個 <li> 元素,或者其父元素中沒有更多內容,則可以省略結束標籤。
允許父級 一個 <ul><ol><menu> 元素。儘管不是符合規範的用法,但已廢棄的 <dir> 也可以作為父元素。
隱式 ARIA 角色 當是 <ol><ul><menu> 的子元素時為 listitem
允許的 ARIA 角色 menuitemmenuitemcheckboxmenuitemradiooptionnonepresentationradioseparatortabtreeitem
DOM 介面 HTMLLIElement

規範

規範
HTML
# the-li-element

瀏覽器相容性

另見

  • 其他與列表相關的 HTML 元素:<ul><ol><menu> 以及已廢棄的 <dir>
  • 對樣式設定 <li> 元素特別有用的 CSS 屬性
    • list-style 屬性,用於選擇序號的顯示方式,
    • CSS 計數器,用於處理複雜的巢狀列表,
    • margin 屬性,用於控制列表項的縮排。