HTML — HTML 文書の意味論, 構造, API

3.1.1. `Document^I ~obj

この仕様は、 `DOM$r にて定義される `Document$I0 ~interfaceを有意に拡張する。 ◎ DOM defines a Document interface, which this specification extends significantly.

【 この訳では、 ここに定義される `Document$I ~interfaceを実装する~objを単に 文書 とも略記する。 この略記は、 この~pageに限らず，この仕様の他の~pageの和訳でも利用される — この節を指す~linkが付与された “`文書$” は、 `Document$I ~objを表すとする （~HTML／~XML構文で書かれた資源としての文書ではなく）。 】

enum `DocumentReadyState@I { "loading", "interactive", "complete" };
enum `DocumentVisibilityState@I { "visible", "hidden" };
typedef (`HTMLScriptElement$I or `SVGScriptElement$I) `HTMLOrSVGScriptElement@I;

[`LegacyOverrideBuiltIns$]
partial interface `Document@I {
  static `Document$I `parseHTMLUnsafe$m((`TrustedHTML$ or DOMString) %html);

  // 
`資源~metadata管理＠#resource-metadata-management$
◎
resource metadata management

  [PutForwards=`href$m, `LegacyUnforgeable$] readonly attribute `Location$I? `location$m;
  attribute USVString `domain$m;
  readonly attribute USVString `referrer$m;
  attribute USVString `cookie$m;
  readonly attribute DOMString `lastModified$m;
  readonly attribute `DocumentReadyState$I `readyState$m;

  // 
`~DOM~tree~accessor＠#dom-tree-accessors$
◎
DOM tree accessors

  `getter$m object (DOMString name);
  [`CEReactions$] attribute DOMString `title$m;
  [`CEReactions$] attribute DOMString `dir$m;
  [`CEReactions$] attribute `HTMLElement$I? `body$m;
  readonly attribute `HTMLHeadElement$I? `head$m;
  [SameObject] readonly attribute `HTMLCollection$I `images$m;
  [SameObject] readonly attribute `HTMLCollection$I `embeds$m;
  [SameObject] readonly attribute `HTMLCollection$I `plugins$m;
  [SameObject] readonly attribute `HTMLCollection$I `links$m;
  [SameObject] readonly attribute `HTMLCollection$I `forms$m;
  [SameObject] readonly attribute `HTMLCollection$I `scripts$m;
  NodeList `getElementsByName$m(DOMString %elementName);
  readonly attribute `HTMLOrSVGScriptElement$I? `currentScript$m;  /* 
文書~tree内の`古典~script$のみ
◎
classic scripts in a document tree only
 */

  /* 
`動的~markup挿入＠~HTMLdynamic#dynamic-markup-insertion$
◎
dynamic markup insertion
 */
  [`CEReactions$] `Document$I `open$m(optional DOMString %unused1, optional DOMString %unused2); /* 
両~引数とも無視される
◎
both arguments are ignored
 */
  `WindowProxy$I? `~openW$m(USVString %url, DOMString %name, DOMString %features);
  [`CEReactions$] undefined `close$m();
  [`CEReactions$] undefined `write$m((`TrustedHTML$ or DOMString)... %text);
  [`CEReactions$] undefined `writeln$m((`TrustedHTML$ or DOMString)... %text);

  /* 
`利用者~対話＠~HTMLinteraction#editing$
 */
  readonly attribute `WindowProxy$I? `defaultView$m;
  boolean `hasFocus$m();
  [`CEReactions$] attribute DOMString `designMode$m;
  [`CEReactions$] boolean `execCommand$m(DOMString %commandId, optional boolean %showUI = false, optional DOMString %value = "");
  boolean `queryCommandEnabled$m(DOMString %commandId);
  boolean `queryCommandIndeterm$m(DOMString %commandId);
  boolean `queryCommandState$m(DOMString %commandId);
  boolean `queryCommandSupported$m(DOMString %commandId);
  DOMString `queryCommandValue$m(DOMString %commandId);
  readonly attribute boolean `hidden$m;
  readonly attribute `DocumentVisibilityState$I `visibilityState$m;

  /* 
`文書$のみに適用される特別な`~event~handler~IDL属性$
◎
special event handler IDL attributes that only apply to Document objects
 */
  [`LegacyLenientThis$] attribute `EventHandler$I `onreadystatechange$m;
  attribute `EventHandler$I `onvisibilitychange$m;

  /* 
`廃用にされた~memberもある＠~HTMLLS/obsolete.html#Document-partial$
◎
also has obsolete members
 */
};
`Document$I includes `GlobalEventHandlers$I;

各`文書$は、 次に挙げるものを有する： ◎ ↓

• `施策~容器@doc ⇒ `施策~容器$ — 初期~時は新たな`施策~容器$とする。 これは、 当の`文書$に適用される施策を包含する。 ◎ Each Document has a policy container＼ (a policy container), initially a new policy container, which contains policies which apply to the Document.
• `許可~施策@doc ⇒ `許可~施策$ — 初期~時は空とする。 ◎ Each Document has a permissions policy,＼ which is a permissions policy, which is initially empty.
• `~module~map@doc ⇒ `~module~map$ — 初期~時は空とする。 ◎ Each Document has a module map,＼ which is a module map, initially empty.
• `~opener施策@doc ⇒ `~opener施策$ — 初期~時は新たな~opener施策とする。 ◎ Each Document has an opener policy,＼ which is an opener policy, initially a new opener policy.
• `初期~about_blankか@doc （ `is initial about:blank^en ） ⇒ 真偽値 — 初期~時は ~F とする。 【この値が ~T をとる`文書$は、 “初期~about_blank な文書” とも称される。】 ◎ Each Document has an is initial about:blank,＼ which is a boolean, initially false.

• `読込ng中における~WebDriver-BiDi用の~navi~ID@doc ⇒ `~navi~ID$ ／ ~NULL — 初期~時は ~NULL とする。 ◎ Each Document has a during-loading navigation ID for WebDriver BiDi,＼ which is a navigation ID or null, initially null.

  注記： その名が指示するとおり、 これは， `WebDriver BiDi^cite 仕様 `BIDI$r と~interfaceするために利用される — そこでは、［ `文書$の~lifecycleを成す早期な各部の間 ］に［ この`文書$を作成した~naviが`進行中な~navi$であったとき利用された元の`~navi~ID$ ］に束ねる仕方で［ ある種の出来事について伝える ］ことが必要になる。 これは、 最終的には，［ `WebDriver BiDi^cite が当の読込ng処理nが完遂したものと見なした後 ］に ~NULL に戻すよう設定される。 ◎ As the name indicates, this is used for interfacing with the WebDriver BiDi specification, which needs to be informed about certain occurrences during the early parts of the Document's lifecycle, in a way that ties them to the original navigation ID used when the navigation that created this Document was the ongoing navigation. This eventually gets set back to null, after WebDriver BiDi considers the loading process to be finished. [BIDI]

• `~about基底~URL@doc ⇒ `~URL$ ／ ~NULL — 初期~時は ~NULL とする。 ◎ Each Document has an about base URL,＼ which is a URL or null, initially null.

  注記： これは、 "`about:^sc" ~schemeを伴う`文書$用に限り拡充される。 ◎ This is only populated for "about:"-schemed Documents.

