| 1 |
apache |
1.6 |
#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 |
|
|
#pattern
|
| 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 |
|
|
#pattern
|
| 55 |
|
|
<span class=secno>* </span>The * element
|
| 56 |
|
|
#ja
|
| 57 |
|
|
<span class=secno>$1 </span>$2 要素
|
| 58 |
|
|
|
| 59 |
|
|
#pattern
|
| 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 |
|
|
#en
|
| 120 |
|
|
The <code title=attr-title><a href="#title">title</a></code> attribute
|
| 121 |
|
|
represents advisory information for the element, such as would be
|
| 122 |
|
|
appropriate for a tooltip. On a link, this could be the title or a
|
| 123 |
|
|
description of the target resource; on an image, it could be the image
|
| 124 |
|
|
credit or a description of the image; on a paragraph, it could be a
|
| 125 |
|
|
footnote or commentary on the text; on a citation, it could be further
|
| 126 |
|
|
information about the source; and so forth. The value is text.
|
| 127 |
|
|
#ja
|
| 128 |
|
|
<code title=attr-title><a href="#title">title</a></code> 属性は、
|
| 129 |
|
|
要素に関する助言情報、例えばツールチップとして適切なものなどを表します。
|
| 130 |
|
|
例えば、リンクにおいては、対象資源の題名や説明とすることができます。
|
| 131 |
|
|
画像では、画像のクレジットや説明とすることができます。
|
| 132 |
|
|
段落では、出典に関する追加情報とすることができます。
|
| 133 |
|
|
値は文章です。
|
| 134 |
|
|
|
| 135 |
|
|
#en
|
| 136 |
|
|
If this attribute is omitted from an element, then it implies that the
|
| 137 |
|
|
<code title=attr-title><a href="#title">title</a></code> attribute of the
|
| 138 |
|
|
nearest ancestor <a href="#html-elements" title="HTML elements">HTML
|
| 139 |
|
|
element</a> with a <code title=attr-title><a
|
| 140 |
|
|
href="#title">title</a></code> attribute set is also relevant to this
|
| 141 |
|
|
element. Setting the attribute overrides this, explicitly stating that the
|
| 142 |
|
|
advisory information of any ancestors is not relevant to this element.
|
| 143 |
|
|
Setting the attribute to the empty string indicates that the element has
|
| 144 |
|
|
no advisory information.
|
| 145 |
|
|
#ja
|
| 146 |
|
|
ある要素でこの属性が省略されている場合、最も近い <code title=attr-title><a
|
| 147 |
|
|
href="#title">title</a></code> 属性が設定された祖先
|
| 148 |
|
|
<a href="#html-elements" title="HTML elements">HTML 要素</a>の
|
| 149 |
|
|
<code title=attr-title><a href="#title">title</a></code> 属性がその要素にも関係することを暗示しています。
|
| 150 |
|
|
属性を設定することでこれが上書きされ、祖先の助言情報がこの要素に関係しないと明示することとなります。
|
| 151 |
|
|
この属性を空文字列に設定すると、その要素が助言情報を持たないことが示されます。
|
| 152 |
|
|
|
| 153 |
|
|
#en
|
| 154 |
|
|
If the <code title=attr-title><a href="#title">title</a></code>
|
| 155 |
|
|
|
| 156 |
|
|
attribute's value contains U+000A LINE FEED (LF) characters, the content
|
| 157 |
|
|
is split into multiple lines. Each U+000A LINE FEED (LF) character
|
| 158 |
|
|
represents a line break.
|
| 159 |
|
|
#ja
|
| 160 |
|
|
<code title=attr-title><a href="#title">title</a></code>
|
| 161 |
|
|
属性の値が U+000A LINE FEED (LF) 文字を含んでいる場合、
|
| 162 |
|
|
内容は複数行に分割されます。 U+000A LINE FEED (LF)
|
| 163 |
|
|
文字それぞれが改行を表します。
|
| 164 |
|
|
|
| 165 |
|
|
#en
|
| 166 |
|
|
Some elements, such as <code><a href="#link">link</a></code> and
|
| 167 |
|
|
<code><a href="#abbr">abbr</a></code>, define additional semantics for the
|
| 168 |
|
|
<code title=attr-title><a href="#title">title</a></code> attribute beyond
|
| 169 |
|
|
the semantics described above.
|
| 170 |
|
|
#ja
|
| 171 |
|
|
<code><a href="#link">link</a></code> 要素や
|
| 172 |
|
|
<code><a href="#abbr">abbr</a></code> 要素など、いくつかの要素は、
|
| 173 |
|
|
<code title=attr-title><a href="#title">title</a></code> 属性について、
|
| 174 |
|
|
前述のような意味以上の追加の意味を定義しています。
|
| 175 |
|
|
|
| 176 |
|
|
#en
|
| 177 |
|
|
The <dfn id=title0 title=dom-title><code>title</code></dfn> DOM
|
| 178 |
|
|
attribute must <a href="#reflect">reflect</a> the <code
|
| 179 |
|
|
title=attr-title><a href="#title">title</a></code> content attribute.
|
| 180 |
|
|
#ja
|
| 181 |
|
|
<dfn id=title0 title=dom-title><code>title</code></dfn> DOM
|
| 182 |
|
|
属性は <code
|
| 183 |
|
|
title=attr-title><a href="#title">title</a></code> 内容属性を<a href="#reflect">反映</a>しなければ[[MUST:なりません]]。
|
| 184 |
|
|
|
| 185 |
|
|
#pattern
|
| 186 |
|
|
<span class=secno>* </span>The <dfn id=lang
|
| 187 |
|
|
title=attr-lang><code>lang</code></dfn> (HTML only) and <dfn id=xmllang
|
| 188 |
|
|
title=attr-xml-lang><code>xml:lang</code></dfn> (XML only) attributes
|
| 189 |
|
|
#ja
|
| 190 |
|
|
<span class=secno>$1 </span><dfn id=lang
|
| 191 |
|
|
title=attr-lang><code>lang</code></dfn> 属性 (HTML のみ) と <dfn id=xmllang
|
| 192 |
|
|
title=attr-xml-lang><code>xml:lang</code></dfn> 属性 (XML のみ)
|
| 193 |
|
|
|
| 194 |
|
|
#en
|
| 195 |
|
|
The <code title=attr-lang><a href="#lang">lang</a></code> attribute
|
| 196 |
|
|
specifies the primary <dfn id=language>language</dfn> for the element's
|
| 197 |
|
|
contents and for any of the element's attributes that contain text. Its
|
| 198 |
|
|
value must be a valid RFC 3066 language code, or the empty string. <a
|
| 199 |
|
|
href="#refsRFC3066">[RFC3066]</a>
|
| 200 |
|
|
#ja
|
| 201 |
|
|
<code title=attr-lang><a href="#lang">lang</a></code> 属性は、
|
| 202 |
|
|
その要素の内容と文章を含むその要素の属性についての主たる<dfn id=language>言語</dfn>を指定します。
|
| 203 |
|
|
値は妥当な RFC 3066 言語符号または空文字列でなければ[[MUST:なりません]]。<a
|
| 204 |
|
|
href="#refsRFC3066">[RFC3066]</a>
|
| 205 |
|
|
|
| 206 |
|
|
#en
|
| 207 |
|
|
The <code title=attr-xml-lang><a href="#xmllang">xml:lang</a></code>
|
| 208 |
|
|
attribute is defined in XML. <a href="#refsXML">[XML]</a>
|
| 209 |
|
|
#ja
|
| 210 |
|
|
<code title=attr-xml-lang><a href="#xmllang">xml:lang</a></code>
|
| 211 |
|
|
属性は XML で定義されています。 <a href="#refsXML">[XML]</a>
|
| 212 |
|
|
|
| 213 |
|
|
#en
|
| 214 |
|
|
If these attributes are omitted from an element, then it implies that
|
| 215 |
|
|
the language of this element is the same as the language of the parent
|
| 216 |
|
|
element. Setting the attribute to the empty string indicates that the
|
| 217 |
|
|
primary language is unknown.
|
| 218 |
|
|
#ja
|
| 219 |
|
|
これらの属性が要素から省略されている場合、その要素の言語は親要素の言語と同じであることを暗示しています。
|
| 220 |
|
|
これらの属性を空文字列に設定することは、
|
| 221 |
|
|
主たる言語が不明であることを示します。
|
| 222 |
|
|
|
| 223 |
|
|
#en
|
| 224 |
|
|
The <code title=attr-lang><a href="#lang">lang</a></code> attribute may
|
| 225 |
|
|
be used on elements of <a href="#html-">HTML documents</a>. Authors must
|
| 226 |
|
|
not use the <code title=attr-lang><a href="#lang">lang</a></code>
|
| 227 |
|
|
attribute in <a href="#xml-documents">XML documents</a>.
|
| 228 |
|
|
#ja
|
| 229 |
|
|
<code title=attr-lang><a href="#lang">lang</a></code>
|
| 230 |
|
|
属性は <a href="#html-">HTML 文書</a>の要素で使用して[[MAY:構いません]]。
|
| 231 |
|
|
著者は <code title=attr-lang><a href="#lang">lang</a></code>
|
| 232 |
|
|
属性を <a href="#xml-documents">XML 文書</a>で使用しては[[MUST NOT:なりません]]。
|
| 233 |
|
|
|
| 234 |
|
|
#en
|
| 235 |
|
|
The <code title=attr-xml-lang><a href="#xmllang">xml:lang</a></code>
|
| 236 |
|
|
attribute may be used on elements of <a href="#xml-documents">XML
|
| 237 |
|
|
documents</a>. Authors must not use the <code title=attr-xml-lang><a
|
| 238 |
|
|
href="#xmllang">xml:lang</a></code> attribute in <a href="#html-">HTML
|
| 239 |
|
|
documents</a>.
|
| 240 |
|
|
#ja
|
| 241 |
|
|
<code title=attr-xml-lang><a href="#xmllang">xml:lang</a></code>
|
| 242 |
|
|
属性は <a href="#xml-documents">XML
|
| 243 |
|
|
文書</a>の要素で使用して[[MAY:構いません]]。著者は <code title=attr-xml-lang><a
|
| 244 |
|
|
href="#xmllang">xml:lang</a></code>
|
| 245 |
|
|
属性を <a href="#html-">HTML 文書</a>で使用しては[[MUST NOT:なりません]]。
|
| 246 |
|
|
|
| 247 |
|
|
#en
|
| 248 |
|
|
To determine the language of a node, user agents must look at the
|
| 249 |
|
|
nearest ancestor element (including the element itself if the node is an
|
| 250 |
|
|
element) that has an <code title=attr-xml-lang><a
|
| 251 |
|
|
href="#xmllang">xml:lang</a></code> attribute set or is an <a
|
| 252 |
|
|
href="#html-elements" title="HTML elements">HTML element</a> and has a
|
| 253 |
|
|
<code title=attr-lang><a href="#lang">lang</a></code> attribute set. That
|
| 254 |
|
|
attribute specifies the language of the node.
|
| 255 |
|
|
#ja
|
| 256 |
|
|
利用者エージェントは、ある節点の言語を決定する場合、
|
| 257 |
|
|
<code title=attr-xml-lang><a
|
| 258 |
|
|
href="#xmllang">xml:lang</a></code> 属性が設定されているか、 <a
|
| 259 |
|
|
href="#html-elements" title="HTML elements">HTML 要素</a>であって
|
| 260 |
|
|
<code title=attr-lang><a href="#lang">lang</a></code> 属性が設定されている直近の祖先要素
|
| 261 |
|
|
(当該節点が要素である場合、その要素自体を含みます。)
|
| 262 |
|
|
を見なければ[[MUST:なりません]]。その属性が、当該節点の言語を指定します。
|
| 263 |
|
|
|
| 264 |
|
|
#en
|
| 265 |
|
|
If both the <code title=attr-xml-lang><a
|
| 266 |
|
|
href="#xmllang">xml:lang</a></code> attribute and the <code
|
| 267 |
|
|
title=attr-lang><a href="#lang">lang</a></code> attribute are set on an
|
| 268 |
|
|
element, user agents must use the <code title=attr-xml-lang><a
|
| 269 |
|
|
href="#xmllang">xml:lang</a></code> attribute, and the <code
|
| 270 |
|
|
title=attr-lang><a href="#lang">lang</a></code> attribute must be <a
|
| 271 |
|
|
href="#ignored" title=ignore>ignored</a> for the purposes of determining
|
| 272 |
|
|
the element's language.
|
| 273 |
|
|
#ja
|
| 274 |
|
|
利用者エージェントは、 <code title=attr-xml-lang><a
|
| 275 |
|
|
href="#xmllang">xml:lang</a></code> 属性と <code
|
| 276 |
|
|
title=attr-lang><a href="#lang">lang</a></code>
|
| 277 |
|
|
属性が共にある要素に設定されている場合、 <code title=attr-xml-lang><a
|
| 278 |
|
|
href="#xmllang">xml:lang</a></code> 属性を使用しなければ[[MUST:ならず]]、
|
| 279 |
|
|
<code
|
| 280 |
|
|
title=attr-lang><a href="#lang">lang</a></code> 属性は要素の言語の決定においては<a
|
| 281 |
|
|
href="#ignored" title=ignore>無視</a>しなければ[[MUST:なりません]]。
|
| 282 |
|
|
|
| 283 |
|
|
#en
|
| 284 |
|
|
If no explicit language is given for the <a href="#root-element">root
|
| 285 |
|
|
element</a>, then language information from a higher-level protocol (such
|
| 286 |
|
|
as HTTP), if any, must be used as the final fallback language. In the
|
| 287 |
|
|
absence of any language information, the default value is unknown (the
|
| 288 |
|
|
empty string).
|
| 289 |
|
|
#ja
|
| 290 |
|
|
<a href="#root-element">根要素</a>に対して言語が明示的に与えられていない場合、
|
| 291 |
|
|
上位プロトコル (HTTP など) の言語情報があれば、これを最終フォールバック言語として使わなければ[[MUST:なりません]]。
|
| 292 |
|
|
どの言語情報も存在しない場合、既定値は不明 (空文字列) です。
|
| 293 |
|
|
|
| 294 |
|
|
#en
|
| 295 |
|
|
User agents may use the element's language to determine proper
|
| 296 |
|
|
processing or rendering (e.g. in the selection of appropriate fonts or
|
| 297 |
|
|
pronunciations, or for dictionary selection). <!--User
|
| 298 |
|
|
agents must not use the element's language to determine text
|
| 299 |
|
|
directionality. (commented out because text directionality is a
|
| 300 |
|
|
rendering-level concern.)-->
|
| 301 |
|
|
#ja
|
| 302 |
|
|
利用者エージェントは、要素の言語情報を適切な処理やレンダリングの決定
|
| 303 |
|
|
(例えば適切なフォントや句読点の選択や辞書の選択)
|
| 304 |
|
|
のために使って[[MAY:構いません]]。
|
| 305 |
|
|
|
| 306 |
|
|
#pattern
|
| 307 |
|
|
<span class=secno>* </span>The <dfn id=xmlbase
|
| 308 |
|
|
title=attr-xml-base><code>xml:base</code></dfn> attribute (XML only)
|
| 309 |
|
|
#ja
|
| 310 |
|
|
<span class=secno>$1 </span><dfn id=xmlbase
|
| 311 |
|
|
title=attr-xml-base><code>xml:base</code></dfn> 属性 (XML のみ)
|
| 312 |
|
|
|
| 313 |
|
|
#en
|
| 314 |
|
|
The <code title=attr-xml-base><a href="#xmlbase">xml:base</a></code>
|
| 315 |
|
|
attribute is defined in XML Base. <a href="#refsXMLBASE">[XMLBASE]</a>
|
| 316 |
|
|
#ja
|
| 317 |
|
|
<code title=attr-xml-base><a href="#xmlbase">xml:base</a></code>
|
| 318 |
|
|
属性は XML 基底で定義されています。 <a href="#refsXMLBASE">[XMLBASE]</a>
|
| 319 |
|
|
|
| 320 |
|
|
#en
|
| 321 |
|
|
The <code title=attr-xml-base><a href="#xmlbase">xml:base</a></code>
|
| 322 |
|
|
attribute may be used on elements of <a href="#xml-documents">XML
|
| 323 |
|
|
documents</a>. Authors must not use the <code title=attr-xml-base><a
|
| 324 |
|
|
href="#xmlbase">xml:base</a></code> attribute in <a href="#html-">HTML
|
| 325 |
|
|
documents</a>.
|
| 326 |
|
|
#ja
|
| 327 |
|
|
<code title=attr-xml-base><a href="#xmlbase">xml:base</a></code>
|
| 328 |
|
|
属性は <a href="#xml-documents">XML 文書</a>の要素で使って[[MAY:構いません]]。
|
| 329 |
|
|
著者は <code title=attr-xml-base><a
|
| 330 |
|
|
href="#xmlbase">xml:base</a></code> 属性を <a href="#html-">HTML
|
| 331 |
|
|
文書</a>で使用しては[[MUST NOT:なりません]]。
|
| 332 |
|
|
|
| 333 |
|
|
|
| 334 |
|
|
#pattern
|
| 335 |
|
|
<span class=secno>* </span><dfn
|
| 336 |
|
|
id=embedding0>Embedding custom non-visible data</dfn>
|
| 337 |
|
|
#ja
|
| 338 |
|
|
<span class=secno>$1 </span><dfn
|
| 339 |
|
|
id=embedding0>カスタム不可視データの埋め込み</dfn>
|
| 340 |
|
|
|
| 341 |
|
|
#en
|
| 342 |
|
|
A <dfn id=custom>custom data attribute</dfn> is an attribute whose name
|
| 343 |
|
|
starts with the string "<dfn id=data-
|
| 344 |
|
|
title="attr-data-*"><code>data-</code></dfn>", has at least one character
|
| 345 |
|
|
after the hyphen, is <a href="#xml-compatible">XML-compatible</a>, and has
|
| 346 |
|
|
no namespace.
|
| 347 |
|
|
#ja
|
| 348 |
|
|
<dfn id=custom>カスタム・データ属性</dfn>は、
|
| 349 |
|
|
名前が文字列 "<dfn id=data-
|
| 350 |
|
|
title="attr-data-*"><code>data-</code></dfn>" で始まり、
|
| 351 |
|
|
ハイフンの後最低1文字あり、 <a href="#xml-compatible">XML 互換</a>で、
|
| 352 |
|
|
名前空間を持たない属性です。
|
| 353 |
|
|
|
| 354 |
|
|
#en
|
| 355 |
|
|
<a href="#custom" title="custom data attribute">Custom data
|
| 356 |
|
|
attributes</a> are intended to store custom data private to the page or
|
| 357 |
|
|
application, for which there are no more appropriate attributes or
|
| 358 |
|
|
elements.
|
| 359 |
|
|
#ja
|
| 360 |
|
|
<a href="#custom" title="custom data attribute">カスタム・データ属性</a>は、
|
| 361 |
|
|
より適切な要素や属性がないような頁や応用の私的なカスタム・データを蓄積することを想定しています。
|
| 362 |
|
|
|
| 363 |
|
|
#en
|
| 364 |
|
|
Every <a href="#html-elements" title="HTML elements">HTML element</a>
|
| 365 |
|
|
may have any number of <a href="#custom" title="custom data
|
| 366 |
|
|
attribute">custom data attributes</a> specified, with any value.
|
| 367 |
|
|
#ja
|
| 368 |
|
|
すべての <a href="#html-elements" title="HTML elements">HTML 要素</a>には、
|
| 369 |
|
|
任意の値の<a href="#custom" title="custom data
|
| 370 |
|
|
attribute">カスタム・データ属性</a>を任意の個数指定して[[MAY:構いません]]。
|
| 371 |
|
|
|
| 372 |
|
|
#en
|
| 373 |
|
|
The <dfn id=dataset title=dom-dataset><code>dataset</code></dfn> DOM
|
| 374 |
|
|
attribute provides convenient accessors for all the <code
|
| 375 |
|
|
title="attr-data-*"><a href="#data-">data-*</a></code> attributes on an
|
| 376 |
|
|
element. On getting, the <code title=dom-dataset><a
|
| 377 |
|
|
href="#dataset">dataset</a></code> DOM attribute must return a <code><a
|
| 378 |
|
|
href="#domstringmap0">DOMStringMap</a></code> object, associated with the
|
| 379 |
|
|
following three algorithms, which expose these attributes on their
|
| 380 |
|
|
element:
|
| 381 |
|
|
#ja
|
| 382 |
|
|
<dfn id=dataset title=dom-dataset><code>dataset</code></dfn> DOM
|
| 383 |
|
|
属性は、要素のすべての <code
|
| 384 |
|
|
title="attr-data-*"><a href="#data-">data-*</a></code> 属性の便宜アクセス子を提供します。
|
| 385 |
|
|
<code title=dom-dataset><a
|
| 386 |
|
|
href="#dataset">dataset</a></code> DOM 属性は、取得時、
|
| 387 |
|
|
次の3つの算法 (要素のすべての <code
|
| 388 |
|
|
title="attr-data-*"><a href="#data-">data-*</a></code> 属性を露出させます。)
|
| 389 |
|
|
と関連付けられた <code><a
|
| 390 |
|
|
href="#domstringmap0">DOMStringMap</a></code>
|
| 391 |
|
|
オブジェクトを返さなければ[[MUST:なりません]]。
|
| 392 |
|
|
|
| 393 |
|
|
#en
|
| 394 |
|
|
The algorithm for getting values from names
|
| 395 |
|
|
#ja
|
| 396 |
|
|
名前から値を取得する算法
|
| 397 |
|
|
|
| 398 |
|
|
#en
|
| 399 |
|
|
Let <var title="">name</var> be the concatenation of the string
|
| 400 |
|
|
<code title="">data-</code> and the name passed to the algorithm.
|
| 401 |
|
|
#ja
|
| 402 |
|
|
<var title="">name</var> を、文字列 <code title="">data-</code>
|
| 403 |
|
|
と算法に渡された名前を連結したものとします。
|
| 404 |
|
|
|
| 405 |
|
|
#en
|
| 406 |
|
|
If the element does not have an attribute with the name <var
|
| 407 |
|
|
title="">name</var>, then the name has no corresponding value, abort.
|
| 408 |
|
|
#ja
|
| 409 |
|
|
要素が名前 <var
|
| 410 |
|
|
title="">name</var> の属性を有しない場合は、
|
| 411 |
|
|
その名前は対応する値を持たず、停止します。
|
| 412 |
|
|
|
| 413 |
|
|
#en
|
| 414 |
|
|
Otherwise, return the value of the attribute with the name <var
|
| 415 |
|
|
title="">name</var>.
|
| 416 |
|
|
#ja
|
| 417 |
|
|
そうでない場合、名前 <var
|
| 418 |
|
|
title="">name</var> の属性の値を返します。
|
| 419 |
|
|
|
| 420 |
|
|
#en
|
| 421 |
|
|
The algorithm for setting names to certain values
|
| 422 |
|
|
#ja
|
| 423 |
|
|
名前をある値に設定する算法
|
| 424 |
|
|
|
| 425 |
|
|
#en
|
| 426 |
|
|
Let <var title="">value</var> be the value passed to the algorithm.
|
| 427 |
|
|
#ja
|
| 428 |
|
|
<var title="">value</var> を、算法に渡された値とします。
|
| 429 |
|
|
|
| 430 |
|
|
#en
|
| 431 |
|
|
Set the value of the attribute with the name <var
|
| 432 |
|
|
title="">name</var>, to the value <var title="">value</var>, replacing
|
| 433 |
|
|
any previous value if the attribute already existed. If <code
|
| 434 |
|
|
title="">setAttribute()</code> would have raised an exception when
|
| 435 |
|
|
setting an attribute with the name <var title="">name</var>, then this
|
| 436 |
|
|
must raise the same exception.
|
| 437 |
|
|
#ja
|
| 438 |
|
|
名前 <var
|
| 439 |
|
|
title="">name</var> の属性の値を値 <var title="">value</var>
|
| 440 |
|
|
に設定します。ここで、属性が既に存在する場合、元の値は置き換えられます。 <code
|
| 441 |
|
|
title="">setAttribute()</code> が名前 <var title="">name</var>
|
| 442 |
|
|
の属性を設定しようとした時に例外を発生させるような場合には、
|
| 443 |
|
|
これも同じ例外を発生させなければ[[MUST:なりません]]。
|
| 444 |
|
|
|
| 445 |
|
|
#en
|
| 446 |
|
|
The algorithm for deleting names
|
| 447 |
|
|
#ja
|
| 448 |
|
|
名前を削除する算法
|
| 449 |
|
|
|
| 450 |
|
|
#en
|
| 451 |
|
|
Remove the attribute with the name <var title="">name</var>, if such
|
| 452 |
|
|
an attribute exists. Do nothing otherwise.
|
| 453 |
|
|
#ja
|
| 454 |
|
|
名前 <var title="">name</var> の属性が存在すれば、これを削除します。
|
| 455 |
|
|
存在しない場合は、なにもしません。
|
| 456 |
|
|
|
| 457 |
|
|
#en
|
| 458 |
|
|
If a Web page wanted an element to represent a space ship, e.g. as part
|
| 459 |
|
|
of a game, it would have to use the <code class=attr-class>class</code>
|
| 460 |
|
|
attribute along with <code title="attr-data-*"><a
|
| 461 |
|
|
href="#data-">data-*</a></code> attributes:
|
| 462 |
|
|
#ja
|
| 463 |
|
|
Web 頁に宇宙船を表す要素が必要な場合 (例えばゲーム中で)、
|
| 464 |
|
|
<code class=attr-class>class</code>
|
| 465 |
|
|
属性と共に <code title="attr-data-*"><a
|
| 466 |
|
|
href="#data-">data-*</a></code>
|
| 467 |
|
|
属性を使う必要が生じることでしょう。
|
| 468 |
|
|
|
| 469 |
|
|
#en
|
| 470 |
|
|
Authors should carefully design such extensions so that when the
|
| 471 |
|
|
attributes are ignored and any associated CSS dropped, the page is still
|
| 472 |
|
|
usable.
|
| 473 |
|
|
#ja
|
| 474 |
|
|
著者は、このような拡張を設計する際、この属性が無視され、関連付けられた CSS
|
| 475 |
|
|
が除去されたとしても、なおその頁が利用可能であるよう、注意する[[SHOULD:べきです]]。
|
| 476 |
|
|
|
| 477 |
|
|
#en
|
| 478 |
|
|
User agents must not derive any implementation behavior from these
|
| 479 |
|
|
attributes or values. Specifications intended for user agents must not
|
| 480 |
|
|
define these attributes to have any meaningful values.
|
| 481 |
|
|
#ja
|
| 482 |
|
|
利用者エージェントは、これらの属性や値によって実装の動作を決めては[[MUST NOT:なりません]]。
|
| 483 |
|
|
利用者エージェントを想定した仕様書は、
|
| 484 |
apache |
1.7 |
これらの属性が意味のある値を持つように定義しては[[MUST NOT:なりません]]。 |
| 485 |
|
|
|
| 486 |
|
|
#pattern |
| 487 |
|
|
<span class=secno>* </span>The elements of HTML |
| 488 |
|
|
#ja |
| 489 |
|
|
<span class=secno>$1 </span>HTML の要素 |