li要素

1.仕様

li

一覧項目 (list item)

種類

通常要素

カテゴリ

なし

使用できるコンテキスト

• <ul>要素に 0個以上
• <ol>要素に 0個以上
• <menu>要素に 0個以上

<ul>要素に 0個以上を そのコンテンツとして、使用できます。
<ol>要素に 0個以上を そのコンテンツとして、使用できます。
<menu>要素に 0個以上を そのコンテンツとして、使用できます。

HTML5 で廃止された要素ですが、dir要素にも使用できます。

コンテンツモデル

0個以上のフローコンテンツ

0個以上のフローコンテンツが配置できます。

フローコンテンツに分類される要素は、<header>要素, <footer>要素, <main>要素, <address>要素, <ol>要素, <ul>要素, <menu>要素, <dl>要素, <table>要素, <form>要素, <fieldset>要素, <search>要素, <hr>要素, <p>要素, <pre>要素, <blockquote>要素, <figure>要素, <div>要素, <dialog>要素, <section>要素, <nav>要素, <aside>要素, <article>要素, <h1>要素, <h2>要素, <h3>要素, <h4>要素, <h5>要素, <h6>要素, <hgroup>要素, <script>要素, <noscript>要素, <template>要素, <input>要素, <textarea>要素, <select>要素, <label>要素, <button>要素, <output>要素, <progress>要素, <meter>要素, <datalist>要素, <picture>要素, <object>要素, <img>要素, <iframe>要素, <embed>要素, <video>要素, <audio>要素, <canvas>要素, <map>要素, <area>要素, <a>要素, <details>要素, <ins>要素, <del>要素, <abbr>要素, <b>要素, <bdi>要素, <bdo>要素, <cite>要素, <code>要素, <data>要素, <dfn>要素, <em>要素, <i>要素, <kbd>要素, <mark>要素, <q>要素, <s>要素, <samp>要素, <small>要素, <span>要素, <strong>要素, <sub>要素, <sup>要素, <u>要素, <var>要素, <time>要素, <ruby>要素, <br>要素, <wbr>要素, <slot>要素, テキスト です。

タグの省略

終了タグは省略できます。

li要素の直後に別の li要素が続く場合、または親要素にコンテンツがない場合は、li要素の終了タグを省略できます。

コンテンツ属性

グローバル属性 他

value属性

リスト項目の序数値

DOM インターフェイス

HTMLLIElement

1. [Exposed=Window]
2. interface HTMLLIElement : HTMLElement {
3. [HTMLConstructor] constructor();
4.  
5. [CEReactions] attribute long value;
6.  
7. // also has obsolete members
8. };

HTMLElement

1. [Exposed=Window]
2. interface HTMLElement : Element {
3. [HTMLConstructor] constructor();
4.  
5. // metadata attributes
6. [CEReactions] attribute DOMString title;
7. [CEReactions] attribute DOMString lang;
8. [CEReactions] attribute boolean translate;
9. [CEReactions] attribute DOMString dir;
10.  
11. // user interaction
12. [CEReactions] attribute (boolean or unrestricted double or DOMString)? hidden;
13. [CEReactions] attribute DOMString inert;
14. undefined click();
15. [CEReactions] attribute DOMString accessKey;
16. readonly attribute DOMString accessKeyLabel;
17. [CEReactions] attribute boolean draggable;
18. [CEReactions] attribute boolean spellcheck;
19. [CEReactions] attribute DOMString writingSuggestions;
20. [CEReactions] attribute DOMString autocapitalize;
21.  
22. [CEReactions] attribute [LegacyNullToEmptyString] DOMString innerText;
23. [CEReactions] attribute [LegacyNullToEmptyString] DOMString outerText;
24.  
25. ElementInternals attachInternals();
26.  
27. // The popover API
28. undefined showPopover();
29. undefined hidePopover();
30. boolean togglePopover(optional boolean force);
31. [CEReactions] attribute DOMString? popover;
32. };
33.  
34. HTMLElement includes GlobalEventHandlers;
35. HTMLElement includes ElementContentEditable;
36. HTMLElement includes HTMLOrSVGElement;

Element

1. [Exposed=Window]
2. interface Element : Node {
3. readonly attribute DOMString? namespaceURI;
4. readonly attribute DOMString? prefix;
5. readonly attribute DOMString localName;
6. readonly attribute DOMString tagName;
7.  
8. [CEReactions] attribute DOMString id;
9. [CEReactions] attribute DOMString className;
10. [SameObject, PutForwards=value] readonly attribute DOMTokenList classList;
11. [CEReactions, Unscopable] attribute DOMString slot;
12.  
13. boolean hasAttributes();
14. [SameObject] readonly attribute NamedNodeMap attributes;
15. sequence<DOMString> getAttributeNames();
16. DOMString? getAttribute(DOMString qualifiedName);
17. DOMString? getAttributeNS(DOMString? namespace, DOMString localName);
18. [CEReactions] undefined setAttribute(DOMString qualifiedName, DOMString value);
19. [CEReactions] undefined setAttributeNS(DOMString? namespace, DOMString qualifiedName, DOMString value);
20. [CEReactions] undefined removeAttribute(DOMString qualifiedName);
21. [CEReactions] undefined removeAttributeNS(DOMString? namespace, DOMString localName);
22. [CEReactions] boolean toggleAttribute(DOMString qualifiedName, optional boolean force);
23. boolean hasAttribute(DOMString qualifiedName);
24. boolean hasAttributeNS(DOMString? namespace, DOMString localName);
25.  
26. Attr? getAttributeNode(DOMString qualifiedName);
27. Attr? getAttributeNodeNS(DOMString? namespace, DOMString localName);
28. [CEReactions] Attr? setAttributeNode(Attr attr);
29. [CEReactions] Attr? setAttributeNodeNS(Attr attr);
30. [CEReactions] Attr removeAttributeNode(Attr attr);
31.  
32. ShadowRoot attachShadow(ShadowRootInit init);
33. readonly attribute ShadowRoot? shadowRoot;
34.  
35. Element? closest(DOMString selectors);
36. boolean matches(DOMString selectors);
37. boolean webkitMatchesSelector(DOMString selectors); // legacy alias of .matches
38.  
39. HTMLCollection getElementsByTagName(DOMString qualifiedName);
40. HTMLCollection getElementsByTagNameNS(DOMString? namespace, DOMString localName);
41. HTMLCollection getElementsByClassName(DOMString classNames);
42.  
43. [CEReactions] Element? insertAdjacentElement(DOMString where, Element element); // legacy
44. undefined insertAdjacentText(DOMString where, DOMString data); // legacy
45. };

GlobalEventHandlers

1. interface mixin GlobalEventHandlers {
2. attribute EventHandler onabort;
3. attribute EventHandler onauxclick;
4. attribute EventHandler onbeforeinput;
5. attribute EventHandler onbeforematch;
6. attribute EventHandler onbeforetoggle;
7. attribute EventHandler onblur;
8. attribute EventHandler oncancel;
9. attribute EventHandler oncanplay;
10. attribute EventHandler oncanplaythrough;
11. attribute EventHandler onchange;
12. attribute EventHandler onclick;
13. attribute EventHandler onclose;
14. attribute EventHandler oncontextlost;
15. attribute EventHandler oncontextmenu;
16. attribute EventHandler oncontextrestored;
17. attribute EventHandler oncopy;
18. attribute EventHandler oncuechange;
19. attribute EventHandler oncut;
20. attribute EventHandler ondblclick;
21. attribute EventHandler ondrag;
22. attribute EventHandler ondragend;
23. attribute EventHandler ondragenter;
24. attribute EventHandler ondragleave;
25. attribute EventHandler ondragover;
26. attribute EventHandler ondragstart;
27. attribute EventHandler ondrop;
28. attribute EventHandler ondurationchange;
29. attribute EventHandler onemptied;
30. attribute EventHandler onended;
31. attribute OnErrorEventHandler onerror;
32. attribute EventHandler onfocus;
33. attribute EventHandler onformdata;
34. attribute EventHandler oninput;
35. attribute EventHandler oninvalid;
36. attribute EventHandler onkeydown;
37. attribute EventHandler onkeypress;
38. attribute EventHandler onkeyup;
39. attribute EventHandler onload;
40. attribute EventHandler onloadeddata;
41. attribute EventHandler onloadedmetadata;
42. attribute EventHandler onloadstart;
43. attribute EventHandler onmousedown;
44. [LegacyLenientThis] attribute EventHandler onmouseenter;
45. [LegacyLenientThis] attribute EventHandler onmouseleave;
46. attribute EventHandler onmousemove;
47. attribute EventHandler onmouseout;
48. attribute EventHandler onmouseover;
49. attribute EventHandler onmouseup;
50. attribute EventHandler onpaste;
51. attribute EventHandler onpause;
52. attribute EventHandler onplay;
53. attribute EventHandler onplaying;
54. attribute EventHandler onprogress;
55. attribute EventHandler onratechange;
56. attribute EventHandler onreset;
57. attribute EventHandler onresize;
58. attribute EventHandler onscroll;
59. attribute EventHandler onscrollend;
60. attribute EventHandler onsecuritypolicyviolation;
61. attribute EventHandler onseeked;
62. attribute EventHandler onseeking;
63. attribute EventHandler onselect;
64. attribute EventHandler onslotchange;
65. attribute EventHandler onstalled;
66. attribute EventHandler onsubmit;
67. attribute EventHandler onsuspend;
68. attribute EventHandler ontimeupdate;
69. attribute EventHandler ontoggle;
70. attribute EventHandler onvolumechange;
71. attribute EventHandler onwaiting;
72. attribute EventHandler onwebkitanimationend;
73. attribute EventHandler onwebkitanimationiteration;
74. attribute EventHandler onwebkitanimationstart;
75. attribute EventHandler onwebkittransitionend;
76. attribute EventHandler onwheel;
77. };