• `~BF~cacheを阻んでいる詳細@doc ⇒ `復旧されない事由の詳細$たちが成す`集合$ — 初期~時は空とする。 ◎ Each Document has a bfcache blocking details, which is a set of not restored reason details, initially empty.

3.1.2. `DocumentOrShadowRoot^I ~interface

この仕様は、 `DOM$r にて定義される `DocumentOrShadowRoot$I0 ~mixinを拡張する： ◎ DOM defines the DocumentOrShadowRoot mixin, which this specification extends.

partial interface mixin `DocumentOrShadowRoot@I {
  readonly attribute `Element$I? `activeElement$m;
};

3.1.3. 資源~metadataの管理

%document.`referrer$m

利用者がこの文書へ~navigateした~~元の`文書$の`~URL$docを返す。 ~navigateが阻止されていたときや，そのような文書がなければ空~文字列を返す。 ◎ Returns the URL of the Document from which the user navigated to this one, unless it was blocked or there was no such document, in which case it returns the empty string.

~referrerを阻止したければ `noreferrer$v ~link型を利用できる。 ◎ The noreferrer link type can be used to block the referrer.

%document.`cookie$m [ = %value ]

`文書$に適用されている~HTTP~cookieたちを返す。 ~cookieが無い, もしくはこの資源に適用できない場合、 空~文字列が返される。 ◎ Returns the HTTP cookies that apply to the Document. If there are no cookies or cookies can't be applied to this resource, the empty string will be returned.

設定して，要素の~HTTP~cookieたちが成す集合に新たな~cookieを追加できる。 ◎ Can be set, to add a new cookie to the element's set of HTTP cookies.

内容が`不透明な生成元に~sandbox化されて＠~ORIGIN#sandboxed-origin-browsing-context-flag$いる場合 （例： `sandbox$a 属性を有する `iframe$e 内）、 ［ 取得子, 設定子 ］どちらに対しても， `SecurityError$E 例外が投出されることになる。 ◎ If the contents are sandboxed into an opaque origin (e.g., in an iframe with the sandbox attribute), a "SecurityError" DOMException will be thrown on getting and setting.

`cookie@m ~IDL属性は、 文書の`~URL$docで識別される資源の~cookieを表現する。 ◎ The cookie attribute represents the cookies of the resource identified by the document's URL.

`文書$ %文書 が `反cookie文書@ であるとは、 ~OR↓ が満たされることをいう： ◎ A Document object that falls into one of the following conditions is a cookie-averse Document object:

• %文書 が`属する閲覧~文脈$ ~EQ ~NULL ◎ A Document object whose browsing context is null.
• %文書 の`~URL$docの`~scheme$urlは、 `~HTTP_S~scheme$ではない ◎ A Document whose URL's scheme is not an HTTP(S) scheme.

注記： `cookie$m 属性は，~frame間をまたがって~access可能なので、 ~cookieに対する~path制約は，［ ~cookieが当の~siteを成すどの部分に送信されたか ］を管理する一助になるに過ぎない — それは、 どのような~security特能でもない。 ◎ Since the cookie attribute is accessible across frames, the path restrictions on cookies are only a tool to help manage which cookies are sent to which parts of the site, and are not in any way a security feature.

`cookie$m 属性の［ 取得子, 設定子 ］は、 共有される状態に同期的に~accessする。 ~lockするための仕組みは無いので、 並列処理~UAにおいては， 他の閲覧~文脈が~scriptを走らせている間に~cookieを改変し得る。 一例として、 ~siteは，［ ~session用の一意な識別子として ある~cookieを読取って, 値を増分してから， 当の~cookieの新たな値として書き戻す ］よう試行することもできるが、 当の~siteがこれを 2 つの~browser~windowで同時に行った場合、 両~session用に同じ “一意な” 識別子を利用する結果になり，その効果は悲惨なものになり得る。 ◎ The cookie attribute's getter and setter synchronously access shared state. Since there is no locking mechanism, other browsing contexts in a multiprocess user agent can modify cookies while scripts are running. A site could, for instance, try to read a cookie, increment its value, then write it back out, using the new value of the cookie as a unique identifier for the session; if the site does this twice in two different browser windows at the same time, it might end up using the same "unique" identifier for both sessions, with potentially disastrous effects.

%document.`lastModified$m

~serverから報告された文書の最終改変~日時を 利用者の地域標準時に換算した結果を， `MM/DD/YYYY hh:mm:ss^l の形にして返す。 ◎ Returns the date of the last modification to the document, as reported by the server, in the form "MM/DD/YYYY hh:mm:ss", in the user's local time zone.

最終改変~日時が既知でない場合、 代わりに現在の時刻が返される。 ◎ If the last modification date is not known, the current time is returned instead.

3.1.4. 文書~読込ng状態sの報告-法

%document.`readyState$m

`文書$を読込んでいる間は、 `loading^l を返す。 構文解析を終えた後, かつ下位資源を読込んでいる間は、 `interactive^l を返す。 すべて読込まれて以降は、 `complete^l を返す。 ◎ Returns "loading" while the Document is loading, "interactive" once it is finished parsing but still loading subresources, and "complete" once it has loaded.

この値が変化したときは、 `文書$に向けて `readystatechange$et ~eventが発火される。 ◎ The readystatechange event fires on the Document object when this value changes.

`DOMContentLoaded$et ~eventは、［ `interactive^l に遷移した後, かつ `complete^l に遷移する前 ］において，すべての下位資源 — ただし， `script.async$a 属性を有する `script$e 要素によるものは除く — が読込まれた所で発火される。 ◎ The DOMContentLoaded event fires after the transition to "interactive" but before the transition to "complete", at the point where all subresources apart from async script elements have loaded.

各`文書$は、 `現在の準備度@doc を有する — それは、 文字列であり，初期~時は `complete^l とする。 ◎ Each Document has a current document readiness, a string, initially "complete".

注記： `文書を作成して初期化する$ ~algoを介して作成された`文書$に対しては、 これは，即時に — ~scriptが当の文書の `readyState$m を観測できるようになる前に — `loading^l に設定し直されることになる。 この既定は、 他の事例 — `初期~about_blank な文書$や`属する閲覧~文脈$が無い`文書$など — にも適用される。 ◎ For Document objects created via the create and initialize a Document object algorithm, this will be immediately reset to "loading" before any script can observe the value of document.readyState. This default applies to other cases such as initial about:blank Documents or Documents without a browsing context.

`文書$は、 まだ［ `停止-$xされても, `中止-$xされても ］いない［ `~HTML構文解析器$ ／ `~XML構文解析器$ ］が結付けられている間は， `作動中な構文解析器@ があるとされる。 ◎ A Document is said to have an active parser if it is associated with an HTML parser or an XML parser that has not yet been stopped or aborted.

各`文書$は、 次に挙げるものを有する： ◎ ↓

• `~load計時~報@doc ⇒ `文書~load計時~報$ ◎ A Document has a document load timing info load timing info.
• `前-文書の~unload計時~報@doc ⇒ `文書~unload計時~報$ ◎ A Document has a document unload timing info previous document unload timing.
• `非同一-生成元~redirectを介して作成されたか@doc ⇒ 真偽値 — 初期~時は ~F とする ◎ A Document has a boolean was created via cross-origin redirects, initially false.

