概要
HTML の リストアイテム要素(<li>)は、リストの項目を表す為に用いられます。この要素は、そのアイテムが属する、順序リスト (<ol>)、順不同リスト(<ul>)、メニュー(<menu>) の何れかの子要素として配置する必要があります。メニュー要素及び順不同リスト要素内に於いては、各リストアイテムは通常ビュレットを伴って表示され、順序リスト内では、数字や文字による連番のリストマーカーを伴って描画されます。
| コンテンツカテゴリ | なし |
|---|---|
| 許可された内容 | フローコンテンツ |
| タグの省略 | 直後に別の <li> 要素が続く場合、または他のリストアイテムが続くことなく親要素が閉じられる場合は、終了タグが省略可能です。 |
| 許可された親要素 | <ul>、<ol>、<menu>。すでに廃止されているが、<dir> の子要素としても配置可能であった。 |
| DOM インターフェイス | HTMLLIElement |
| 要素タイプ | ブロック |
属性
他の全ての要素と同様に、この要素はグローバル属性をサポートします。
value- この整数値の属性は
<ol>要素で定義されたリスト内に於ける、そのリストアイテムの序数値を示します。値には整数値のみが指定できます。例えば CSS でマーカーが数字でなく文字で表示されるような指定をしている様な場合にも、この属性の値は整数値で指定しなくてはなりません。 後続するリストアイテムのマーカーは、属性値を指定したアイテムの序数値を基準にカウントして表示されます。順不同リスト(<ul>) や メニュー (<menu>) の各アイテムに対する value 属性の指定は、通常、意味の無いものです。注記: この属性は HTML4 で一度廃止され、HTML5 で再導入されました。注記: Gecko 9.0 より前のバージョンでは、負の値は 0 に変換されていました。Gecko 9.0 からは、負数を含む全ての整数値が正しく解析されるようになっています。
type- この文字列の属性は、表示するリストマーカーの種類を指定するものです。
a: 小文字A: 大文字i: 小文字のローマ数字I: 大文字のローマ数字1: 数字
<ol>要素にもこの属性が指定されている場合、子の要素に指定された属性が優先されます。使用上の注意: この属性は既に廃止されています。代わりにCSS のlist-style-typeプロパティを用います。
例
<ol>
<li>最初のリストアイテム</li>
<li>二番目のリストアイテム</li>
<li>三番目のリストアイテム</li>
</ol>
以下のように出力されます:
- 最初のリストアイテム
- 二番目のリストアイテム
- 三番目のリストアイテム
<ol type="I">
<li value="3">third item</li>
<li>fourth item</li>
<li>fifth item</li>
</ol>
以下のように出力されます:
- 三番目のリストアイテム
- 四番目のリストアイテム
- 五番目のリストアイテム
<ul>
<li>最初のリストアイテム</li>
<li>二番目のリストアイテム</li>
<li>三番目のリストアイテム</li>
</ul>
以下のように出力されます:
- 最初のリストアイテム
- 二番目のリストアイテム
- 三番目のリストアイテム
更に詳しい記述例については、<ol> と <ul> のページを参照して下さい。
仕様
| 仕様書 | 策定状況 | コメント |
|---|---|---|
| WHATWG HTML Living Standard <li> の定義 |
現行の標準 | |
| HTML5 <li> の定義 |
勧告 | |
| HTML 4.01 Specification <li> の定義 |
勧告 |
ブラウザ実装状況
| 機能 | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| 基本サポート | (有) | 1.0 (1.7 or earlier) | (有) | (有) | (有) |
| 機能 | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|
| 基本サポート | (有) | 1.0 (1.0) | (有) | (有) | (有) |
参照
- 他のリスト関連 HTML 要素:
<ul>、<li>、<menu>、<dir> <li>の整形に便利な CSS プロパティ:- 序列マークやビュレットの種類を選択する為の
list-style - 複雑な入れ子状リストを処理するのに使用出来る CSS counters
- リストアイテムのインデントの調整に用いる事が出来る
margin
- 序列マークやビュレットの種類を選択する為の