ElementContentEditable

1. interface mixin ElementContentEditable {
2. [CEReactions] attribute DOMString contentEditable;
3. [CEReactions] attribute DOMString enterKeyHint;
4. readonly attribute boolean isContentEditable;
5. [CEReactions] attribute DOMString inputMode;
6. };

HTMLOrSVGElement

1. interface mixin HTMLOrSVGElement {
2. [SameObject] readonly attribute DOMStringMap dataset;
3. attribute DOMString nonce; // intentionally no [CEReactions]
4.  
5. [CEReactions] attribute boolean autofocus;
6. [CEReactions] attribute long tabIndex;
7. undefined focus(optional FocusOptions options = {});
8. undefined blur();
9. };

ARIA in HTML

暗黙的="listitem,generic" ARIAロール="No" aria-* 属性="GlobalAny"

暗黙的な ARIAセマンティクスは、role=listitem, generic です。
li要素がリスト要素 (ul、ol、menu) の子である場合、role=listitem。li要素がリスト要素の子でない場合は、role=generic

作成者は、暗黙的な ARIAセマンティクス, または HTML要素のネイティブセマンティクスを上書きしてはいけません。
親リスト要素に暗黙的または明示的なリストロールがある場合、listitem 以外のロールはありません (推奨されません)。それ以外の場合、親リスト要素が暗黙的または明示的なリストロールを公開していない場合は、任意のロールです。

グローバル aria-* 属性と、許可されたロールに適用される任意の aria-* 属性が記述できます。

レンダリング

ブロックボックス

リスト

1. li {
2. display: list-item;
3. text-align: match-parent;
4. unicode-bidi: isolate;
5. }
6. li[type="1"] {
7. list-style-type: decimal;
8. }
9. li[type=a s] {
10. list-style-type: lower-alpha;
11. }
12. li[type=A s] {
13. list-style-type: upper-alpha;
14. }
15. li[type=i s] {
16. list-style-type: lower-roman;
17. }
18. li[type=I s] {
19. list-style-type: upper-roman;
20. }
21. li[type=none i] {
22. list-style-type: none;
23. }
24. li[type=disc i] {
25. list-style-type: disc;
26. }
27. li[type=circle i] {
28. list-style-type: circle;
29. }
30. li[type=square i] {
31. list-style-type: square;
32. }

CSS を大雑把に読むと、 ブロックレベルのブロックコンテナボックス(ブロックボックス)を生成します。(マーカーの分のコンテナボックスも生成します。) などになります。

説明

li要素は、一覧項目を表します。

li要素は、項目(アイテム・item)を表します。
親要素が ol要素, ul要素, menu要素, dir要素の場合、要素はそれらの要素に対して定義されている様に、親要素のリストの項目になります。それ以外の場合、リスト項目には他の li要素とのリスト関連関係は定義されていません。
リストの項目は、ol要素, ul要素, menu要素, dir要素の li要素の子ノードで、ツリー順になっています。

1. <!DOCTYPE html>
2. <html lang="ja">
3. <head>
4. <meta charset="utf-8">
5. <title>li要素の例 - (Example of li element) | 離珠のHTMLでしぃ！</title>
6. </head>
7. <body>
8. <h1>li要素の例</h1>
9. <ul>
10. <li>リストアイテムＡ</li>
11. <li>リストアイテムＢ</li>
12. </ul>
13. </body>
14. </html>

このサンプルへのリンクです。
(./exli.htm)

参照元

参照元

• HTML Living Standard. 4.4.8 The li element (Last Updated 27 August 2024)
• HTML Living Standard. 15 Rendering 15.3.7 Lists (Last Updated 27 August 2024)
• HTML 5.2 W3C 勧告. 4.4.8 The li element (W3C勧告、2017年12月14日)
• HTML 5.2 W3C 勧告. 10.3.8. Lists (W3C勧告、2017年12月14日)
• HTML 5.1 W3C 勧告. 4.4.7 The li element (W3C勧告、2016年11月1日)
• HTML 5.1 W3C 勧告. 10.3.8. Lists (W3C勧告、2016年11月1日)
• HTML 5 W3C 勧告. 4.4.7 The li element (W3C勧告、2014年10月28日)
• HTML 5 W3C 勧告. 10.3.8 Lists (W3C勧告、2014年10月28日)
• HTML 4.01 Specification W3C 勧告. 10.2 Unordered lists (UL), ordered lists (OL), and list items (LI) (W3C勧告1999年12月24日)
• HTML 3.2 Reference Specification (W3C勧告1997年1月14日)
• Hypertext Markup Language - 2.0 (November 1995)
• Hypertext Markup Language (HTML) (June 1993)
• <li>: リスト項目要素 - HTML: ハイパーテキストマークアップ言語 | MDN

JSONデータ

JSON形式での、データのイメージです。

1. {
2. "li": {
3. "check": "2024-09-01",
4. "group": "List",
5. "element": "- O (%Flow)* -- list item. (Normal elements.) [None] --",
6. "attlist": {
7. "%Global;": "",
8. "value": "NUMBER #IMPLIED -- Ordinal value of the list item --",
9. },
10. "comment": "一覧項目 (list item)",
11. "point": "一覧項目を表します。",
12. "description": [
13. "項目(アイテム・item)を表します。",
14. "親要素が ol要素, ul要素, menu要素, dir要素の場合、要素はそれらの要素に対して定義されている様に、親要素のリストの項目になります。それ以外の場合、リスト項目には他の li要素とのリスト関連関係は定義されていません。",
15. "リストの項目は、ol要素, ul要素, menu要素, dir要素の li要素の子ノードで、ツリー順になっています。",
16. ],
17. "kind": "Normal",
18. "categories": "None",
19. "used": [
20. "ul li*",
21. "ol li*",
22. "menu li*",
23. ],
24. "usedsupplement": "HTML5 で廃止された要素ですが、dir要素にも使用できます。",
25. "contentmodel": "li (%Flow)*",
26. "tag": [
27. "-",
28. "O",
29. ],
30. "tagsupplement": "li要素の直後に別の li要素が続く場合、または親要素にコンテンツがない場合は、li要素の終了タグを省略できます。",
31. "attributes": {"value": "リスト項目の序数値"},
32. "dominterface": "HTMLLIElement",
33. "rendering": [
34. "Lists",
35. "Bidirectional",
36. ],
37. "reference": [
38. {
39. "title": "HTML Living Standard. 4.4.8 The li element.",
40. "href": "https://html.spec.whatwg.org/multipage/grouping-content.html#the-li-element",
41. "heading": "HTML Living Standard. 4.4.8 The li element",
42. "sub": "Last Updated 27 August 2024",
43. },
44. {
45. "title": "HTML Living Standard. 15 Rendering 15.3.7 Lists.",
46. "href": "https://html.spec.whatwg.org/multipage/rendering.html#lists",
47. "heading": "HTML Living Standard. 15 Rendering 15.3.7 Lists",
48. "sub": "Last Updated 27 August 2024",
49. },
50. {
51. "title": "HTML 5.2 W3C Recommendation. 4.4.8 The li element. W3C Recommendation, 14 December 2017.",
52. "href": "https://www.w3.org/TR/2017/REC-html52-20171214/grouping-content.html#the-li-element",
53. "heading": "HTML 5.2 W3C 勧告. 4.4.8 The li element",
54. "sub": "W3C勧告、2017年12月14日",
55. },
56. {
57. "title": "HTML 5.2 W3C Recommendation. 10.3.8. Lists.",
58. "href": "https://www.w3.org/TR/2017/REC-html52-20171214/rendering.html#section-lists",
59. "heading": "HTML 5.2 W3C 勧告. 10.3.8. Lists",
60. "sub": "W3C勧告、2017年12月14日",
61. },
62. {
63. "title": "HTML 5.1 W3C Recommendation. 4.4.7 The li element. W3C Recommendation, 1 November 2016.",
64. "href": "https://www.w3.org/TR/2016/REC-html51-20161101/grouping-content.html#the-li-element",
65. "heading": "HTML 5.1 W3C 勧告. 4.4.7 The li element",
66. "sub": "W3C勧告、2016年11月1日",
67. },
68. {
69. "title": "HTML 5.1 W3C Recommendation. 10.3.8. Lists. W3C Recommendation, 1 November 2016.",
70. "href": "https://www.w3.org/TR/2016/REC-html51-20161101/rendering.html#section-lists",
71. "heading": "HTML 5.1 W3C 勧告. 10.3.8. Lists",
72. "sub": "W3C勧告、2016年11月1日",
73. },
74. {
75. "title": "HTML 5 W3C Recommendation. 4.4.7 The li element. W3C Recommendation, 28 October 2014.",
76. "href": "https://www.w3.org/TR/2014/REC-html5-20141028/grouping-content.html#the-li-element",
77. "heading": "HTML 5 W3C 勧告. 4.4.7 The li element",
78. "sub": "W3C勧告、2014年10月28日",
79. },
80. {
81. "title": "HTML 5 W3C Recommendation. 10.3.8 Lists. W3C Recommendation, 28 October 2014.",
82. "href": "https://www.w3.org/TR/2014/REC-html5-20141028/rendering.html#lists",
83. "heading": "HTML 5 W3C 勧告. 10.3.8 Lists",
84. "sub": "W3C勧告、2014年10月28日",
85. },
86. {
87. "title": "HTML 4.01 Specification W3C Recommendation. 10.2 Unordered lists (UL), ordered lists (OL), and list items (LI). W3C Recommendation 24 December 1999.",
88. "href": "https://www.w3.org/TR/html401/struct/lists.html#h-10.2",
89. "heading": "HTML 4.01 Specification W3C 勧告. 10.2 Unordered lists (UL), ordered lists (OL), and list items (LI)",
90. "sub": "W3C勧告1999年12月24日",
91. },
92. {
93. "title": "HTML 3.2 Reference Specification. W3C Recommendation 14-Jan-1997.",
94. "href": "https://www.w3.org/TR/2018/SPSD-html32-20180315/",
95. "heading": "HTML 3.2 Reference Specification",
96. "sub": "W3C勧告1997年1月14日",
97. },
98. {
99. "title": "Hypertext Markup Language - 2.0. November 1995.",
100. "href": "https://www.ietf.org/rfc/rfc1866.txt",
101. "heading": "Hypertext Markup Language - 2.0",
102. "sub": "November 1995",
103. },
104. {
105. "title": "Hypertext Markup Language (HTML). June 1993.",
106. "href": "https://www.w3.org/MarkUp/draft-ietf-iiir-html-01.txt",
107. "heading": "Hypertext Markup Language (HTML)",
108. "sub": "June 1993",
109. },
110. {
111. "title": "MDN Web Docs. HTML <li>: The List Item element.",
112. "href": "https://developer.mozilla.org/ja/docs/Web/HTML/Element/li",
113. "heading": "<li>: リスト項目要素 - HTML: ハイパーテキストマークアップ言語 | MDN",
114. },
115. ],
116. "version": {
117. "first": "HTML",
118. "latest": "HTML Living Standard",
119. },
120. "domsupplement": {"value": "long"},
121. }
122. }

注意: 簡易に描画する為に、各項目の後ろに , を付与しています。JSON の形式では、末尾の項目の後には , は付けません。

最終確認日

2024-09-01

2.使用できるコンテキスト

3.コンテンツモデル

4.コンテンツ属性

5.DOM インターフェイス

6.アクセシビリティ

7.レンダリング

8.気を付ける点