`文書~load計時~報@ は、 `構造体$であり，次に挙げる`~item$sctからなる： ◎ The document load timing info struct has the following items:

`~navi開始~時刻@ （既定は 0 ） ◎ navigation start time (default 0)

ある実数 ◎ A number

`~DOM対話的~時刻@ （既定は 0 ） ◎ DOM interactive time (default 0)

`~DOMContentLoaded~event開始~時刻@ （既定は 0 ）† ◎ DOM content loaded event start time (default 0)

`~DOMContentLoaded~event終了~時刻@ （既定は 0 ）† ◎ DOM content loaded event end time (default 0)

`~DOM完了-時刻@ （既定は 0 ） ◎ DOM complete time (default 0)

`~load~event開始~時刻@ （既定は 0 ） ◎ load event start time (default 0)

`~load~event終了~時刻@ （既定は 0 ） ◎ load event end time (default 0)

いずれも `DOMHighResTimeStamp$I 値 ◎ DOMHighResTimeStamp values

【† “~DOMContentLoaded…” は，原文では `DOM content loaded…^en （ “~DOM内容は読込まれた” ）だが、 ~~実際に `DOMContentLoaded$et ~eventに関するので，この訳では直にそう記す。 】

`文書~unload計時~報@ は、 `構造体$であり，次に挙げる`~item$sctからなる： ◎ The document unload timing info struct has the following items:

`~unload~event開始~時刻@ （既定は 0 ） ◎ unload event start time (default 0)

`~unload~event終了~時刻@ （既定は 0 ） ◎ unload event end time (default 0)

いずれも `DOMHighResTimeStamp$I 値 ◎ DOMHighResTimeStamp values

3.1.5. 具現化を阻む仕組み

各`文書$は、 `具現化を阻んでいる要素~群@doc （ `render-blocking element set^en ）を有する — それは、 要素たちが成す`集合$であり，初期~時は空とする。 ◎ Each Document has a render-blocking element set, a set of elements, initially the empty set.

`文書$ %文書 は `具現化を阻む要素の追加ngを許容して@ いるとは、 次が満たされることをいう ⇒ ［ %文書 の`内容~型$doc ~EQ "`text/html$c" ］~AND［ %文書 の`~body要素$ ~EQ ~NULL ］ ◎ A Document document allows adding render-blocking elements if document's content type is "text/html" and the body element of document is null.

`文書$ %文書 の `具現化は阻まれて@ いる（ `render-blocked^en ）とは、 ~AND↓ が満たされることをいう： ◎ A Document document is render-blocked if both of the following are true:

• ［ %文書 の`具現化を阻んでいる要素~群$docは空でない ］~OR［ %文書 は`具現化を阻む要素の追加ngを許容して$いる ］ ◎ document's render-blocking element set is non-empty, or document allows adding render-blocking elements.
• `現在の高分解能~時刻$( %文書 に`関連な大域~obj$ ) ~LTE `実装定義$な時間切れ値 ◎ The current high resolution time given document's relevant global object has not exceeded an implementation-defined timeout value.

要素 %要素 は `具現化を阻んで@ いる（ `render-blocking^en ）とは、 次が満たされることをいう ⇒ ［ %要素 の`~node文書$ %文書 の`具現化は阻まれて$いる ］~AND［ %要素 ~IN %文書 の`具現化を阻んでいる要素~群$doc ］ ◎ An element el is render-blocking if el's node document document is render-blocked, and el is in document's render-blocking element set.

［ `具現化を阻んで$いる要素 %要素 が`閲覧~文脈から切断された$とき／ `具現化を阻む能性$がある要素 %要素 の`他を阻む属性$の値が変更され，その能性を失ったとき ］は、 次を遂行するモノトスル ⇒ `具現化を阻まなくする$( %要素 ) ◎ Whenever a render-blocking element el becomes browsing-context disconnected, or el's blocking attribute's value is changed so that el is no longer potentially render-blocking, then unblock rendering on el.

3.1.6. ~DOM~tree~accessor

%document.`head$m

`~head要素$を返す。 ◎ Returns the head element.

%document.`title$m [ = %value ]

文書の~titleを返す — ~titleは［ ~HTML用には`~title要素$／~SVG用には `~SVG-title$ 要素 ］にて与えられる。 ◎ Returns the document's title, as given by the title element for HTML and as given by the SVG title element for SVG.

設定して文書の~titleを更新できる。 更新する適切な要素がない場合、 所与の %value は無視される。 ◎ Can be set, to update the document's title. If there is no appropriate element to update, the new value is ignored.

%document.`body$m [ = %value ]

`~body要素$を返す。 ◎ Returns the body element.

設定して`~body要素$を置換できる。 ◎ Can be set, to replace the body element.

所与の要素が `body$e でも `frameset$eO でもない場合、 `HierarchyRequestError$E 例外が投出される。 ◎ If the new value is not a body or frameset element, this will throw a "HierarchyRequestError" DOMException.

注記： `body$m 取得子は、 設定子に渡された値を返さない場合もある。 ◎ The value returned by the body getter is not always the one passed to the setter.

%document.`images$m

`文書$内の `img$e 要素たちが成す `HTMLCollection$I を返す。 ◎ Returns an HTMLCollection of the img elements in the Document.

%document.`embeds$m

%document.`plugins$m

`文書$内の `embed$e 要素たちが成す `HTMLCollection$I を返す。 ◎ Returns an HTMLCollection of the embed elements in the Document.

%document.`links$m

`文書$内の［ `a$e, `area$e ］要素のうち， `href$a 属性を有するものたちが成す `HTMLCollection$I を返す。 ◎ Returns an HTMLCollection of the a and area elements in the Document that have href attributes.

%document.`forms$m

`文書$内の `form$e 要素たちが成す `HTMLCollection$I を返す。 ◎ Returns an HTMLCollection of the form elements in the Document.

%document.`scripts$m

`文書$内の `script$e 要素たちが成す `HTMLCollection$I を返す。 ◎ Returns an HTMLCollection of the script elements in the Document.

%collection = %document.`getElementsByName(elementName【！name】)$m

`文書$内の要素のうち，次を満たすものたちが成す `NodeList$I を返す ⇒ `name^a 属性を有する, かつその値 ~EQ %name ◎ Returns a NodeList of elements in the Document that have a name attribute with the value name.

%document.`currentScript$m

現在~実行している［ `script$e ／ `~SVG-script$ ］要素を返す — その要素が`古典~script$を表現する限りにおいて。 再入的な `script$e 実行の事例では、 まだ実行し終えてないそれらのうち，最も近過去に実行し始めたものを返す。 ◎ Returns the script element, or the SVG script element, that is currently executing, as long as the element represents a classic script. In the case of reentrant script execution, returns the one that most recently started executing amongst those that have not yet finished executing.

`文書$が現在~実行している［ `script$e ／ `~SVG-script$ ］要素は［ 無い （例：走っている~scriptは~event~handlerであるか, 時間切れになった）, または`~module~script$を実行している ］場合は、 ~NULLを返す。 ◎ Returns null if the Document is not currently executing a script or SVG script element (e.g., because the running script is an event handler, or a timeout), or if the currently executing script or SVG script element represents a module script.

注記： この~APIは、［ `script$e ／ `~SVG-script$ ］要素を大域的に公開するので、［ 実装者, 標準 ］の~communityからの支持を失っている。 そのようなわけで、 `~module~script$や`~shadow~tree$内の~scriptを走らすときのような， より新たな文脈の下では可用ではない。 そのような文脈で走っている~scriptを［ 大域的に公開することなく識別する ］ための新たな解決策を探している所である。 `課題 #1013＠~HTMLissue/1013$ を見よ。 ◎ This API has fallen out of favor in the implementer and standards community, as it globally exposes script or SVG script elements. As such, it is not available in newer contexts, such as when running module scripts or when running scripts in a shadow tree. We are looking into creating a new solution for identifying the running script in such contexts, which does not make it globally available: see issue #1013.

注記： `Document$I ~interfaceの `dir$m 属性は、 `dir$a 内容~属性とともに定義される。 ◎ The dir attribute on the Document interface is defined along with the dir content attribute.

3.2.1. 意味論

~HTMLにおける［ 要素, 属性, 属性~値 ］は、 （この仕様により）ある種の意味（意味論）を有するものと定義される。 例えば ⇒＃ `ol$e 要素は，有順序~listを表現する。 `lang$a 属性は，要素~内容の言語を表現する。 ◎ Elements, attributes, and attribute values in HTML are defined (by this specification) to have certain meanings (semantics). For example, the ol element represents an ordered list, and the lang attribute represents the language of the content.

これらの定義は、 次を許容する： ◎ These definitions allow＼

• ~HTML処理器 — ~web~browserや探索~engineなど — が，文書を［ 呈示する／利用する ］こと ◎ HTML processors, such as web browsers or search engines, to present and use documents＼
• 多様な文脈 — 作者が考慮しなかったかもしれないものも含む — における応用 ◎ and applications in a wide variety of contexts that the author might not have considered.

作者は、［ 要素／属性／属性~値 ］を［ それらに意図された適切な意味論上の目的 ］以外の目的に利用してはナラナイ — そうすると、 ~softwareは~pageを正しく処理できなくなるので。 ◎ Authors must not use elements, attributes, or attribute values for purposes other than their appropriate intended semantic purpose, as doing so prevents software from correctly processing the page.

作者は、 この仕様も含む`適用-可能な仕様$により許可されていない［ 要素, 属性, 属性~値 ］を利用してはナラナイ。 そうすると、 ~HTMLの将来の拡張が有意に難しくなるので。 ◎ Authors must not use elements, attributes, or attribute values that are not permitted by this specification or other applicable specifications, as doing so makes it significantly harder for the language to be extended in the future.

~DOM~nodeのうち［ その`~node文書$が`属する閲覧~文脈$ ~EQ ~NULL ］なるものに対しては、［ `~HTML構文$x ／ `~XML構文$ ］による要件を除く，すべての文書 適合性~要件は免除される。 ◎ DOM nodes whose node document's browsing context is null are exempt from all document conformance requirements other than the HTML syntax requirements and XML syntax requirements.

［ 属性の値, ~text, さらには文書の構造~全体 ］は、 ~UAが それを処理している間に［ ~scriptingを通して／他の仕組みを利用して ］動的に変更され得る。 ある時点における文書の意味論は，その時点の文書の状態により表現されるので、 文書の意味論は時間~越しに変化し得る。 ~UAは、 文書の呈示を，変化が生じる度に更新するモノトスル。 ◎ Through scripting and using other mechanisms, the values of attributes, text, and indeed the entire structure of the document may change dynamically while a user agent is processing it. The semantics of a document at an instant in time are those represented by the state of the document at that instant in time, and the semantics of a document can therefore change over time. User agents must update their presentation of the document as this occurs.

~HTMLには、 進捗~barを記述する `progress$e 要素がある。 その `value^a 属性が~scriptにより動的に更新された場合、 ~UAは，進捗の変化を示すよう具現化を更新することになる。 ◎ HTML has a progress element that describes a progress bar. If its "value" attribute is dynamically updated by a script, the UA would update the rendering to show the progress changing.

3.2.2. ~DOM内の要素

~DOM内の`~HTML要素$を表現している~nodeは、 この仕様の関連な節にて挙げられる~interfaceを実装して~scriptに公開するモノトスル。 これには、 `~XML文書$内の`~HTML要素$も含まれる — それらの文書が別の文脈~内にあるときでも （例： XSLT 形式変換の内側）。 ◎ The nodes representing HTML elements in the DOM must implement, and expose to scripts, the interfaces listed for them in the relevant sections of this specification. This includes HTML elements in XML documents, even when those documents are in another context (e.g. inside an XSLT transform).

~DOM内の要素は、 それが内在的に有する`意味^em — 意味論とも呼ばれる — を `表現-@ する。 ◎ Elements in the DOM represent things; that is, they have intrinsic meaning, also known as semantics.

例えば、 `ol$e 要素は，有順序~listを表現する。 ◎ For example, an ol element represents an ordered list.

要素は、 何らかの仕方で［ 明示的／暗黙的 ］に `参照-@ できる（指せる）。 ~DOM内の要素を明示的に参照する仕方の一つは、 要素に `id$a 属性を与えて，［ その値を `href$a 属性~値の`素片＠~HTMLnav#navigate-fragid$に伴わせた`~hyperlink$ ］を作成することである。 しかしながら、 参照~用には~hyperlinkが必要yなわけではない — 当の要素を指すようなどの方式でも，事足りる。 ◎ Elements can be referenced (referred to) in some way, either explicitly or implicitly. One way that an element in the DOM can be explicitly referenced is by giving an id attribute to the element, and then creating a hyperlink with that id attribute's value as the fragment for the hyperlink's href attribute value. Hyperlinks are not necessary for a reference, however; any manner of referring to the element in question will suffice.

`HTMLElement$I ~interfaceは、 すべての`~HTML要素$~interfaceが継承する基本的~interfaceであり， 追加的な要件がない要素に利用されるモノトスル。 ◎ The basic interface, from which all the HTML elements' interfaces inherit, and which must be used by elements that have no additional requirements, is the HTMLElement interface.

[Exposed=Window]
interface `HTMLElement@I : `Element$I {
  [`HTMLConstructor$] constructor();

  /* 
~metadata属性
◎
metadata attributes
 */
  [`CEReactions$] attribute DOMString `title$mE;
  [`CEReactions$] attribute DOMString `lang$m;
  [`CEReactions$] attribute boolean `translate$m;
  [`CEReactions$] attribute DOMString `dir$mE;

  /* 
`利用者-ヤリトリ＠~HTMLinteraction#editing$
◎
user interaction
 */
  [`CEReactions$] attribute (boolean or unrestricted double or DOMString)? `hidden$mE;
  [`CEReactions$] attribute boolean `inert$m;
  undefined `click$m();
  [`CEReactions$] attribute DOMString `accessKey$m;
  readonly attribute DOMString `accessKeyLabel$m;
  [`CEReactions$] attribute boolean `draggable$m;
  [`CEReactions$] attribute boolean `spellcheck$m;
  [`CEReactions$] attribute DOMString `writingSuggestions$m;
  [`CEReactions$] attribute DOMString `autocapitalize$m;
  [`CEReactions$] attribute boolean `autocorrect$m;

  [`CEReactions$] attribute [`LegacyNullToEmptyString$] DOMString `innerText$m;
  [`CEReactions$] attribute [`LegacyNullToEmptyString$] DOMString `outerText$m;

  `ElementInternals$I `attachInternals$m();

  /* 
~popover~API
◎
The popover API
 */
  undefined `showPopover$m(`ShowPopoverOptions$I %options = {});
  undefined `hidePopover$m();
  boolean `togglePopover$m(optional (`TogglePopoverOptions$I or boolean) %options = {});
  [`CEReactions$] attribute DOMString? `popover$m;
};

dictionary `ShowPopoverOptions@I {
  `HTMLElement$I `source@mb;
};

dictionary `TogglePopoverOptions@I : `ShowPopoverOptions$I {
  boolean `force@mb;
}

`HTMLElement$I includes `GlobalEventHandlers$I;
`HTMLElement$I includes `ElementContentEditable$I;
`HTMLElement$I includes `HTMLOrSVGElement$I;

[Exposed=Window]
interface `HTMLUnknownElement@I : `HTMLElement$I {
  /* 注記：
`HTMLConstructor$xA が無いのは`意図的である＠~HEcustom#customized-built-in-element-restrictions$
◎
Note: intentionally no [HTMLConstructor]
 */
};

`HTMLElement$I ~interfaceは，いくつもの異種の特能に関係する ~methodや属性 を保持するので、 この~interfaceの~memberの記述は，この仕様の何~節かに散らばっている。 ◎ The HTMLElement interface holds methods and attributes related to a number of disparate features, and the members of this interface are therefore described in various different sections of this specification.

( `~HTML名前空間$, %名前 ) 用の`要素~interface$は、 次に従って決定される： ◎ The element interface for an element with name name in the HTML namespace is determined as follows:

1. ~IF［ %名前 ~IN { `applet$eO, `bgsound$eO, `blink$eO, `isindex$eO, `keygen$eO, `multicol$eO, `nextid$eO, `spacer$eO } ］ ⇒ ~RET `HTMLUnknownElement$I ◎ If name is applet, bgsound, blink, isindex, keygen, multicol, nextid, or spacer, then return HTMLUnknownElement.
2. ~IF［ %名前 ~IN { `acronym$eO, `basefont$eO, `big$eO, `center$eO, `nobr$eO, `noembed$eO, `noframes$eO, `plaintext$eO, `rb$eO, `rtc$eO, `strike$eO, `tt$eO } ］ ⇒ ~RET `HTMLElement$I ◎ If name is acronym, basefont, big, center, nobr, noembed, noframes, plaintext, rb, rtc, strike, or tt, then return HTMLElement.
3. ~IF［ %名前 ~IN { `listing$eO, `xmp$eO } ］ ⇒ ~RET `HTMLPreElement$I ◎ If name is listing or xmp, then return HTMLPreElement.
4. ~IF［ 局所~名 %名前 に対応する`要素~型$用の適切な~interfaceが，この仕様に定義されている ］ ⇒ ~RET その~interface ◎ Otherwise, if this specification defines an interface appropriate for the element type corresponding to the local name name, then return that interface.
5. ~IF［ %名前 用の適切な~interfaceが，`適用-可能な仕様$に定義されている ］ ⇒ ~RET それが定義している~interface ◎ If other applicable specifications define an appropriate interface for name, then return the interface they define.
6. ~IF［ %名前 は`妥当な~custom要素~名$である ］ ⇒ ~RET `HTMLElement$I ◎ If name is a valid custom element name, then return HTMLElement.
7. ~RET `HTMLUnknownElement$I ◎ Return HTMLUnknownElement.

注記： `妥当な~custom要素~名$の場合に， `HTMLUnknownElement$I ではなく `HTMLElement$I を利用するのは、 未来にあり得る`昇格$に際し，［ 要素の~prototype~chainを `HTMLElement$I から その~subclassへ真っ直ぐ翻訳する ］だけで済むようにするためにある — `HTMLUnknownElement$I から無関係な~subclassへそらすような翻訳を要することなく。 ◎ The use of HTMLElement instead of HTMLUnknownElement in the case of valid custom element names is done to ensure that any potential future upgrades only cause a linear transition of the element's prototype chain, from HTMLElement to a subclass, instead of a lateral one, from HTMLUnknownElement to an unrelated subclass.

~HTML要素と~SVG要素 `SVG$r から共有される特能は、 `HTMLOrSVGElement$I ~interface~mixinを利用する： ◎ Features shared between HTML and SVG elements use the HTMLOrSVGElement interface mixin: [SVG]

interface mixin `HTMLOrSVGElement@I {
  [SameObject] readonly attribute `DOMStringMap$I `dataset$m;
  attribute DOMString `nonce$m; /* 
`CEReactions^xA が無いのは`意図的である＠~HTMLurl#nonce-does-not-update-dom$
◎
intentionally no [CEReactions]
 */

  [`CEReactions$] attribute boolean `autofocus$m;
  [`CEReactions$] attribute long `tabIndex$m;
  undefined `focus$m(optional `FocusOptions$I %options = {});
  undefined `blur$m();
};

const %el = document.createElementNS("some namespace", "example");
console.assert(%el.constructor === Element);

3.2.3. ~HTML要素の構築子

`~custom要素$ 特能を~supportするため、 すべての~HTML要素には，特別に挙動する構築子がある。 これは、 ~IDL`拡張d属性$ `HTMLConstructor@xA を介して指示される。 それは、 所与の~interface用の`~interface~obj$が，~call時に特定の挙動があることを指示する （挙動の詳細は以下に定義される）。 ◎ To support the custom elements feature, all HTML elements have special constructor behavior. This is indicated via the [HTMLConstructor] IDL extended attribute. It indicates that the interface object for the given interface will have a specific behavior when called, as defined in detail below.

`HTMLConstructor$xA 拡張d属性は、 現れるならば， ~AND↓ が満たされなければナラナイ： ◎ The [HTMLConstructor] extended attribute＼

• 引数をとらない。 ◎ must take no arguments,＼
• 同じ~interface内では、 1 個の`構築子~演算$のみに 1 回だけ現れ，他所には現れない。 【部分的~interface定義も含めて。~interfaceを継承する~interfaceには、現れ得る。】 ◎ and must only appear on constructor operations. It must appear only once on a constructor operation, and the interface must contain only the single, annotated constructor operation, and no others.＼
• 注釈された構築子~演算は、 引数をとらないものと宣言されている。 ◎ The annotated constructor operation must be declared to take no arguments.

`HTMLConstructor$xA により含意される構築子の挙動に加えて、 `旧来の~factory関数$も有する要素もある （それは、 本当に `prototype^c ~propが改変された，~factory関数である）。 ◎ In addition to the constructor behavior implied by [HTMLConstructor], some elements also have named constructors (which are really factory functions with a modified prototype property).

class AutoEmbiggenedImage extends Image {
  constructor(%width, %height) {
    super(%width * 10, %height * 10);
  }
}

%customElements.define("auto-embiggened", AutoEmbiggenedImage, { extends: "img" });

const %image = new AutoEmbiggenedImage(15, 20);
console.assert(%image.width === 150);
console.assert(%image.height === 200);

3.2.4. 要素~定義

この仕様における各 要素~定義は、 次に挙げる情報を含む： ◎ Each element in this specification has a definition that includes the following information:

分類 （ `Categories^en ）

当の要素が属するとされる`分類$たちが成す~list。 これらは、 各~要素~用の`内容~model$を定義するときに利用される。 ◎ A list of categories to which the element belongs. These are used when defining the content models for each element.

当の要素を利用できる文脈 （ `Contexts in which this element can be used^en ）

当の要素を どこで利用できるかについての，`規範的でない^em記述。 この情報は、［ 当の要素を子として許容する各~要素 ］の内容~modelと~~重複するので冗長であり， もっぱら便利~用に供される。 ◎ A non-normative description of where the element can be used. This information is redundant with the content models of elements that allow this one as a child, and is provided only as a convenience.

注記： 簡略化するため、 ここには最も特定な期待のみ挙げられる。 ◎ For simplicity, only the most specific expectations are listed.

例えば，すべての`句ng内容$は`~flow内容$でもある。 したがって，`句ng内容$である要素に対しては、 “`句ng内容$が期待される所” のみ挙げられることになる — この方が，より特定な期待なので。 `~flow内容$を期待する所は、 どこであれ`句ng内容$も期待する — したがって、 当の要素は，その期待も満たすことになる。 ◎ For example, all phrasing content is flow content. Thus, elements that are phrasing content will only be listed as "where phrasing content is expected", since this is the more-specific expectation. Anywhere that expects flow content also expects phrasing content, and thus also meets this expectation.

内容~model （ `Content model^en ）

当の要素の子孫に含めなければナラナイ内容についての，規範的な記述。 ◎ A normative description of what content must be included as children and descendants of the element.

`text/html^c における~tag省略 （ `Tag omission in text/html^en ）

`text/html$c 構文において，［ `開始~tag$／`終了~tag$ ］を省略できるかどうかについての，`規範的でない^em記述。 この情報は、 冗長であり，もっぱら便利~用に供される — 規範的な要件は、 `§ 省略可能な~tag＠~HTMLwriting#optional-tags$ にて与えられる。 ◎ A non-normative description of whether, in the text/html syntax, the start and end tags can be omitted. This information is redundant with the normative requirements given in the optional tags section, and is provided in the element definitions only as a convenience.

【 “省略できる” とは、［ 構文が妥当な~markupにおいて当の~tagを省略しても，元と同じ~DOM~treeが生成される ］ （より正確aには、［ 所与の~DOM~treeを直列化した結果から当の~tagを省略しても，構文上は妥当になる ］かつ［ それを構文解析し直した結果は， 元の~treeと一致する （開始~tagを省略した場合，その内容~属性の有無を除いて一致する） ］） ことを意味すると考えればよいであろう。 例えば，ある条件の下で開始~tagを省略できる要素もあるが（例： `body$e ）、 その場合に省略しても，~DOM~treeには依然としてその要素が生成されることになる。 】【 開始~tagの省略が、 終了~tagの省略も含意するわけではない — これらを省略できる条件は互いに独立であり、 省略できる開始~tagを省略して終了~tagだけ残しても，構文上は妥当になる。 】

内容~属性 （ `Content attributes^en ）

当の要素に指定されてもヨイ属性を挙げる，規範的な~list （他により許容されないものは除く） — 各~属性には、 当の属性についての規範的でない記述も（~dash（ "—" ）を挟んだ後に）伴われる。 ◎ A normative list of attributes that may be specified on the element (except where otherwise disallowed), along with non-normative descriptions of those attributes. (The content to the left of the dash is normative, the content to the right of the dash is not.)

~accessibilityの考慮点 （ `Accessibility considerations^en ）

作者~向け： ~ARIA［ `role$a ／ `aria-*$a ］属性 `ARIA$r を利用するための適合性~要件は、 `ARIAHTML$r にて定義される。 ◎ For authors: Conformance requirements for use of ARIA role and aria-* attributes are defined in ARIA in HTML. [ARIA] [ARIAHTML]

実装者~向け： ~accessibility~API意味論を実装するための~UA要件は、 `HTMLAAM$r にて定義される。 ◎ For implementers: User agent requirements for implementing accessibility API semantics are defined in HTML Accessibility API Mappings. [HTMLAAM]

~DOM~interface （ `DOM interface^en ）

当の要素が実装するモノトスル~DOM~interfaceについての，規範的な定義。 ◎ A normative definition of a DOM interface that such elements must implement.

上述の定義には、［ 当の要素が何を`表現-$するかについての記述 ］, および［［ 作者／実装 ］に適用され得る，追加的な規範的な適合性~判定基準 ］も後続する。 例が含められることもある。 ◎ This is then followed by a description of what the element represents, along with any additional normative conformance criteria that may apply to authors and implementations. Examples are sometimes also included.

3.2.5. 内容~model

この仕様にて定義される各~要素は、 要素に期待される`内容$を記述する，内容~modelを有する。 `~HTML要素$の内容は、 要素の内容~modelに述べられる要件に合致しなければナラナイ。 要素の `内容@ とは、 ~DOMにおける要素の`子~群$である。 ◎ Each element defined in this specification has a content model: a description of the element's expected contents. An HTML element must have contents that match the requirements described in the element's content model. The contents of an element are its children in the DOM.

要素たちの合間には，`~ASCII空白$が常に許容される。 ~UAは、［ ~source~markup内の要素の合間にある~ASCII空白 ］を，~DOM内では `Text$I ~nodeとして表現する。 0 個以上の`~ASCII空白$のみからなる `Text$I ~nodeは、 `要素間~空白@ と見なされる。 ◎ ASCII whitespace is always allowed between elements. User agents represent these characters between elements in the source markup as Text nodes in the DOM. Empty Text nodes and Text nodes consisting of just sequences of those characters are considered inter-element whitespace.

［ `要素間~空白$／~comment~node／処理命令~node ］は、 次に挙げる文脈においては，無視するモノトスル ⇒＃ 要素の内容が要素の内容~modelに合致するかどうか確かめるとき。 文書や要素の意味論を定義する~algoに従うとき。 ◎ Inter-element whitespace, comment nodes, and processing instruction nodes must be ignored when establishing whether an element's contents match the element's content model or not, and must be ignored when following algorithms that define document and element semantics.

作者は、［ 各~要素~用に定義されるとおり，明示的に許容される所／ 他の仕様により，明示的に要求される所 ］を除いて，`~HTML要素$を利用してはナラナイ。 ~XMLが複合された文書~用には、 他の名前空間に属する要素の内側であっても［ 当の要素は、 関連な文脈を供するものと定義される ］ならば，この文脈になり得る。 ◎ Authors must not use HTML elements anywhere except where they are explicitly allowed, as defined for each element, or as explicitly required by other specifications. For XML compound documents, these contexts could be inside elements from other namespaces, if those elements are defined as providing the relevant contexts.

`ATOM$r は、 `content^e 要素を定義する — そこでは、［ その `type^a 属性の値が `xhtml^l をとるときは、 1 個の~HTML `div$e 要素を包含する ］ことが要求される。 したがって、 その文脈においては， `div$e 要素は許容される — この仕様により明示的かつ規範的に言明されてはいないが。 ◎ The Atom Syndication Format defines a content element. When its type attribute has the value xhtml, The Atom Syndication Format requires that it contain a single HTML div element. Thus, a div element is allowed in that context, even though this is not explicitly normatively stated by this specification. [ATOM]

加えて，`~HTML要素$は、 孤立している — すなわち，親~nodeがない — 場合もある。 ◎ In addition, HTML elements may be orphan nodes (i.e. without a parent node).

var %data = {
  name: "バナナ",
  cell: document.createElement('td'),
};

3.2.6. 大域的な属性

次に挙げる属性は、 すべての`~HTML要素$（この仕様には定義されないものも含む）に共通する — どの~HTML要素に指定してもヨイ： ◎ The following attributes are common to and may be specified on all HTML elements (even those not defined in this specification):

• `accesskey$a
• `autocapitalize$a
• `autocorrect$a
• `autofocus$a
• `contenteditable$a
• `dir$a
• `draggable$a
• `enterkeyhint$a
• `hidden$a
• `inert$a
• `inputmode$a
• `is$a
• `itemid$a
• `itemprop$a
• `itemref$a
• `itemscope$a
• `itemtype$a
• `lang$a
• `nonce$a
• `popover$a
• `spellcheck$a
• `style$a
• `tabindex$a
• `title$a
• `translate$a
• `writingsuggestions$a

これらの属性は、［ この仕様により，`~HTML要素$用の属性として定義されるもの ］に限られる。 この仕様が，これらの属性を有する要素を参照rする所では、 他の名前空間に属する要素は，これらの属性を — 有せるものと定義されない限り — 有するとは見なさないモノトスル。 ◎ These attributes are only defined by this specification as attributes for HTML elements. When this specification refers to elements having these attributes, elements from namespaces that are not defined as having these attributes must not be considered as being elements with these attributes.

`DOM$r は、 名前空間を問わず，どの要素~用にも［ `class@a ／ `id@a ／ `slot@a ］属性~用の~UA要件を定義する。 ◎ DOM defines the user agent requirements for the class, id, and slot attributes for any element in any namespace. [DOM]

［ `class$a ／ `id$a ／ `slot$a ］属性は、 どの`~HTML要素$に指定してもヨイ。 ◎ The class, id, and slot attributes may be specified on all HTML elements.

`~HTML要素$上に指定する `class$a 属性の値は、 `~space等で分離された~token集合$でなければナラナイ — それは、 要素が属する様々な~classを表現する。 ◎ When specified on HTML elements, the class attribute must have a value that is a set of space-separated tokens representing the various classes that the element belongs to.

`id$a 属性の値による識別子は、 不透明な文字列であり，特定0の意味が導出されるベキでない。 ◎ Identifiers are opaque strings. Particular meanings should not be derived from the value of the id attribute.

`slot$a 属性には、 `~HTML要素$に特有な適合性~要件はない。 ◎ There are no conformance requirements for the slot attribute specific to HTML elements.

注記： `slot$a 属性は、 要素を ある~slotに`割当する$ために利用される： `slot$a 属性を有する要素は、 次を満たすような `slot$e 要素 %slot により作成される`~slot$に`割当される$ ⇒ ［ %slot の `slot.name$a 属性の値は `slot$a 属性の値に合致する ］~AND［ %slot が見出される`~shadow~tree$の`根$の`~host$が，対応する `slot$a 属性~値を有する【？】 ］ ◎ The slot attribute is used to assign a slot to an element: an element with a slot attribute is assigned to the slot created by the slot element whose name attribute's value matches that slot attribute's value — but only if that slot element finds itself in the shadow tree whose root's host has the corresponding slot attribute value.

支援技術~製品が，~HTMLの［ 要素／属性 ］でアリなものより木目細かな~interfaceを公開することを可能化するため、 一群の`支援技術~製品~用の注釈＠#wai-aria$（~ARIA `role$a, `aria-*$a 属性）を指定できる。 `ARIA$r ◎ To enable assistive technology products to expose a more fine-grained interface than is otherwise possible with HTML elements and attributes, a set of annotations for assistive technology products can be specified (the ARIA role and aria-* attributes). [ARIA]

次に挙げる`~event~handler内容~属性$は、 どの`~HTML要素$上に指定してもヨイ： ◎ The following event handler content attributes may be specified on any HTML element:

• `onauxclick$hd
• `onbeforeinput$hd
• `onbeforematch$hd
• `onbeforetoggle$hd
• `onblur$hd†
• `oncancel$hd
• `oncanplay$hd
• `oncanplaythrough$hd
• `onchange$hd
• `onclick$hd
• `onclose$hd
• `oncontextlost$hd
• `oncontextmenu$hd
• `oncontextrestored$hd
• `oncopy$hd
• `oncuechange$hd
• `oncut$hd
• `ondblclick$hd
• `ondrag$hd
• `ondragend$hd
• `ondragenter$hd
• `ondragleave$hd
• `ondragover$hd
• `ondragstart$hd
• `ondrop$hd
• `ondurationchange$hd
• `onemptied$hd
• `onended$hd
• `onerror$hd†
• `onfocus$hd†
• `onformdata$hd
• `oninput$hd
• `oninvalid$hd
• `onkeydown$hd
• `onkeypress$hd
• `onkeyup$hd
• `onload$hd†
• `onloadeddata$hd
• `onloadedmetadata$hd
• `onloadstart$hd
• `onmousedown$hd
• `onmouseenter$hd
• `onmouseleave$hd
• `onmousemove$hd
• `onmouseout$hd
• `onmouseover$hd
• `onmouseup$hd
• `onpaste$hd
• `onpause$hd
• `onplay$hd
• `onplaying$hd
• `onprogress$hd
• `onratechange$hd
• `onreset$hd
• `onresize$hd†
• `onscroll$hd†
• `onscrollend$hd†
• `onsecuritypolicyviolation$hd
• `onseeked$hd
• `onseeking$hd
• `onselect$hd
• `onslotchange$hd
• `onstalled$hd
• `onsubmit$hd
• `onsuspend$hd
• `ontimeupdate$hd
• `ontoggle$hd
• `onvolumechange$hd
• `onwaiting$hd
• `onwheel$hd

注記： “†” が付与された属性は、 `body$e 要素に指定されたときには，異なる意味になる — その要素は、 `Window$I ~objの同じ名前の`~event~handler$を公開するので。 ◎ The attributes marked with an asterisk have a different meaning when specified on body elements as those elements expose event handlers of the Window object with the same names.

注記： これらの属性は，すべての要素に適用されるとしても、 すべての要素~上で有用になるわけではない。 例えば、 ~UAにより発火される `volumechange$et ~eventを受取れるのは， `~media要素$に限られる。 ◎ While these attributes apply to all elements, they are not useful on all elements. For example, only media elements will ever receive a volumechange event fired by the user agent.

どの `~HTML要素$上にも，`~custom~data属性$（例： `data-foldername^a, `data-msgid^a 等々）を指定して，~pageに特有な［ ~custom~data, 状態, 注釈, 等々 ］を格納できる。 ◎ Custom data attributes (e.g. data-foldername or data-msgid) can be specified on any HTML element, to store custom data, state, annotations, and similar, specific to the page.

`~HTML文書$においては、 `~HTML名前空間$に属する要素に対し， `xmlns^a 属性を — 正確に `http://www.w3.org/1999/xhtml^l に一致する値を伴う場合に限り — 指定してもヨイ。 このことは、 `~XML文書$には適用されない。 ◎ In HTML documents, elements in the HTML namespace may have an xmlns attribute specified, if, and only if, it has the exact value "http://www.w3.org/1999/xhtml". This does not apply to XML documents.

注記： ~HTMLにおいては、 `xmlns^a 属性は，何ら効果はない。 それは，基本的に護符のようなものであり、 単に，~HTMLと~XMLとの間の移行を容易にするために許容されている。 `~HTML構文解析器$により構文解析されたときは、 この属性は，どの名前空間にも属さなくなる — ~XMLにおける名前空間~宣言~属性の様な， `http://www.w3.org/2000/xmlns/^l 名前空間ではなく。 ◎ In HTML, the xmlns attribute has absolutely no effect. It is basically a talisman. It is allowed merely to make migration to and from XML mildly easier. When parsed by an HTML parser, the attribute ends up in no namespace, not the "http://www.w3.org/2000/xmlns/" namespace like namespace declaration attributes in XML do.

注記： ~XMLにおいては、 `xmlns^a 属性は，名前空間~宣言の仕組みの一部を成す — 要素が［ 名前空間が指定されていない `xmlns^a 属性 ］を実際に有することはできない。 ◎ In XML, an xmlns attribute is part of the namespace declaration mechanism, and an element cannot actually have an xmlns attribute in no namespace specified.

`XML$r はまた、 `~XML文書$内のどの要素にも， `~XML名前空間$に属する `~xml_space$a 属性の利用を許容する。 この属性は、 `~HTML要素$には効果はない — ~HTMLにおける既定の挙動は、 空白を保全するので。 ◎ XML also allows the use of the xml:space attribute in the XML namespace on any element in an XML document. This attribute has no effect on HTML elements, as the default behavior in HTML is to preserve whitespace. [XML]

注記： `text/html$c 構文の下で`~HTML要素$の `~xml_space$a 属性を直列化する仕方はない。 ◎ There is no way to serialize the xml:space attribute on HTML elements in the text/html syntax.

<!DOCTYPE HTML>
<html lang="en"> <!-- 文書~要素に対しては `translate=yes^a -->
 <head>
  <title>The Bee Game</title> <!-- 先祖から暗黙的に `translate=yes^a が継承される -->
 </head>
 <body>
  <p>The Bee Game is a text adventure game in English.</p>
  <p>When the game launches, the first thing you should do is type
  <kbd translate=no>eat honey</kbd>. The game will respond with:</p>
  <pre><samp translate=no>Yum yum! That was some good honey!</samp></pre>
 </body>
</html>

[Exposed=Window,
 `LegacyOverrideBuiltIns$]
interface `DOMStringMap@I {
  `getter$mDSM DOMString (DOMString %name);
  [`CEReactions$] `setter$mDSM undefined (DOMString %name, DOMString %value);
  [`CEReactions$] `deleter$mDSM undefined (DOMString %name);
};

function splashDamage(%node, %x, %y, %damage) {

  if (
      %node.classList.contains('tower') && /* 
`class^a 属性を検査する
 */
      %node.dataset.x == %x && /* 
`data-x^a 属性を読取る
 */
      %node.dataset.y == %y /* 
`data-y^a 属性を読取る
 */
  ) { 
    var %hp = parseInt(%node.dataset.hp); /* 
`data-hp^a 属性を読取る
 */
    %hp = %hp - %damage;
    if (%hp < 0) {
      %hp = 0;
      %node.dataset.ai = 'dead'; /* 
`data-ai^a 属性を設定する
 */
      delete %node.dataset.ability; /* 
`data-ability^a 属性を除去する
 */
    }
    %node.dataset.hp = %hp; /* 
`data-hp^a 属性を設定する
 */
  }
}

3.2.7. `innerText^m, `outerText^m ~prop

%element.`innerText$m [ = %value ]

要素の~text内容を “具現化されたままの~~形で” 返す。 ◎ Returns the element's text content "as rendered".

設定して，要素の内容を所与の値に置換できる。 ただし、 改行は `br$e 要素に変換される。 ◎ Can be set, to replace the element's children with the given value, but with line breaks converted to br elements.

%element.`outerText$m [ = %value ]

要素の~text内容を “具現化されたままの~~形で” 返す。 ◎ Returns the element's text content "as rendered".

設定して，要素~自体を所与の値に置換できる。 ただし、 改行は `br$e 要素に変換される。 ◎ Can be set, to replace the element with the given value, but with line breaks converted to br elements.

【可読性のため、この節では次の表記を用いる：】

• `CR^i は、 符号位置 `000D^U `CARRIAGE RETURN^cn を表す。
• `LF^i は、 符号位置 `000A^U `LINE FEED^cn を表す。
• `TAB^i は、 符号位置 `0009^U `CHARACTER TABULATION^cn を表す。

注記： 厳密に言えば、 ほとんどの`置換され$る要素 （例： `textarea$e, `input$e, `video$e — ただし `button$e は除く） の子孫~nodeは、 ~CSSにより具現化されることはなく， この~algoの目的においては`~CSS~box$を持たないことに注意。 ◎ Note that descendant nodes of most replaced elements (e.g., textarea, input, and video — but not button) are not rendered by CSS, strictly speaking, and therefore have no CSS boxes for the purposes of this algorithm.

この~algoを，`範囲~obj$上でも働くように一般~化する。 そうすれば、 `Selection$I の文字列化子の基礎に利用でき， `範囲~obj$上に直に公開し得るようになる。 `Bugzilla bug 10583＠https://www.w3.org/Bugs/Public/show_bug.cgi?id=10583$ を見よ。 ◎ This algorithm is amenable to being generalized to work on ranges. Then we can use it as the basis for Selection's stringifier and maybe expose it directly on ranges. See Bugzilla bug 10583.

3.2.8. 双方向-~algoに関係する要件

3.2.9. ~ARIA, および~platform~accessibility~APIに関係する要件

注記： ここで参照rされる “既定の意味論” は、 `ARIA$r においては［ “~native（ `native^en ）” ／ “暗黙的（ `implicit^en ）” ／ “~host言語（ `host language^en ）” ］意味論と称されることもある。 ◎ The "default semantics" referred to here are sometimes also called "native", "implicit", or "host language" semantics in ARIA. [ARIA]

注記： これらの定義は、 既定の意味論は，時間~越しに変化し得ることも含意する。 これは、 組込みの要素と同じ表出能を~custom要素にも許容する — 例： `a$e 要素の既定の~ARIA~role意味論が，その `href$a 属性が［ 追加される／除去される ］に伴い どう変化するかと比較して。 ◎ One implication of these definitions is that the default semantics can change over time. This allows custom elements the same expressivity as built-in elements; e.g., compare to how the default ARIA role semantics of an a element change as the href attribute is added or removed.

これの動作~例は、 `§ 既定の~access可能な~role, 状態, ~propを伴う~custom要素の作成-法＠~HEcustom#custom-elements-accessibility-example$ を見よ。 ◎ For an example of this in action, see the custom elements section.

`~HTML要素$上の~ARIA［ `role$a ／ `aria-*$a ］属性の利用を検査する適合性~検査器に課される要件は、 `ARIAHTML$r にて定義される。 ◎ Conformance checker requirements for checking use of ARIA role and aria-* attributes on HTML elements are defined in ARIA in HTML. [ARIAHTML]