--- title: '
HTML の <ul> 要素は、項目の順序なしリストを表します。一般的に、行頭記号を伴うリストとして描画されます。
このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 https://github.com/mdn/interactive-examples をクローンしてプルリクエストを送信してください。
| コンテンツカテゴリ | フローコンテンツ。また、 <ul> 要素の子に少なくとも 1 個 {{HTMLElement("li")}} 要素を包含する場合は、知覚可能コンテンツ。 |
|---|---|
| 許可されている内容 | 0個以上の {{HTMLElement("li")}}, {{HTMLElement("script")}}, {{HTMLElement("template")}} 要素。 |
| タグの省略 | {{no_tag_omission}} |
| 許可されている親要素 | フローコンテンツを受け入れるすべての要素 |
| 暗黙の ARIA ロール | list |
| 許可されている ARIA ロール | {{ARIARole("directory")}}, {{ARIARole("group")}}, {{ARIARole("listbox")}}, {{ARIARole("menu")}}, {{ARIARole("menubar")}}, {{ARIARole("none")}}, {{ARIARole("presentation")}}, {{ARIARole("radiogroup")}}, {{ARIARole("tablist")}}, {{ARIARole("toolbar")}}, {{ARIARole("tree")}} |
| DOM インターフェイス | {{domxref("HTMLUListElement")}} |
この要素にはグローバル属性があります。
compact 属性と同様の効果を得るには、 CSS の {{cssxref("line-height")}} プロパティを用い、その値として 80% を指定します。circlediscsquare4 つ目の行頭記号の形状として、 WebTV インターフェイスで triangle が定義されていますが、すべてのブラウザーが対応しているわけではありません。
この属性が存在せず、 CSS の {{ cssxref("list-style-type") }} プロパティがその要素に適用されていない場合は、ユーザーエージェントが行頭記号の種類を、リストの入れ子階層に応じて選択します。
<ul> 要素は、数的な順序がなく、その配置順に意味を持たない項目を持つリストを表します。通常、順序なしリストの項目はドット、円形、四角形などいくつかの形式による行頭記号を伴って描画されます。行頭記号のスタイルは HTML 仕様書のページでは定義されていませんが、 CSS の {{ cssxref("list-style-type") }} プロパティを用いて変更することが可能です。<ul> 要素と {{HTMLElement("ol")}} 要素は、必要なだけ深く入れ子にすることができます。さらに言えば、入れ子になったリストが <ol> と <ul> の間で変化することにで制限はありません。<ul> は、どちらも項目のリストを表します。両者の違いは、 {{ HTMLElement("ol") }} 要素では順序に意味があることです。使い分けの目安としては、項目の順序を変更してみてください。意味が変わるようであれば {{ HTMLElement("ol") }} 要素を使用し、そうでない場合は <ul> 要素を使用することができます。<ul> <li>first item</li> <li>second item</li> <li>third item</li> </ul>
次のように出力されます。
{{EmbedLiveSample("Simple_example", 400, 100)}}
<ul>
<li>first item</li>
<li>second item
<!-- 閉じタグの </li> がここにはありません。 -->
<ul>
<li>second item first subitem</li>
<li>second item second subitem
<!-- 入れ子になった第二の順序なしリストでも同じです。 -->
<ul>
<li>second item second subitem first sub-subitem</li>
<li>second item second subitem second sub-subitem</li>
<li>second item second subitem third sub-subitem</li>
</ul>
</li> <!-- 三番目の順序なしリストを含む li の
閉じタグ </li> です -->
<li>second item third subitem</li>
</ul>
<!-- Here is the closing </li> tag -->
</li>
<li>third item</li>
</ul>
次のように出力されます。
{{EmbedLiveSample("Nesting_a_list", 400, 220)}}
<ul>
<li>first item</li>
<li>second item
<!-- ここには <li> の閉じタグはない -->
<ol>
<li>second item first subitem</li>
<li>second item second subitem</li>
<li>second item third subitem</li>
</ol>
<!-- ここに </li> を記述し、要素を閉じている -->
</li>
<li>third item</li>
</ul>
次のように出力されます。
{{EmbedLiveSample("Ordered_list_inside_unordered_list", 400, 150)}}
| 仕様書 | 状態 | 備考 |
|---|---|---|
| {{SpecName('HTML WHATWG', 'semantics.html#the-ul-element', '<ul>')}} | {{Spec2('HTML WHATWG')}} | |
| {{SpecName('HTML5 W3C', 'grouping-content.html#the-ul-element', '<ul>')}} | {{Spec2('HTML5 W3C')}} |
{{Compat("html.elements.ul")}}
<ul> 要素の整形に有益な CSS プロパティ: