| 1 |
#en |
| 2 |
The <code title=attr-id><a href="#id">id</a></code> attribute represents |
| 3 |
its element's unique identifier. The value must be unique in the subtree |
| 4 |
within which the element finds itself and must contain at least one |
| 5 |
character. The value must not contain any <a href="#space" title="space |
| 6 |
character">space characters</a>. |
| 7 |
#ja |
| 8 |
<code title=attr-id><a href="#id">id</a></code> 属性は、 |
| 9 |
その要素の固有識別子を表します。値はその要素が現れる部分木中で固有でなければ[[MUST:ならず]]、 |
| 10 |
最低1文字含まなければ[[MUST:なりません]]。 |
| 11 |
値は<a href="#space" title="space |
| 12 |
character">間隔文字</a>を含んでは[[MUST:なりません]]。 |
| 13 |
|
| 14 |
#en |
| 15 |
If the value is not the empty string, user agents must associate the |
| 16 |
element with the given value (exactly, including any space characters) for |
| 17 |
the purposes of ID matching within the subtree the element finds itself |
| 18 |
(e.g. for selectors in CSS or for the <code>getElementById()</code> method |
| 19 |
in the DOM). |
| 20 |
#ja |
| 21 |
利用者エージェントは、値が空文字列でない場合、 |
| 22 |
その要素が現れる部分木中で ID 一致を行うために |
| 23 |
(例えば CSS の選択子や DOM の <code>getElementById()</code> |
| 24 |
メソッドのために)、 |
| 25 |
その要素に指定された値を (間隔文字も含めてそのまま) |
| 26 |
関連付けなければ[[MUST:なりません]]。 |
| 27 |
|
| 28 |
#en |
| 29 |
Identifiers are opaque strings. Particular meanings should not be |
| 30 |
derived from the value of the <code title=attr-id><a |
| 31 |
href="#id">id</a></code> attribute. |
| 32 |
#ja |
| 33 |
識別子は不透明な文字列です。特定の意味を <code title=attr-id><a |
| 34 |
href="#id">id</a></code> 属性の値から見出す[[SHOULD:べきではありません]]。 |
| 35 |
|
| 36 |
#en |
| 37 |
This specification doesn't preclude an element having multiple IDs, if |
| 38 |
other mechanisms (e.g. DOM Core methods) can set an element's ID in a way |
| 39 |
that doesn't conflict with the <code title=attr-id><a |
| 40 |
href="#id">id</a></code> attribute. |
| 41 |
#ja |
| 42 |
この仕様書は、他の仕組み (例えば DOM 中核のメソッド) によって |
| 43 |
<code title=attr-id><a |
| 44 |
href="#id">id</a></code> 属性と矛盾しない形で要素の ID |
| 45 |
を設定することができる場合に、要素が複数の ID を持つことを禁じていません。 |
| 46 |
|
| 47 |
#regexp |
| 48 |
The * DOM attribute must <a |
| 49 |
href="#reflect">reflect</a> the * content attribute. |
| 50 |
#ja |
| 51 |
$1 DOM 属性は $2 内容属性を<a |
| 52 |
href="#reflect">反映</a>しなければ[[MUST:なりません]]。 |
| 53 |
|
| 54 |
#regexp |
| 55 |
<span class=secno>* </span>The * element |
| 56 |
#ja |
| 57 |
<span class=secno>$1 </span>$2 要素 |
| 58 |
|
| 59 |
#regexp |
| 60 |
<span class=secno>* </span>The * attribute |
| 61 |
#ja |
| 62 |
<span class=secno>$1 </span>$2 属性 |
| 63 |
|
| 64 |
#en |
| 65 |
Categories |
| 66 |
#ja |
| 67 |
分類 |
| 68 |
|
| 69 |
#en |
| 70 |
<a href="#metadata0">Metadata content</a>. |
| 71 |
#ja |
| 72 |
<a href="#metadata0">メタデータ内容</a>。 |
| 73 |
|
| 74 |
#en |
| 75 |
<a href="#flow-content0">Flow content</a>. |
| 76 |
#ja |
| 77 |
<a href="#flow-content0">流れ内容</a>。 |
| 78 |
|
| 79 |
#en |
| 80 |
Contexts in which this element may be used: |
| 81 |
#ja |
| 82 |
この要素を使っても[[MAY:よい]]文脈: |
| 83 |
|
| 84 |
#en |
| 85 |
Where <a href="#flow-content0">flow content</a> is expected. |
| 86 |
#ja |
| 87 |
<a href="#flow-content0">流れ内容</a>が期待される場所。 |
| 88 |
|
| 89 |
#en |
| 90 |
Content model: |
| 91 |
#ja |
| 92 |
内容モデル: |
| 93 |
|
| 94 |
#en |
| 95 |
<a href="#phrasing0">Phrasing content</a>. |
| 96 |
#ja |
| 97 |
<a href="#phrasing0">語句付け内容</a>。 |
| 98 |
|
| 99 |
#en |
| 100 |
Element-specific attributes: |
| 101 |
#ja |
| 102 |
要素固有属性: |
| 103 |
|
| 104 |
#en |
| 105 |
None. |
| 106 |
#ja |
| 107 |
なし。 |
| 108 |
|
| 109 |
#en |
| 110 |
DOM interface: |
| 111 |
#ja |
| 112 |
DOM 界面: |
| 113 |
|
| 114 |
#en |
| 115 |
Uses <code><a href="#htmlelement">HTMLElement</a></code>. |
| 116 |
#ja |
| 117 |
<code><a href="#htmlelement">HTMLElement</a></code> を使用。 |
| 118 |
|
| 119 |
|
| 120 |
#regexp |
| 121 |
<span class=secno>* </span><dfn |
| 122 |
id=embedding0>Embedding custom non-visible data</dfn> |
| 123 |
#ja |
| 124 |
<span class=secno>$1 </span><dfn |
| 125 |
id=embedding0>カスタム非可視データの埋め込み</dfn> |
| 126 |
|
| 127 |
#en |
| 128 |
A <dfn id=custom>custom data attribute</dfn> is an attribute whose name |
| 129 |
starts with the string "<dfn id=data- |
| 130 |
title="attr-data-*"><code>data-</code></dfn>", has at least one character |
| 131 |
after the hyphen, is <a href="#xml-compatible">XML-compatible</a>, and has |
| 132 |
no namespace. |
| 133 |
#ja |
| 134 |
<dfn id=custom>カスタム・データ属性</dfn>は、 |
| 135 |
名前が文字列 "<dfn id=data- |
| 136 |
title="attr-data-*"><code>data-</code></dfn>" で始まり、 |
| 137 |
ハイフンの後最低1文字あり、 <a href="#xml-compatible">XML 互換</a>で、 |
| 138 |
名前空間を持たない属性です。 |
| 139 |
|
| 140 |
#en |
| 141 |
<a href="#custom" title="custom data attribute">Custom data |
| 142 |
attributes</a> are intended to store custom data private to the page or |
| 143 |
application, for which there are no more appropriate attributes or |
| 144 |
elements. |
| 145 |
#ja |
| 146 |
<a href="#custom" title="custom data attribute">カスタム・データ属性</a>は、 |
| 147 |
より適切な要素や属性がないような頁や応用の私的なカスタム・データを蓄積することを想定しています。 |
| 148 |
|
| 149 |
#en |
| 150 |
Every <a href="#html-elements" title="HTML elements">HTML element</a> |
| 151 |
may have any number of <a href="#custom" title="custom data |
| 152 |
attribute">custom data attributes</a> specified, with any value. |
| 153 |
#ja |
| 154 |
すべての <a href="#html-elements" title="HTML elements">HTML 要素</a>には、 |
| 155 |
任意の値の<a href="#custom" title="custom data |
| 156 |
attribute">カスタム・データ属性</a>を任意の個数指定して[[MAY:構いません]]。 |
| 157 |
|
| 158 |
#en |
| 159 |
The <dfn id=dataset title=dom-dataset><code>dataset</code></dfn> DOM |
| 160 |
attribute provides convenient accessors for all the <code |
| 161 |
title="attr-data-*"><a href="#data-">data-*</a></code> attributes on an |
| 162 |
element. On getting, the <code title=dom-dataset><a |
| 163 |
href="#dataset">dataset</a></code> DOM attribute must return a <code><a |
| 164 |
href="#domstringmap0">DOMStringMap</a></code> object, associated with the |
| 165 |
following three algorithms, which expose these attributes on their |
| 166 |
element: |
| 167 |
#ja |
| 168 |
<dfn id=dataset title=dom-dataset><code>dataset</code></dfn> DOM |
| 169 |
属性は、要素のすべての <code |
| 170 |
title="attr-data-*"><a href="#data-">data-*</a></code> 属性の便宜アクセス子を提供します。 |
| 171 |
<code title=dom-dataset><a |
| 172 |
href="#dataset">dataset</a></code> DOM 属性は、取得時、 |
| 173 |
次の3つの算法 (要素のすべての <code |
| 174 |
title="attr-data-*"><a href="#data-">data-*</a></code> 属性を露出させます。) |
| 175 |
と関連付けられた <code><a |
| 176 |
href="#domstringmap0">DOMStringMap</a></code> |
| 177 |
オブジェクトを返さなければ[[MUST:なりません]]。 |
| 178 |
|
| 179 |
#en |
| 180 |
The algorithm for getting values from names |
| 181 |
#ja |
| 182 |
名前から値を取得する算法 |
| 183 |
|
| 184 |
#en |
| 185 |
Let <var title="">name</var> be the concatenation of the string |
| 186 |
<code title="">data-</code> and the name passed to the algorithm. |
| 187 |
#ja |
| 188 |
<var title="">name</var> を、文字列 <code title="">data-</code> |
| 189 |
と算法に渡された名前を連結したものとします。 |
| 190 |
|
| 191 |
#en |
| 192 |
If the element does not have an attribute with the name <var |
| 193 |
title="">name</var>, then the name has no corresponding value, abort. |
| 194 |
#ja |
| 195 |
要素が名前 <var |
| 196 |
title="">name</var> の属性を有しない場合は、 |
| 197 |
その名前は対応する値を持たず、停止します。 |
| 198 |
|
| 199 |
#en |
| 200 |
Otherwise, return the value of the attribute with the name <var |
| 201 |
title="">name</var>. |
| 202 |
#ja |
| 203 |
そうでない場合、名前 <var |
| 204 |
title="">name</var> の属性の値を返します。 |
| 205 |
|
| 206 |
#en |
| 207 |
The algorithm for setting names to certain values |
| 208 |
#ja |
| 209 |
名前をある値を設定する算法 |
| 210 |
|
| 211 |
#en |
| 212 |
Let <var title="">value</var> be the value passed to the algorithm. |
| 213 |
#ja |
| 214 |
<var title="">value</var> を、算法に渡された値とします。 |
| 215 |
|
| 216 |
#en |
| 217 |
Set the value of the attribute with the name <var |
| 218 |
title="">name</var>, to the value <var title="">value</var>, replacing |
| 219 |
any previous value if the attribute already existed. If <code |
| 220 |
title="">setAttribute()</code> would have raised an exception when |
| 221 |
setting an attribute with the name <var title="">name</var>, then this |
| 222 |
must raise the same exception. |
| 223 |
#ja |
| 224 |
名前 <var |
| 225 |
title="">name</var> の属性の値を値 <var title="">value</var> |
| 226 |
に設定します。ここで、属性が既に存在する場合、元の値は置き換えられます。 <code |
| 227 |
title="">setAttribute()</code> が名前 <var title="">name</var> |
| 228 |
の属性を設定しようとした時に例外を発生させるような場合には、 |
| 229 |
これも同じ例外を発生させなければ[[MUST:なりません]]。 |
| 230 |
|
| 231 |
#en |
| 232 |
The algorithm for deleting names |
| 233 |
#ja |
| 234 |
名前を削除する算法 |
| 235 |
|
| 236 |
#en |
| 237 |
Remove the attribute with the name <var title="">name</var>, if such |
| 238 |
an attribute exists. Do nothing otherwise. |
| 239 |
#ja |
| 240 |
名前 <var title="">name</var> の属性が存在すれば、これを削除します。 |
| 241 |
存在しない場合は、なにもしません。 |
| 242 |
|
| 243 |
#en |
| 244 |
If a Web page wanted an element to represent a space ship, e.g. as part |
| 245 |
of a game, it would have to use the <code class=attr-class>class</code> |
| 246 |
attribute along with <code title="attr-data-*"><a |
| 247 |
href="#data-">data-*</a></code> attributes: |
| 248 |
#ja |
| 249 |
Web 頁に宇宙船を表す要素が必要な場合 (例えばゲーム中で)、 |
| 250 |
<code class=attr-class>class</code> |
| 251 |
属性と共に <code title="attr-data-*"><a |
| 252 |
href="#data-">data-*</a></code> |
| 253 |
属性を使う必要が生じることでしょう。 |
| 254 |
|
| 255 |
#en |
| 256 |
Authors should carefully design such extensions so that when the |
| 257 |
attributes are ignored and any associated CSS dropped, the page is still |
| 258 |
usable. |
| 259 |
#ja |
| 260 |
著者は、このような拡張を設計する際、この属性が無視され、関連付けられた CSS |
| 261 |
が除去されたとしても、なおその頁が利用可能であるよう、注意する[[SHOULD:べきです]]。 |
| 262 |
|
| 263 |
#en |
| 264 |
User agents must not derive any implementation behavior from these |
| 265 |
attributes or values. Specifications intended for user agents must not |
| 266 |
define these attributes to have any meaningful values. |
| 267 |
#ja |
| 268 |
利用者エージェントは、これらの属性や値によって実装の動作を決めては[[MUST NOT:なりません]]。 |
| 269 |
利用者エージェントを想定した仕様書は、 |
| 270 |
これらの属性が意味のある値を持つように定義しては[[MUST NOT:なりません]]。 |
Parent Directory
| 
Revision Log