--- 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%
を指定します。circle
disc
square
4 つ目の行頭記号の形状として、 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 プロパティ: