ol 要素

4.5.5 ol 要素

Status: Last call for comments

カテゴリー
フロー・コンテンツ
この要素を使うことができるコンテキスト:
フロー・コンテンツが期待される場所
コンテンツ・モデル:
0 個以上の li 要素
コンテンツ属性:
グローバル属性
reversed
start
DOMインタフェース:
interface HTMLOListElement : HTMLElement {
           attribute boolean reversed;
           attribute long start;
};

ol 要素は、項目のリストを表します。その項目は意図的に順序づけされます。その順番を変えるとドキュメントの意味が変わってしまうでしょう。

そのリストの項目とは、ol 要素の子要素となる li 要素となります。その順番はツリー順となります。

reversed 属性は論理属性です。もしあれば、そのリストは降順リスト(..., 3, 2, 1)ということを表します。なければ、このリストは昇順リスト(1, 2, 3, ...)となります。

start 属性は、指定するなら、妥当な整数でなければならず、それは最初のリスト項目の順序番号を表します。

もし start 属性があれば、ユーザーエージェントは、その属性の値を決定するために、それを整数としてパースしなければいけません。デフォルト値は、その属性がなかったり、その値が参照アルゴリズムで番号に変換できなかった場合に使われますが、reversed 属性がなければ、1となります。そして、reversed 属性があれば、子の li 要素の個数になります。

リストの最初の項目の順序は、その li 要素にパース可能な値が指定された value 属性がない限り、ol 要素の start 属性に指定された番号になります。その li 要素にパース可能な値が指定された value 属性がある場合は、リストの最初の項目の順序は、その value 属性に指定された番号になります。

リストの中の後に続く項目の順序はそれぞれ、その value 属性に番号が指定されていれば、その番号になります。value 属性が指定されていなければ、reversed 属性がない場合は前の項目の順序に 1 をプラスした番号になり、reversed 属性がある場合は前の項目の順序から 1 をマイナスした番号になります。

reversed IDL 属性は、reversed コンテンツ属性の値を反映しなければいけません。

start IDL 属性は、start コンテンツ属性の値を反映しなければいけません。

次のマークアップは、順序に意味があるリストを示しています。そのため、このリストでは ol 要素が適切です。ul 要素の節をご覧になり、ul 要素を使って同じ項目を示した例と比較してみてください。

<p>私は下記の国に住んだことがあります。 (私が最初にそこに住んだ順番):</p>
<ol>
 <li>スイス
 <li>イギリス
 <li>アメリカ
 <li>ノルウェー
</ol>

リストの順序を変更したことで、ドキュメントの意味がどのように変化したかに注意してください。次の例では、最初の2つの項目の順序の変わったため、著者の出生地が変わってしまいました:

<p>私は下記の国に住んだことがあります。 (私が最初にそこに住んだ順番):</p>
<ol>
 <li>イギリス
 <li>スイス
 <li>アメリカ
 <li>ノルウェー
</ol>

※ 原文:http://www.w3.org/TR/2010/WD-html5-20100624/grouping-content.html#the-ol-element