3.1.1. `Document^I ~obj

この仕様は、 WHATWG DOM 標準にて定義される `Document^I ~interfaceを有意に拡張する。 ◎ The WHATWG DOM standard defines a Document interface, which this specification extends significantly.

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

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

[OverrideBuiltins]
partial interface `Document@I {
  // 
資源~metadata管理
◎
// resource metadata management

  [PutForwards=`href$m, Unforgeable] 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~木~accessor
◎
// 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;  // 
文書~木~内の`~classic~script$のみ
◎
classic scripts in a document tree only


  // 
動的~markup挿入
◎
// dynamic markup insertion

  [`CEReactions$] `Document$I `open$m(optional DOMString %type, optional DOMString %replace = ""); /* 
%type は無視される
◎
type is ignored
 */
  `WindowProxy$I `~openW$m(USVString %url, DOMString %name, DOMString %features);
  [`CEReactions$] void `close$m();
  [`CEReactions$] void `write$m(DOMString... %text);
  [`CEReactions$] void `writeln$m(DOMString... %text);

  // 
利用者~対話

  readonly attribute `WindowProxy$I? `defaultView$m;
  readonly attribute `Element$I? `activeElement$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);


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

各 `文書$は、次のものを持つ： ◎ ↓

`~HTTPS状態@doc

`~HTTPS状態~値$。 初期~時は `none^l とする。 これは、`文書$の~dataを送達するときに利用される~network~channelの，保安~上の特性を表現する。 ◎ The Document has an HTTPS state (an HTTPS state value), initially "none", which represents the security properties of the network channel used to deliver the Document's data.

`~referrer施策@doc

`~referrer施策$。 初期~時は空~文字列とする。 `文書$から起動される`~fetch$に利用される，既定の`~referrer施策$を表現する。 ◎ The Document has a referrer policy (a referrer policy), initially the empty string, which represents the default referrer policy used by fetches initiated by the Document.

`~CSP~list@doc

この文書~用に作動中のすべての`~CSP~obj$を包含している`~CSP~list$。 他から指定されない限り、空とする。 ◎ The Document has a CSP list, which is a CSP list containing all of the Content Security Policy objects active for the document. The list is empty unless otherwise specified.

`特色機能~施策@doc

`特色機能~施策$。 初期~時は空とする。 ◎ The Document has a feature policy, which is a feature policy, which is initially empty.

`~module~map@doc

`~module~map$。 初期~時は空とする。 ◎ The Document has a module map, which is a module map, initially empty.

3.1.2. 資源~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.

`referrer@m

取得子は、文書の`~referrer$docを返さ~MUST ◎ The referrer attribute must return the document's 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化され$ている場合（例： `sandbox$a 属性を有する `iframe$e の中）、取得子, 設定子のいずれに対しても， `SecurityError$E 例外が投出されることになる。 ◎ If the contents are sandboxed into a unique origin (e.g. in an iframe with the sandbox attribute), a "SecurityError" DOMException will be thrown on getting and setting.

`cookie@m

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

次のいずれかの条件を満たすような`文書$ %文書 は、 `反cookie文書@ とされる： ◎ A Document object that falls into one of the following conditions is a cookie-averse Document object:

• %文書 が`属する閲覧文脈$ ~EQ ε ◎ A Document that has no browsing context.
• %文書 の`~URL$docの`~scheme$urlは、`~network~scheme$ではない ◎ A Document whose URL's scheme is not a network scheme.

取得子は、次を走らせ~MUST ~FINGERPRINTING ◎ On getting,＼

1. ~IF［ 此れは`反cookie文書$である ］ ⇒ ~RET 空~文字列 ◎ if the document is a cookie-averse Document object, then the user agent must return the empty string.＼
2. ~IF［ 此れの`生成元$は`不透明な生成元$である ］ ⇒ ~THROW `SecurityError$E ◎ Otherwise, if the Document's origin is an opaque origin, the user agent must throw a "SecurityError" DOMException.＼
3. %~cookie値 ~LET “非~HTTP” ~APIに対する，［ 此れの`~URL$docに対する `cookie-string$P ］ `COOKIES$r ◎ Otherwise, the user agent must return the cookie-string for the document's URL for a "non-HTTP" API,＼
4. ~RET `~BOMはそのままに~UTF-8復号する$( %~cookie値 ) ◎ decoded using UTF-8 decode without BOM. [COOKIES] (This is a fingerprinting vector.)

設定子は、次を走らせ~MUST： ◎ On setting,＼

1. ~IF［ 此れは`反cookie文書$である ］ ⇒ ~RET ◎ if the document is a cookie-averse Document object, then the user agent must do nothing.＼
2. ~IF［ 此れの`生成元$は`不透明な生成元$である ］ ⇒ ~THROW `SecurityError$E ◎ Otherwise, if the Document's origin is an opaque origin, the user agent must throw a "SecurityError" DOMException.＼
3. %~cookie値 ~LET `~UTF-8符号化する$( 所与の値 ) `ENCODING$r ◎ ↓
4. “非~HTTP” ~APIを介して，［ 此れの`~URL$docに対する， %~cookie値 からなる `set-cookie-string^P を受信した ］かのように動作する `COOKIES$r ◎ Otherwise, the user agent must act as it would when receiving a set-cookie-string for the document's URL via a "non-HTTP" API, consisting of the new value encoded as UTF-8. [COOKIES] [ENCODING]

注記： `cookie$m 属性は，~frame間をまたがって~access可能なので、~cookieに対する~path制約は，~cookieが~siteのどの部分に送信されたか管理する一助になるに過ぎない — それは，どのような保安~上の特色機能でもない。 ◎ 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.

`lastModified@m

取得子は、`文書$の~source~fileの最終改変~日時を 利用者の地域標準時に換算した結果を，次の並びによる形式にして返さ~MUST： ◎ The lastModified attribute, on getting, must return the date and time of the Document's source file's last modification, in the user's local time zone, in the following format:

1. 日付の月t成分
2. `002F^U `/^smb
3. 日付の日t成分
4. `002F^U `/^smb
5. 日付の年t成分
6. `0020^U SPACE
7. 時刻の時t成分
8. `003A^U `:^smb
9. 時刻の分t成分
10. `003A^U `:^smb
11. 時刻の秒t成分

◎ • The month component of the date. • A U+002F SOLIDUS character (/). • The day component of the date. • A U+002F SOLIDUS character (/). • The year component of the date. • A U+0020 SPACE character. • The hours component of the time. • A U+003A COLON character (:). • The minutes component of the time. • A U+003A COLON character (:). • The seconds component of the time.

ここで，上の各~成分は、次のようにされ~MUST：

• 当の成分を基数 10 の数で表現する`~ASCII数字$列で与える。
• 年t成分は 4 桁~以上かつ最短にし，他の成分すべては 2 桁にする。
• 前項に必要なら何個かの `0030^U `0^smb を前置する。

◎ All the numeric components above, other than the year, must be given as two ASCII digits representing the number in base ten, zero-padded if necessary. The year must be given as the shortest possible string of four or more ASCII digits representing the number in base ten, zero-padded if necessary.

`文書$の~source~fileの最終改変~日時は、利用-中の~networking~protocolに関連する特色機能から導出され~MUST — 例えば、文書の~HTTP `Last-Modified$h ~headerの値から, あるいは 局所~fileに対しては~file~system内の~metadataから。 最終改変~日時が未知の場合、この属性は，上の形式による現在の日時を返さ~MUST。 ◎ The Document's source file's last modification date and time must be derived from relevant features of the networking protocols used, e.g. from the value of the HTTP `Last-Modified` header of the document, or from metadata in the file system for local files. If the last modification date and time are not known, the attribute must return the current date and time in the above format.

%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 を持つ。 `文書$の作成-時には、［ 文書が［ `~HTML構文解析器$ ／ `~XML構文解析器$ ／ XSLT 処理器 ］のいずれかに結付けられているならば 文字列 `loading^l ／ ~ELSE_ `complete^l ］に設定され~MUST。 頁を読込んでいる間、種々の~algoがこの値に影響する。 値が設定されたときは、~UAは，`文書$に向けて名前 `readystatechange$et の`~eventを発火-$し~MUST。 ◎ Each document has a current document readiness. When a Document object is created, it must have its current document readiness set to the string "loading" if the document is associated with an HTML parser, an XML parser, or an XSLT processor, and to the string "complete" otherwise. Various algorithms during page loading affect this value. When the value is set, the user agent must fire an event named readystatechange at the Document object.

まだ［ `停止-$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.

`readyState@m

取得子は、此れの`現在の準備度$docを返さ~MUST。 ◎ The readyState IDL attribute must, on getting, return the current document readiness.

3.1.3. ~DOM木~accessor

%document . `head$m

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

`head@m

取得子は、此れの`~head要素$を返さ~MUST。 ◎ The head attribute, on getting, must return the head element of the document (a head element or null).

%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.

所与の`文書$ %文書 の `~title要素@ は、 %文書 内に `title$e 要素が［ あれば それらのうち`木~順序$で最初のもの ／ なければ ~NULL ］を返す。 ◎ The title element of a document is the first title element in the document (in tree order), if there is one, or null otherwise.

`title@m

取得子は、次を走らせ~MUST： ◎ The title attribute must, on getting, run the following algorithm:

1. %値 ~LET 空~文字列 ◎ ↓
2. ~IF［ 此れの`文書~要素$ は `~SVG-svg$ 要素である ］ ⇒ %値 ~SET ［ 此れの`文書~要素$の子であるような，最初の `~SVG-title$ 要素 ］の`子~text内容$ ◎ If the document element is an SVG svg element, then let value be the child text content of the first SVG title element that is a child of the document element.
3. ~ELSE［ 此れの`~title要素$ ~NEQ ~NULL ］ ⇒ %値 ~SET その`子~text内容$ ◎ Otherwise, let value be the child text content of the title element, or the empty string if the title element is null.
4. ~RET `~ASCII空白を剥いで縮約する$( %値 ) ◎ Strip and collapse ASCII whitespace in value. ◎ Return value.

設定子は、次を走らせ~MUST： ◎ On setting, the steps corresponding to the first matching condition in the following list must be run:

1. %文書~要素 ~LET 此れの`文書~要素$ ◎ ↓

2. ~IF［ %文書~要素 は `~SVG-svg$ 要素である ］： ◎ If the document element is an SVG svg element

   1. %title ~LET ~NULL
   2. ~IF［ %文書~要素 の子に `~SVG-title$ 要素はある ］ ⇒ %title ~SET それらのうち最初のもの ◎ If there is an SVG title element that is a child of the document element, let element be the first such element.

   3. ~ELSE： ◎ Otherwise:

      1. %title ~SET `要素を作成する$( 此れ, `title^l, `~SVG名前空間$ ) ◎ Let element be the result of creating an element given the document element's node document, title, and the SVG namespace.
      2. %文書~要素 の`最初の子$として， %title を挿入する ◎ Insert element as the first child of the document element.
   4. %title の `textContent$m ~IDL属性を 所与の値に設定するかのように動作する ◎ Act as if the textContent IDL attribute of element was set to the new value being assigned.

3. ~ELIF［ %文書~要素 は`~HTML名前空間$に属する ］： ◎ If the document element is in the HTML namespace

   1. %title ~LET 此れの`~title要素$ ◎ ↓
   2. %head ~LET 此れの`~head要素$ ◎ ↓
   3. ~IF［ %title ~EQ ~NULL ］~AND［ %head ~EQ ~NULL ］ ⇒ ~RET ◎ If the title element is null and the head element is null, then return.

   4. ~IF［ %title ~EQ ~NULL ］： ◎ If the title element is non-null, let element be the title element. ◎ Otherwise:

      1. %title ~SET `要素を作成する$( 此れ, `title^l, `~HTML名前空間$ ) ◎ Let element be the result of creating an element given the document element's node document, title, and the HTML namespace.
      2. %head に`~nodeを付加する$( %title ) ◎ Append element to the head element.
   5. %title の `textContent$m ~IDL属性を 所与の値に設定するかのように動作する ◎ Act as if the textContent IDL attribute of element was set to the new value being assigned.
4. ~ELSE ⇒ 何もしない ◎ Otherwise ◎ Do nothing.

%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

取得子は、此れの`~body要素$を返さ~MUST。 ◎ The body attribute, on getting, must return the body element of the document (either a body element, a frameset element, or null).＼

設定子は、次を走らせ~MUST： ◎ On setting, the following algorithm must be run:

1. %要素 ~LET 与えられた値
2. ~IF［ %要素 は［ `body$e, `frameset$eO ］いずれの要素でもない ］ ⇒ ~THROW `HierarchyRequestError$E ◎ If the new value is not a body or frameset element, then throw a "HierarchyRequestError" DOMException.
3. %body ~LET 此れの`~body要素$
4. ~IF［ %要素 ~EQ %body ］ ⇒ ~RET ◎ Otherwise, if the new value is the same as the body element, return.
5. %文書~要素 ~LET 此れの`文書~要素$ ◎ ↓
6. ~IF［ %body ~NEQ ~NULL ］ ⇒ %body の親の中で`子を~nodeに置換する$( %body, %要素 ) ◎ Otherwise, if the body element is not null, then replace the body element with the new value within the body element's parent and return.
7. ~ELIF［ %文書~要素 ~EQ ~NULL ］ ⇒ ~THROW `HierarchyRequestError$E ◎ Otherwise, if there is no document element, throw a "HierarchyRequestError" DOMException.
8. ~ELSE ⇒ %文書~要素 に`~nodeを付加する$( %要素 ) ◎ Otherwise, the body element is null, but there's a document element. Append the new value to the document element.

注記： `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 を返す。 ◎ Return 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 を返す。 ◎ Return an HTMLCollection of the form elements in the Document.

%document . `scripts$m

`文書$内の `script$e 要素たち からなる `HTMLCollection$I を返す。 ◎ Return an HTMLCollection of the script elements in the Document.

`images@m

`embeds@m

`plugins@m

`links@m

`forms@m

`scripts@m

これらの属性の取得子は、次のようにされた `HTMLCollection$I を返さ~MUST：

• 根： 此れ
• ~filter： 属性に応じて、次の表の右列に該当する要素のみに合致する

~IDL属性	合致する要素
`images$m	`img$e 要素
`embeds$m	`embed$e 要素
`plugins$m	`embed$e 要素
`links$m	［ `a$e, `area$e ］要素のうち，`href$a 属性を有するもの
`forms$m	`form$e 要素
`scripts$m	`script$e 要素

◎ The images attribute must return an HTMLCollection rooted at the Document node, whose filter matches only img elements. ◎ The embeds attribute must return an HTMLCollection rooted at the Document node, whose filter matches only embed elements. ◎ The plugins attribute must return the same object as that returned by the embeds attribute. ◎ The links attribute must return an HTMLCollection rooted at the Document node, whose filter matches only a elements with href attributes and area elements with href attributes. ◎ The forms attribute must return an HTMLCollection rooted at the Document node, whose filter matches only form elements. ◎ The scripts attribute must return an HTMLCollection rooted at the Document node, whose filter matches only script elements.

%collection = %document . `getElementsByName$m(%name)

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

`getElementsByName(name)@m

被呼出時には、此れ内にある `~HTML要素$のうち，［ `name^a 属性を有していて，その値 ~EQ %name ］なる~nodeすべてを包含している，`木~順序$による`~live$ `NodeList$I を返さ~MUST。 ◎ The getElementsByName(name) method takes a string name, and must return a live NodeList containing all the HTML elements in that document that have a name attribute whose value is equal to the name argument (in a case-sensitive manner), in tree order.＼

~UAは、同じ引数による複数回の呼出しに対しては，同じ~objを返してよい。 そうでなければ，新たな~objを返さ~MUST。 ◎ When the method is invoked on a Document object again with the same argument, the user agent may return the same as the object returned by the earlier call. In other cases, a new NodeList object must be returned.

%document . `currentScript$m

現在~実行している［ `script$e ／ `~SVG-script$ ］要素を返す — その要素が`~classic~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.

`currentScript@m

取得子は、最も近過去に設定された値を返さ~MUST。 ◎ The currentScript attribute, on getting, must return the value to which it was most recently set.＼

この属性は、此れの作成-時には，~NULLに初期化され~MUST。 ◎ When the Document is created, the currentScript must be initialized to null.

この~APIは、 `script$e ／ `~SVG-script$ 要素を大域的に公開するので、［ 実装者, 標準 ］の~communityからの支持を失っている。 そのようなわけで、`~module~script$や`~shadow木$内の~scriptを走らすときのような，より新たな文脈の下では可用ではない。 そのような文脈で走っている~scriptを，大域的に公開させることなく識別するための 新たな解決策を探している所である。 issue #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.

~UAは、`文書$ %文書 の，所与の %名前 に対応する`有名~propの値を決定する$ときは、次の手続きを走らせ~MUST： ◎ To determine the value of a named property name for a Document, the user agent must return the value obtained using the following steps:

1. ~Assert： %名前 は %文書 が`~supportする~prop名$である 【この段は、この訳による補完。】

2. %要素~list ~LET %文書 の`有名~要素$のうち，［ `要素~名$ ~EQ %名前 ］なるものからなる~list ◎ Let elements be the list of named elements with the name name that are in a document tree with the Document as their root.

   定義により、~listは空でない。 ◎ There will be at least one such element, by definition.

3. ~IF［ %要素~list は唯一の要素 %要素 からなる ］

   1. ~IF［ %要素 は `iframe$e 要素である ］~AND［ %要素 が`入子にしている閲覧文脈$ %B ~NEQ ~NULL ］ ⇒ ~RET %B の `WindowProxy$I ~obj
   2. ~RET %要素
   ◎ If elements has only one element, and that element is an iframe element, and that iframe element's nested browsing context is not null, then return the WindowProxy object of the element's nested browsing context. ◎ Otherwise, if elements has only one element, return that element.
4. ~RET 次のようにされた `HTMLCollection$I ⇒＃ 根： `文書$； ~filter： ［`要素~名$ ~EQ %名前 ］なる`有名~要素$のみに合致する ◎ Otherwise return an HTMLCollection rooted at the Document node, whose filter matches only named elements with the name name.

注記： `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.

これらの定義は、［ ~Web~browserや検索~engineなどの，~HTML処理器 ］が［ 文書を呈示したり, 利用すること ］, および［ 作者が考慮していないものも含む，多様な文脈における応用 ］を許容する。 ◎ These definitions allow 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.

作者は、［ 要素／属性／属性~値 ］を，それらに意図された意味論上の目的に適切な目的~以外に利用しては~MUST_NOT — そうすると，~softwareは頁を正しく処理できなくなるので。 ◎ 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.

作者は、この仕様も含む`適用-可能な仕様$により許可されていない［ 要素, 属性, 属性~値 ］を利用しては~MUST_NOT。 そうすると、~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文書$が属する`閲覧文脈$がない†ものに対しては、［ `~HTML構文$x ／ `~XML構文$ ］による要件を除く，すべての文書 適合性~要件は免除される。 【† `属する閲覧文脈$ ~EQ ε 】 ◎ DOM nodes whose node document does not have a browsing context are exempt from all document conformance requirements other than the HTML syntax requirements and XML syntax requirements.

［ 属性の値, ~text, 更には文書の構造~全体 ］は、~UAがそれを処理している間に，~scriptingを通して／他の仕組みを利用して 動的に変更され得る。 ある時点における文書の意味論は，その時点の文書の状態により表現され、したがって文書の意味論は 時経過に伴って変化し得る。 ~UAは、文書の呈示を，変化が生じる度に更新し~MUST。 ◎ 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に公開し~MUST。 これには、`~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内の要素は、それが内在的に有する意味 — 意味論とも呼ばれる — を `表現-@ する。 ◎ 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 属性~値の素片にその値を伴う ］ような`~hyperlink$を作成する仕方がある。 しかしながら、~hyperlinkが必要とされているわけではない — 当の要素を指すようなどの方式でも，事足りる。 ◎ 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であり，追加の要件がない要素に利用され~MUST。 ◎ 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,
 `HTMLConstructor$]
interface `HTMLElement@I : `Element$I {
  // 
~metadata属性
◎
// metadata attributes

  [`CEReactions$] attribute DOMString `title$mE;
  [`CEReactions$] attribute DOMString `lang$m;
  [`CEReactions$] attribute boolean `translate$m;
  [`CEReactions$] attribute DOMString `dir$mE;

  // 
利用者~対話
◎
// user interaction

  [`CEReactions$] attribute boolean `hidden$m;
  void `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 `autocapitalize$m;

  [`CEReactions$] attribute [TreatNullAs=EmptyString] DOMString `innerText$m;
};

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

/* 注記：
`HTMLConstructor$xA を付与しないのは意図的である
◎
Note: intentionally not [HTMLConstructor]
 */
[Exposed=Window]
interface `HTMLUnknownElement@I : `HTMLElement$I { };

`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$] attribute long `tabIndex$m;
  void `focus$m(optional `FocusOptions$I %options);
  void `blur$m();
};

3.2.3 ~HTML要素の構築子

`~custom要素$ 特色機能を~supportするため、すべての~HTML要素には，特別に挙動する構築子がある。 これは、~IDL`拡張属性$ `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 拡張属性で注釈された~interfaceに対応する`~interface~obj$は、それに対応する~JS関数~objの `Call^sl, `Construct^sl いずれに対しても，その呼出に対する関数~本体の挙動として，次の手続きを走らせ~MUST。 この~algoは： `Call^sl で呼出されたときは、［ `NewTarget^jv 値 ~EQ `undefined^jv ］の場合，即時に例外を投出する。 `Construct^sl で呼出されたときは、 `Construct^sl %newTarget ~parameterが `NewTarget^jv 値を供する。 ◎ Interface objects for interfaces annotated with the [HTMLConstructor] extended attribute must run the following steps as the function body behavior for both [[Call]] and [[Construct]] invocations of the corresponding JavaScript function object. When invoked with [[Call]], the NewTarget value is undefined, and so the algorithm below will immediately throw. When invoked with [[Construct]], the [[Construct]] newTarget parameter provides the NewTarget value.

【 `NewTarget^jv は ~JS仕様にて定義される。 大雑把に言えば、~objの構築-時における `this^jv にあたるもの。 】

1. %registry ~LET `現在の大域~obj$の `CustomElementRegistry$I ~obj ◎ Let registry be the current global object's CustomElementRegistry object.

2. ~IF［ `NewTarget^jv ~EQ `作動中の関数~obj$ ］ ⇒ ~THROW `TypeError$E ◎ If NewTarget is equal to the active function object, then throw a TypeError.

   これは、~custom要素が`要素~interface$を構築子に利用して定義されたときに生じ得る： ◎ This can occur when a custom element is defined using an element interface as its constructor:

   %customElements.define("bad-1", HTMLButtonElement);
   new HTMLButtonElement();          // (1)
   document.createElement("bad-1");  // (2)
   

   この事例では、 `HTMLButtonElement$I の構築子を（ (1) のように明示的に, または (2) のように暗黙的に）実行する間、`作動中の関数~obj$, `NewTarget^jv のいずれも `HTMLButtonElement$I になる。 この検査がなければ、局所~名が `bad-1^l である `HTMLButtonElement$I の~instanceを作成することも可能0になる。 ◎ In this case, during the execution of HTMLButtonElement (either explicitly, as in (1), or implicitly, as in (2)), both the active function object and NewTarget are HTMLButtonElement. If this check was not present, it would be possible to create an instance of HTMLButtonElement whose local name was bad-1.

3. %定義 ~LET %registry 内に［ `構築子$cD ~EQ `NewTarget^jv ］なる~entryが［ あれば それ ／ なければ ε ］ ◎ Let definition be the entry in registry with constructor equal to NewTarget.＼

4. ~IF［ %定義 ~EQ ε ］ ⇒ ~THROW `TypeError$E ◎ If there is no such definition, then throw a TypeError.

   %registry 内には［ `構築子$cD ~EQ `undefined^jv ］なる~entryはあり得ないので、この段は，~HTML要素~構築子が関数として~callされないようにもする（その事例では `NewTarget^jv ~EQ `undefined^jv になるので）。 ◎ Since there can be no entry in registry with a constructor of undefined, this step also prevents HTML element constructors from being called as functions (since in that case NewTarget will be undefined).

5. %~is0値 ~LET ~NULL ◎ Let is value be null.

6. ~IF［ %定義 の`局所~名$cD ~EQ %定義 の`名前$cD （すなわち %定義 は`自律的~custom要素$に対するものである） ］： ◎ If definition's local name is equal to definition's name (i.e., definition is for an autonomous custom element), then:

   1. ~IF［ `作動中の関数~obj$は `HTMLElement$I でない ］ ⇒ ~THROW `TypeError$E ◎ If the active function object is not HTMLElement, then throw a TypeError.

      これが生じ得るのは、~custom要素は局所~名を拡張しないよう定義されているが，非 `HTMLElement$I ~classを継承している場合である： ◎ This can occur when a custom element is defined to not extend any local names, but inherits from a non-HTMLElement class:

      %customElements.define("bad-2", class Bad2 extends HTMLParagraphElement {});
      

      この事例では、 `Bad2^c の~instanceを構築するときに生じる（暗黙的な） `super()^c ~callの間、`作動中の関数~obj$は `HTMLParagraphElement$I であり， `HTMLElement$I でない。 ◎ In this case, during the (implicit) super() call that occurs when constructing an instance of Bad2, the active function object is HTMLParagraphElement, not HTMLElement.

7. ~ELSE（すなわち， %定義 は`~custom化された組込みの要素$に対するものである） ： ◎ Otherwise (i.e., if definition is for a customized built-in element):

   1. `妥当な局所~名たち^V ~LET この仕様も含む`適用-可能な仕様$にて定義される各種~要素のうち［ `要素~interface$として`作動中の関数~obj$を利用するもの ］の，局所~名からなる集合 ◎ Let valid local names be the list of local names for elements defined in this specification or in other applicable specifications that use the active function object as their element interface.

   2. ~IF［ %定義 の`局所~名$cD ~NIN `妥当な局所~名たち^V ］ ⇒ ~THROW `TypeError$E ◎ If valid local names does not contain definition's local name, then throw a TypeError.

      これが生じ得るのは、~custom要素は所与の局所~名を拡張するよう定義されているが， 間違った~classを継承しているときである： ◎ This can occur when a custom element is defined to extend a given local name but inherits from the wrong class:

      %customElements.define("bad-3", class Bad3 extends HTMLQuoteElement {}, { extends: "p" });
      

      この事例では、 `Bad3^c の~instanceを構築するときに生じる（暗黙的な） `super()^c ~callの間， `妥当な局所~名たち^V は［ `q$e, `blockquote$e ］を包含しているが、 %定義 の`局所~名$cD は `p$e であり，それに含まれてない。 ◎ In this case, during the (implicit) super() call that occurs when constructing an instance of Bad3, valid local names is the list containing q and blockquote, but definition's local name is p, which is not in that list.

   3. %~is0値 ~SET %定義 の`名前$cD ◎ Set is value to definition's name.
8. %~prototype ~LET `Get$jA( `NewTarget^jv, `prototype^l) （例外投出あり） ◎ Let prototype be Get(NewTarget, "prototype"). Rethrow any exceptions.

9. ~IF［ `Type$jA( %~prototype ) ~NEQ `Object^jc ］： ◎ If Type(prototype) is not Object, then:

   1. %~realm ~LET `GetFunctionRealm$jA( `NewTarget^jv ) ◎ Let realm be GetFunctionRealm(NewTarget).
   2. %~prototype ~SET %~realm の`~interface~prototype~obj$のうち，その~interfaceは `作動中の関数~obj$の~interfaceと同じであるもの ◎ Set prototype to the interface prototype object of realm whose interface is the same as the interface of the active function object.

   注記： `作動中の関数~obj$の~realmは %~realm でないこともあるので、 より一般的な概念 ~realm間にわたる “同じ~interface” を用いている — `~interface~obj$の同等性を~~求めてはいない。 この~fallbackによる挙動は — `NewTarget^jv の~realmの利用と, そこにある適切な~prototypeを探し出すことも含め — ~JSに組込みのものと相似的な挙動に合致するように設計されている。 ◎ The realm of the active function object might not be realm, so we are using the more general concept of "the same interface" across realms; we are not looking for equality of interface objects. This fallback behavior, including using the realm of NewTarget and looking up the appropriate prototype there, is designed to match analogous behavior for the JavaScript built-ins.

10. ~IF［ %定義 の`構築~stack$cDは空である ］： ◎ If definition's construction stack is empty, then:

    1. %要素 ~LET 次のようにされた新たな要素：

       • `作動中の関数~obj$に対応する~interfaceを実装する
       • 属性は有さない
       • 名前空間 ~SET `~HTML名前空間$
       • 局所~名 ~SET %定義 の`局所~名$cD
       • `~node文書$ ~SET `現在の大域~obj$に`結付けられている文書$
       ◎ Let element be a new element that implements the interface to which the active function object corresponds, with no attributes, namespace set to the HTML namespace, local name set to definition's local name, and node document set to the current global object's associated Document.
    2. %要素 . `SetPrototypeOf^sl( %prototype ) を遂行する （例外投出あり） ◎ Perform element.[[SetPrototypeOf]](prototype). Rethrow any exceptions.
    3. %要素 の`~custom要素~状態$ ~SET `custom^l ◎ Set element's custom element state to "custom".
    4. %要素 の`~custom要素~定義$ ~SET %定義 ◎ Set element's custom element definition to definition.
    5. %要素 の`~is0値$ ~SET %~is0値 ◎ Set element's is value to is value.
    6. ~RET %要素 ◎ Return element.

    注記： この段は、作者~scriptが，新たな~custom要素を — 例えば `new MyCustomElement()^c を介して — 直に構築したときに生じる。 ◎ This occurs when author script constructs a new custom element directly, e.g. via new MyCustomElement().

11. %要素 ~LET %定義 の`構築~stack$cD内の最後の~entry ◎ Let element be the last entry in definition's construction stack.

12. ~IF［ %要素 ~EQ `すでに構築-済みを表す~marker$i ］ ⇒ ~THROW `InvalidStateError$E ◎ If element is an already constructed marker, then throw an "InvalidStateError" DOMException.

    これは、`~custom要素~構築子$の内側で、作者~codeが `不適合に$［ `super()^c を~callする前に，構築中の~classの別の~instanceを作成した ］ときに生じ得る： ◎ This can occur when the author code inside the custom element constructor non-conformantly creates another instance of the class being constructed, before calling super():

    let %doSillyThing = false;
    
    class DontDoThis extends HTMLElement {
      constructor() {
        if (%doSillyThing) {
          %doSillyThing = false;
          new DontDoThis();
          /* 
    `構築~stack$cDは今や， `すでに構築-済みを表す~marker$i を包含することになる。
    ◎
    Now the construction stack will contain an already constructed marker.
     */
        }
    
        /* 
    次は `InvalidStateError^E 例外で失敗することになる
    ◎
    This will then fail with an "InvalidStateError" DOMException:
     */
        super();
      }
    }

    また、`~custom要素~構築子$の内側で，作者~codeが `不適合に$［ `super()^c を重ねて~callした ］ときにも生じ得る。 ~JS仕様によれば、これは，~superclassの構築子（すなわち，この~algo）を — ~errorを投出する前に — 実際に，重ねて実行するので： ◎ This can also occur when author code inside the custom element constructor non-conformantly calls super() twice, since per the JavaScript specification, this actually executes the superclass constructor (i.e. this algorithm) twice, before throwing an error:

    class DontDoThisEither extends HTMLElement {
      constructor() {
        super();
    
        /* 
    次の~callは 例外を投出するが、それは
    `HTMLElement^m 構築子の中へ~callした後になる。
    ◎
    This will throw, but not until it has already called into the HTMLElement constructor
     */
        super();
      }
    }
    

13. %要素 . `SetPrototypeOf^sl( %prototype ) を遂行する （例外投出あり） ◎ Perform element.[[SetPrototypeOf]](prototype). Rethrow any exceptions.
14. %定義 の`構築~stack$cD内の最後の~entryを， `すでに構築-済みを表す~marker$i で置換する ◎ Replace the last entry in definition's construction stack with an already constructed marker.

15. ~RET %要素 ◎ Return element.

    注記： この段に到達するのは、通常は，~custom要素を`昇格$するときである。 `~custom要素~構築子$の内側からの `super()^c ~callにて， this に既存の要素をあてがうようにするため、その既存の要素を返す。 ◎ This step is normally reached when upgrading a custom element; the existing element is returned, so that the super() call inside the custom element constructor assigns that existing element to this.

`HTMLConstructor$xA により含意される構築子の挙動に加えて、`有名~構築子$も有する要素もある（その実は、 `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 ）

要素が属するとされる`分類$の~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 ）

要素をどこで利用できるかについての，規範的でない記述。 この情報は、冗長であり，もっぱら便宜のため供される — 自身／他の要素に対する内容~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.

注記： 簡略化するため、ここには期待される分類のうち，最も特定的なもののみが挙げられる。 例えば，`~flow内容$であって, `句内容$でもある要素は、［ `~flow内容$ ／ `句内容$ ］が期待されるどこでも利用できるが、すべての`句内容$は`~flow内容$なので， “`句内容$が期待される所” のみが記されることになる。 ◎ For simplicity, only the most specific expectations are listed. For example, an element that is both flow content and phrasing content can be used anywhere that either flow content or phrasing content is expected, but since anywhere that flow content is expected, phrasing content is also expected (since all phrasing content is flow content), only "where phrasing content is expected" will be listed.

内容~model（ Content model ）

要素の子孫として含められ~MUST内容についての，規範的な記述。 ◎ 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 ）

`text/html$c 構文において，［ `開始tag$／`終了tag$ ］を省略できるかどうかについての，規範的でない記述。 この情報は冗長であり，もっぱら便宜のために供される — 規範的~要件は、 省略可能~tag節 にて与えられる。 ◎ 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木が生成される ］ことを意味すると考えればよいであろう。 例えば ある条件の下で開始tagを省略できる要素もあるが（例： `body$e ）、その場合に省略しても，~DOM木には依然としてその要素が生成されることになる。 】【 開始tagの省略が、終了tagの省略も含意するわけではない — これらを省略できる条件は互いに独立であり、省略できる開始tagを省略して終了tagだけ残しても，構文上は妥当になると考えられる。 】

内容~属性（ Content attributes ）

要素に指定されてよい属性を挙げる，規範的な~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.)

~DOM~interface（ DOM interface ）

当の要素が実装し~MUST ~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に述べられる要件に合致し~MUST。 要素の `内容@ とは、~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.

注記： したがって要素 %A, %B に対し、［ %A, %B の親~nodeが同じである ］~AND［ それらの合間に［ 他の要素~nodeや, （`要素間~空白$以外の） `Text$I ~node ］が無いならば、 【上述の文脈においては，】 %A と %B は `~~隣接する^i とされる。 同様に，要素の子~nodeは、その要素が［ `要素間~空白$, ~comment~node, 処理命令~node ］以外の~nodeを他に包含しないならば，要素の唯一の子になる。 ◎ Thus, an element A is said to be preceded or followed by a second element B if A and B have the same parent node and there are no other element nodes or Text nodes (other than inter-element whitespace) between them. Similarly, a node is the only child of an element if that element contains no other nodes other than inter-element whitespace, comment nodes, and processing instruction nodes.

作者は、［ 各~要素に定義される ／ 他の仕様から明示的に要求される ］ような，明示的に許容される所を除いて、`~HTML要素$を利用しては~MUST_NOT。 ~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 仕様 `ATOM$r では、 `content^e 要素が定義されていて，その `type^a 属性の値が `xhtml^l のときには単独の~HTML `div$e 要素を包含することが要求される。 したがって， `div$e 要素は、その仕様により明示的に規範的であるものと言明されていなくとも，その文脈においては許容される。 ◎ For example, the Atom specification defines a content element. When its type attribute has the value xhtml, the Atom specification 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
• `contenteditable$a
• `dir$a
• `draggable$a
• `hidden$a
• `inputmode$a
• `is$a
• `itemid$a
• `itemprop$a
• `itemref$a
• `itemscope$a
• `itemtype$a
• `lang$a
• `nonce$a
• `spellcheck$a
• `style$a
• `tabindex$a
• `title$a
• `translate$a

これらの属性は、この仕様により，`~HTML要素$のみに対する属性として定義される。 この仕様がこれらの属性を有する要素を~~参照する所では、他の名前空間に属する要素は，これらの属性を有せるものと定義されていない限り，これらの属性を有するものと見なされては~MUST_NOT。 ◎ 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.

WHATWG DOM 標準は、名前空間を問わず，どの要素に対しても［ `class@a ／ `id@a ／ `slot@a ］属性に対する~UA要件を定義している。 `DOM$r ◎ The WHATWG DOM standard 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 属性の値は，`空白区切りの~token集合$で~MUST — 要素が属する種々の~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木$の`根$の`~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の 要素／属性 で可能0なものより木目細かい~interfaceを公開できるようにするため、 支援技術~製品~用の注釈 の集合（ 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:

• `onabort$hd
• `onauxclick$hd
• `onblur$hd†
• `oncancel$hd
• `oncanplay$hd
• `oncanplaythrough$hd
• `onchange$hd
• `onclick$hd
• `onclose$hd
• `oncontextmenu$hd
• `oncuechange$hd
• `ondblclick$hd
• `ondrag$hd
• `ondragend$hd
• `ondragenter$hd
• `ondragexit$hd
• `ondragleave$hd
• `ondragover$hd
• `ondragstart$hd
• `ondrop$hd
• `ondurationchange$hd
• `onemptied$hd
• `onended$hd
• `onerror$hd†
• `onfocus$hd†
• `oninput$hd
• `oninvalid$hd
• `onkeydown$hd
• `onkeypress$hd
• `onkeyup$hd
• `onload$hd†
• `onloadeddata$hd
• `onloadedmetadata$hd
• `onloadend$hd
• `onloadstart$hd
• `onmousedown$hd
• `onmouseenter$hd
• `onmouseleave$hd
• `onmousemove$hd
• `onmouseout$hd
• `onmouseover$hd
• `onmouseup$hd
• `onwheel$hd
• `onpause$hd
• `onplay$hd
• `onplaying$hd
• `onprogress$hd
• `onratechange$hd
• `onreset$hd
• `onresize$hd†
• `onscroll$hd†
• `onsecuritypolicyviolation$hd
• `onseeked$hd
• `onseeking$hd
• `onselect$hd
• `onstalled$hd
• `onsubmit$hd
• `onsuspend$hd
• `ontimeupdate$hd
• `ontoggle$hd
• `onvolumechange$hd
• `onwaiting$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を受取れるのは、`媒体~要素$に限られる。 ◎ 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 等々）を指定して，頁に特有の［ ~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仕様はまた、`~XML文書$内のどの要素に対しても，`~XML名前空間$に属する `~xml_space$a 属性の利用を許容する。 この属性は、`~HTML要素$に対しては効果はない — ~HTMLにおける既定の挙動は，空白を保全するので。 `XML$r ◎ The XML specification 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>

3.2.6.4. `dir^a 属性

`dir$a 属性は、要素の~text方向性を指定する。 この属性は`列挙~属性$であり，次の~keyword, 状態をとり得る： ◎ The dir attribute specifies the element's text directionality. The attribute is an enumerated attribute with the following keywords and states:

`ltr@v （ “left-to-right” ）

`~ltr@st 状態に対応付けられる。 ◎ The ltr keyword, which maps to the ltr state

要素の内容は、明示的に，左横書き~textとして方向的に隔離されることを指示する。 ◎ Indicates that the contents of the element are explicitly directionally isolated left-to-right text.

`rtl@v （ “right-to-left” ）

`~rtl@st 状態に対応付けられる。 ◎ The rtl keyword, which maps to the rtl state

要素の内容は、明示的に，右横書き~textとして方向的に隔離されることを指示する。 ◎ Indicates that the contents of the element are explicitly directionally isolated right-to-left text.

`auto@v

`自動@st 状態に対応付けられる。 ◎ The auto keyword, which maps to the auto state

要素の内容は、明示的に，方向的に隔離される~textであること、および その方向は，当の要素の内容を利用して，（下に述べるように）~program的に決定されることを指示する。 ◎ Indicates that the contents of the element are explicitly directionally isolated text, but that the direction is to be determined programmatically using the contents of the element (as described below).

注記： この状態の下で利用される経験則は、ごく荒削りなものである（それは、双向algoにおける Paragraph Level 決定に相似的な方式で，強い方向性†を備える最初の文字を見るだけである）。 作者には、当の~textの方向が まったく未知で，適用できる より良い~server側~経験則もないときの，最後の~~手段としてのみ、この値を利用することが督促される。 `BIDI$r ◎ The heuristic used by this state is very crude (it just looks at the first character with a strong directionality, in a manner analogous to the Paragraph Level determination in the bidirectional algorithm). Authors are urged to only use this value as a last resort when the direction of the text is truly unknown and no better server-side heuristic can be applied. [BIDI]

【† `双向-字種$の大分類が `Strong^uc に該当する文字。 概ね、文字~自身から，それを利用している~textの方向性を推定できるような文字 — ~Arabicのみに利用される文字であれば、右横書き，等々。 】

【 この節に現れる `双向-字種@ とは、 Unicode bidirectional character type を指す。 】

注記： `textarea$e ／ `pre$e 要素に対しては、この経験則は，段落ごとの~levelで適用される。 ◎ For textarea and pre elements, the heuristic is applied on a per-paragraph level.

`妥当でない値~用の既定$

`値なし用の既定$

`未定義@st 状態に対応付けられる。 ◎ The attribute has no invalid value default and no missing value default.

【 この状態~値は、以下を簡潔に訳すために，この訳で非公式に導入したものである。 原文においては、これらは “ない” ものと定義されている。 】

---

要素（`~HTML要素$でない要素も含む） %要素 の `方向性@ は、［ `~ltr@, `~rtl@ ］のいずれかであり，次の手続きに従って決定される： ◎ The directionality of an element (any element, not just an HTML element) is either 'ltr' or 'rtl', and is determined as per the first appropriate set of steps from the following list:

1. %状態 ~LET %要素 の `dir$a 属性の状態 ◎ ↓
2. ~IF［ %状態 ~EQ `~ltr$st ］ ⇒ ~RET `~ltr$ ◎ If the element's dir attribute is in the ltr state • ↓

3. ~IF［ %状態 ~EQ `未定義$st ］~AND［ 次のいずれかが満たされる ］…：

   • %要素 は`文書~要素$である
   • ［ %要素 は `input$e 要素である ］~AND［ %要素 の `type$a 属性の状態 ~EQ `Tel$st ］

   …ならば ⇒ ~RET `~ltr$

   ◎ If the element is a document element and the dir attribute is not in a defined state (i.e. it is not present or has an invalid value) ◎ If the element is an input element whose type attribute is in the Telephone state, and the dir attribute is not in a defined state (i.e. it is not present or has an invalid value) ◎ • The directionality of the element is 'ltr'.
4. ~IF［ %状態 ~EQ `~rtl$st ］ ⇒ ~RET `~rtl$ ◎ If the element's dir attribute is in the rtl state • The directionality of the element is 'rtl'.

5. ~IF［ %状態 ~EQ `自動$st ］~AND［ 次のいずれかが満たされる ］…： ◎ ↓

   • ［ %要素 は `input$e 要素である ］~AND［ %要素 の `type$a 属性の状態 ~IN { `Text$st, `Search$st, `Tel$st, `Url$st, `Email$st } ］ ◎ If the element is an input element whose type attribute is in the Text, Search, Telephone, URL, or E-mail state, and the dir attribute is in the auto state
   • %要素 は `textarea$e 要素である ◎ If the element is a textarea element and the dir attribute is in the auto state

   …ならば：

   1. %文字列 ~LET %要素 の`値$x ◎ ↓
   2. ~IF［ %文字列 内に［ `双向-字種$ ~IN { `L^uc, `AL^uc, `R^uc } ］なる文字がある `BIDI$r ］ ⇒ ~IF［ そのような最初の文字の`双向-字種$ ~NEQ `L^uc ］ ⇒ ~RET `~rtl$ ◎ If the element's value contains a character of bidirectional character type AL or R, and there is no character of bidirectional character type L anywhere before it in the element's value, then the directionality of the element is 'rtl'. [BIDI]
   3. ~IF［ %文字列 ~NEQ 空~文字列 ］~OR［ %要素 は`文書~要素$である ］ ⇒ ~RET `~ltr$ ◎ Otherwise, if the element's value is not the empty string, or if the element is a document element, the directionality of the element is 'ltr'.
   4. ~RET %要素 の親~要素の`方向性$ ◎ Otherwise, the directionality of the element is the same as the element's parent element's directionality.

6. ~IF［ 次のいずれかが満たされる ］…：

   • %状態 ~EQ `自動$st ◎ If the element's dir attribute is in the auto state
   • ［ %状態 ~EQ `未定義$st ］~AND［ %要素 は `bdi$e 要素である ］ ◎ If the element is a bdi element and the dir attribute is not in a defined state (i.e. it is not present or has an invalid value)

   …ならば：

   1. %文字 ~LET 次のいずれも満たす文字のうち，`木~順序$で最初のもの： ◎ Find the first character in tree order that matches the following criteria:

      • %文字 は［ %要素 のある子孫 `Text$I ~node %T ］内にある ◎ The character is from a Text node that is a descendant of the element whose directionality is being determined.
      • %文字 の`双向-字種$ ~IN { `L^uc, `AL^uc, `R^uc } `BIDI$r ◎ The character is of bidirectional character type L, AL, or R. [BIDI]

      • %T の先祖であって, %要素 の子孫でもある，どの要素も： ◎ The character is not in a Text node that has an ancestor element that is a descendant of the element whose directionality is being determined and that is either:

        • ［ `bdi$e ／ `script$e ／ `style$e ／ `textarea$e ］要素でない, かつ ◎ • A bdi element. • A script element. • A style element. • A textarea element.
        • その `dir$a 属性の状態 ~EQ `未定義$st ◎ An element with a dir attribute in a defined state.
   2. ~IF［ そのような %文字 はある ］ ⇒ ~RET %文字 の`双向-字種$ に応じて ⇒ `AL^uc, `R^uc ならば `~rtl$ ／ `L^uc ならば `~ltr$ ◎ If such a character is found and it is of bidirectional character type AL or R, the directionality of the element is 'rtl'. ◎ If such a character is found and it is of bidirectional character type L, the directionality of the element is 'ltr'.
   3. ~IF［ %要素 は`文書~要素$である ］ ⇒ ~RET `~ltr$ ◎ Otherwise, if the element is a document element, the directionality of the element is 'ltr'.
   4. ~RET %要素 の親~要素の`方向性$ ◎ Otherwise, the directionality of the element is the same as the element's parent element's directionality.
7. ~ELSE（ ［ %状態 ~EQ `未定義$st ］~AND［ %要素 には親~要素がある ］） ⇒ ~RET %要素 の親~要素の`方向性$ ◎ If the element has a parent element and the dir attribute is not in a defined state (i.e. it is not present or has an invalid value) • The directionality of the element is the same as the element's parent element's directionality.

注記： `dir$a 属性は`~HTML要素$に対してのみ定義されているので、他の名前空間に属する要素は，それを有することはなく，自身の`方向性$を，親~要素から継承するか, 親がなければ既定の`~ltr$になる。 ◎ Since the dir attribute is only defined for HTML elements, it cannot be present on elements from other namespaces. Thus, elements from other namespaces always just inherit their directionality from their parent element, or, if they don't have one, default to 'ltr'.

注記： この属性には、 双向algoを孕むような具現化~要件が課される。 ◎ This attribute has rendering requirements involving the bidirectional algorithm.

---

`~HTML要素$ %要素 の `属性の方向性@ は、その属性 %属性 の~textが ある方式で具現化されるときに利用され，次の手続きにより決定される： ◎ The directionality of an attribute of an HTML element, which is used when the text of that attribute is to be included in the rendering in some manner, is determined as per the first appropriate set of steps from the following list:

1. ~IF［ %属性 は`方向性有りの属性$である ］~AND［ %要素 の `dir$a 属性の状態 ~EQ `自動$st ］： ◎ If the attribute is a directionality-capable attribute and the element's dir attribute is in the auto state

   1. ~IF［ %属性 の値~内に，［ `双向-字種$ ~IN { `L^uc, `AL^uc, `R^uc } ］なる文字がある ］］ ⇒ ~IF［［ そのような文字のうち，（論理的~順序で）最初の文字 ］の`双向-字種$ ~NEQ `L^uc ］ ⇒ ~RET `~rtl$ `BIDI$r ◎ Find the first character (in logical order) of the attribute's value that is of bidirectional character type L, AL, or R. [BIDI] ◎ If such a character is found and it is of bidirectional character type AL or R, the directionality of the attribute is 'rtl'.
   2. ~RET `~ltr$ ◎ Otherwise, the directionality of the attribute is 'ltr'.
2. ~RET %要素 の`方向性$ ◎ Otherwise ◎ The directionality of the attribute is the same as the element's directionality.

次の表の左列に挙げる要素~上の，同じ行の右列に挙げる属性は、 `方向性有りの属性@ とされる：

要素	内容~属性
`th$e	`th.abbr$a
`area$e	`area.alt$a
`img$e	`img.alt$a
`input$e	`input.alt$a
`meta$e	`meta.content$a†
`optgroup$e	`optgroup.label$a
`option$e	`option.label$a
`track$e	`track.label$a
`input$e	`input.placeholder$a
`textarea$e	`textarea.placeholder$a
すべての`~HTML要素$	`title$a

† 要素~上の `meta.name$a 属性が~metadata名を指定していて，その値は 機械からではなく人から読まれる用途が第一に意図されている場合に限る。

◎ The following attributes are directionality-capable attributes: • abbr on th elements • alt on area, img, and input elements • content on meta elements, if the name attribute specifies a metadata name whose value is primarily intended to be human-readable rather than machine-readable • label on optgroup, option, and track elements • placeholder on input and textarea elements • title on all HTML elements

---

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

`~html要素$があって，その `dir$a 属性を有するならば、その値を返す。 ◎ Returns the html element's dir attribute's value, if any.

設定して，`~html要素$ の `dir$a 属性の値を［ `ltr^l, `rtl^l, `auto^l ］のいずれかに置換できる。 ◎ Can be set, to either "ltr", "rtl", or "auto" to replace the html element's dir attribute's value.

`~html要素$がなければ， 空~文字列を返す ／ 所与の %value は無視される。 ◎ If there is no html element, returns the empty string and ignores new values.

要素~上の `dir@mE

`既知の値のみに制限される$下で，此れの `dir$a 内容~属性を`反映-$し~MUST。 ◎ The dir IDL attribute on an element must reflect the dir content attribute of that element, limited to only known values.

`文書$上の `dir@m

此れの`~html要素$ %~html ~NEQ ~NULL ならば ⇒ `既知の値のみに制限される$下で， %~html の `dir$a 内容~属性を`反映-$し~MUST。 ◎ The dir IDL attribute on Document objects must reflect the dir content attribute of the html element, if any, limited to only known values.＼

他の場合：

• 取得子は、空~文字列を返さ~MUST。
• 設定子は、何もしては~MUST_NOT。

◎ If there is no such element, then the attribute must return the empty string and do nothing on setting.

注記： 作者には、~text方向を指示するときは，~CSSを利用するのではなく， `dir$a 属性を利用することが強く奨励される。 その仕方であれば、~CSSが不在のときでも（例： 検索~engineに解釈されるとき），文書は正しく具現化し続けられるようになるので。 ◎ Authors are strongly encouraged to use the dir attribute to indicate text direction rather than using CSS, since that way their documents will continue to render correctly even in the absence of CSS (e.g. as interpreted by search engines).

この~markup片は、 Instant messaging による会話のものである： ◎ This markup fragment is of an IM conversation.

`dir-1^xCode

`p$e 要素に対し，相応しい~stylesheet, および 既定の整列~style — すなわち，~textを段落の始端辺に整列する — が与えられた下では、結果の描画は次のようにもなる： ◎ Given a suitable style sheet and the default alignment styles for the p element, namely to align the text to the start edge of the paragraph, the resulting rendering could be as follows:

先に注記したように， `dir.auto$a 値は万能ではない。 この例における~~最後の段落は，~Arabic文字から始まるので、右横書き~textに誤解釈され， "right?" を~Arabic~textの左側に置く。 ◎ As noted earlier, the auto value is not a panacea. The final paragraph in this example is misinterpreted as being right-to-left text, since it begins with an Arabic character, which causes the "right?" to be to the left of the Arabic text.

<script>
if ('PaymentRequest' in window) {
document.documentElement.dataset.hasPaymentRequest = '';
}
</script>

[Exposed=Window,
 OverrideBuiltins]
interface `DOMStringMap@I {
  `getter$dsmap DOMString (DOMString %name);
  [`CEReactions$] `setter$dsmap void (DOMString %name, DOMString %value);
  [`CEReactions$] `deleter$dsmap void (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 ~IDL属性

%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.

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

• `CR^i は、文字 `000D^U CARRIAGE RETURN を表す。
• `LF^i は、文字 `000A^U LINE FEED を表す。
• `TAB^i は、文字 `0009^U CHARACTER TABULATION を表す。

`innerText@m 属性の取得子は、次の手続きに従わ~MUST： ◎ On getting, the innerText attribute must follow these steps:

1. ~IF［ 此れは`具現化されて$いない ］~OR［ ~UAは非~CSS~UAである ］ ⇒ ~RET 此れの `textContent$m ~IDL属性と同じ値 ◎ If this element is not being rendered, or if the user agent is a non-CSS user agent, then return the same value as the textContent IDL attribute on this element.

   注記： この手続きは意外な結果を生産し得る。 この属性が`具現化されて$いない要素~上で~accessされた場合，その~text内容が返される一方、`具現化されて$いる要素~上で~accessされた場合，［ その子たちのうち`具現化されて$いないもの ］の~text内容は無視される。 ◎ This step can produce surprising results, as when the innerText attribute is accessed on an element not being rendered, its text contents are returned, but when accessed on an element that is being rendered, all of its children that are not being rendered have their text contents ignored.

2. %~item~list ~LET `内縁~textを収集する$( 此れ ) ⇒ 結果を成す各~itemは、`~JS文字列$, または（ `要改行数^i を与える）正~整数になる。 ◎ Let results be the list resulting in running the inner text collection steps with this element. Each item in results will either be a JavaScript string or a positive integer (a required line break count).

   注記： `要改行数^i ~itemは、直感的には，その地点に現れる［ ~itemの値で与えられる個数の改行からなる文字列 ］を意味するが、それらは，隣り合う `要改行数^i ~itemどうしで縮約し得る — ~CSSの~margin相殺にある意味似たように。 ◎ Intuitively, a required line break count item means that a certain number of line breaks appear at that point, but they can be collapsed with the line breaks induced by adjacent required line break count items, reminiscent to CSS margin-collapsing.

3. %~item~list から［ 空~文字列である文字列~item ］を`除去する$ ◎ Remove any items from results that are the empty string.
4. %~item~list から，頭部と尾部にある［ 連続する `要改行数^i ~itemたち ］を`除去する$ ◎ Remove any runs of consecutive required line break count items at the start or end of results.
5. %~item~list 内の各［ 連続する `要改行数^i ~itemたち ］を［ それらの~itemの最大~値と同じ個数の `LF^i からなる文字列 ］に`置換する$ ◎ Replace each remaining run of consecutive required line break count items with a string consisting of as many U+000A LINE FEED (LF) characters as the maximum of the values in the required line break count items.
6. ~RET %~item~list 内の文字列~itemたちを順に連結した結果 ◎ Return the concatenation of the string items in results.

`内縁~textを収集する@ ときは、所与の ( `~node$ %~node ) に対し，次を走らす： ◎ The inner text collection steps, given a node node, are as follows:

1. %~item~list ~LET 空`~list$ ◎ ↓

2. %~node の~EACH( 子~node %子 ) に対し，`木~順序$で：

   1. %子~item~list ~LET `内縁~textを収集する$( %子 )
   2. %子~item~list 内の~EACH( %子~item ) に対し ⇒ %~item~list に %子~item を`付加する$
   ◎ Let items be the result of running the inner text collection steps with each child node of node in tree order, and then concatenating the results to a single list.
3. ~IF［ %~node 上の `visibility$p の`算出値$ ~NEQ `visible^v ］ ⇒ ~RET %~item~list ◎ If node's computed value of 'visibility' is not 'visible', then return items.

4. ~IF［ %~node は`具現化されて$いない ］ ⇒ ~RET %~item~list ◎ If node is not being rendered, then return items.＼

   この段の目的においては、次に挙げる要素は，［ その `display$p ~propの`算出値$ ~NEQ `none^v ］ならば、そこに述べるように動作しているものと扱わ~MUST： ◎ For the purpose of this step, the following elements must act as described if the computed value of the 'display' property is not 'none':

   • `select$e 要素 ⇒ `置換され$ない行内~CSS~boxが結付けられていて、子である［ `optgroup$e ／ `option$e ］要素による~boxのみを子~boxとして含んでいる。 ◎ select elements have an associated non-replaced inline CSS box whose child boxes include only those of optgroup and option element child nodes;
   • `optgroup$e 要素 ⇒ `置換され$ない塊levelの~CSS~boxが結付けられていて、子である `option$e 要素による~boxのみを子~boxとして含んでいる。 ◎ optgroup elements have an associated non-replaced block-level CSS box whose child boxes include only those of option element child nodes; and
   • `option$e 要素 ⇒ `置換され$ない塊levelの~CSS~boxが結付けられていて、その子~boxは，通常の `置換され$ない塊levelの~CSS~boxになる。 ◎ option element have an associated non-replaced block-level CSS box whose child boxes are as normal for non-replaced block-level CSS boxes.

   注記： `display^p 値が `contents$v の場合、 %~item~list は非~空になり得る。 ◎ items can be non-empty due to 'display:contents'.

5. ~IF［ %~node は `Text$I ~nodeである（したがって， %~item~list は空） ］： ◎ If node is a Text node, then＼

   1. %~node が生産した ~EACH( ~CSS~text~box ) に対し，内容~順に： ◎ for each CSS text box produced by node, in content order,＼

      1. %文字列~item ~LET［ ~CSSの `空白~処理~規則$, `~text変形法$ `CSSTEXT$r を，~boxの~textに適用して算出される文字列 — ここでは： ◎ compute the text of the box after application of the CSS 'white-space' processing rules and 'text-transform' rules, set items to the list of the resulting strings, and return items.＼

         • `空白~処理~規則$は、少しばかり改変される： 行末の縮約-可能な空白~並びは常に縮約されるが、それらは［ その行が当の~blockの最後の行であるか, または `br$e 要素で終端している ］場合に限り除去されるように。 ◎ The CSS 'white-space' processing rules are slightly modified: collapsible spaces at the end of lines are always collapsed, but they are only removed if the line is the last line of the block, or it ends with a br element.＼
         • ~soft-hyphenは保全されるべきである ◎ Soft hyphens should be preserved. [CSSTEXT]
      2. %~item~list に %文字列~item を`付加する$ ◎ ↑
   2. ~RET %~item~list ◎ ↑
6. ~IF［ %~node は `br$e 要素である ］ ⇒ %~item~list に［ 1 個の `LF^i からなる文字列 ］を`付加する$ ◎ If node is a br element, then append a string containing a single U+000A LINE FEED (LF) character to items.
7. ~IF［ %~node 上の `display$p の`算出値$ ~EQ `table-cell$v ］~AND［ %~node の~CSS~boxは、それを封入している `table-row$v ~boxの最後の `table-cell$v ~boxではない ］ ⇒ %~item~list に［ 1 個の `TAB^i からなる文字列 ］を`付加する$ ◎ If node's computed value of 'display' is 'table-cell', and node's CSS box is not the last 'table-cell' box of its enclosing 'table-row' box, then append a string containing a single U+0009 CHARACTER TABULATION (tab) character to items.
8. ~IF［ %~node 上の `display$p の`算出値$ ~EQ `table-row$v ］~AND［ %~node は［ %~node に最も近い［ %~node の先祖 `table$v ~box ］］の最後の `table-row$v ~boxではない ］ ⇒ %~item~list に［ 1 個の `LF^i からなる文字列 ］を`付加する$ ◎ If node's computed value of 'display' is 'table-row', and node's CSS box is not the last 'table-row' box of the nearest ancestor 'table' box, then append a string containing a single U+000A LINE FEED (LF) character to items.
9. %要改行数 ~LET ε ◎ ↓
10. ~IF［ %~node は `p$e 要素である ］ ⇒ %要改行数 ~SET 2 ◎ If node is a p element, then append 2 (a required line break count) at the beginning and end of items.

11. ~ELIF［ %~node 上の `display$p の`使用値$は［ `塊level$である, または `table-caption$v ］ `CSSDISPLAY$r ］ ⇒ %要改行数 ~SET 1 ◎ If node's used value of 'display' is block-level or 'table-caption', then append 1 (a required line break count) at the beginning and end of items. [CSSDISPLAY]

    注記： 浮動体, 絶対位置された要素は、この分類に入る。 ◎ Floats and absolutely-positioned elements fall into this category.

12. ~IF［ %要改行数 ~NEQ ε ］：

    1. %~item~list に %要改行数 を`前付加する$
    2. %~item~list に %要改行数 を`付加する$
    ◎ ↑
13. ~RET %~item~list ◎ Return items.

注記： 厳密に言えば、ほとんどの`置換され$る要素（例： `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 を見よ。 ◎ 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.

`innerText$m 属性の設定子は、次の手続きに従わ~MUST： ◎ On setting, the innerText attribute must follow these steps:

1. %文書 ~LET 此れの`~node文書$ ◎ Let document be this element's node document.
2. %文書片 ~LET 次のようにされた新たな `DocumentFragment$I ~obj ⇒ `~node文書$ ~SET %文書 ◎ Let fragment be a new DocumentFragment object whose node document is document.
3. %入力 ~LET 所与の値 ◎ Let input be the given value.
4. %位置 ~LET %入力 の先頭の文字を指している`位置~変数$ ◎ Let position be a pointer into input, initially pointing at the start of the string.
5. %~text ~LET 空~文字列 ◎ Let text be the empty string.

6. ~WHILE［ %位置↗ ~NEQ ε ］： ◎ While position is not past the end of input:

   1. %~text ~SET %入力 内の %位置 から { `LF^i, `CR^i } 以外の`符号位置~並びを収集する$ ◎ Collect a sequence of code points that are not U+000A LINE FEED (LF) or U+000D CARRIAGE RETURN (CR) characters from input given position. Set text to the collected characters.
   2. ~IF［ %~text ~NEQ 空~文字列 ］ ⇒ %文書片 に`~nodeを付加する$( 次のようにされた新たな `Text$I ~node ) ⇒ ( `data$m, `~node文書$ ) ~SET ( %~text, %文書 ) ◎ If text is not the empty string, then append a new Text node whose data is text and node document is document to fragment.

   3. ~WHILE［ %位置↗ ~IN { `LF^i, `CR^i } ］： ◎ While position is not past the end of input, and the character at position is either a U+000A LINE FEED (LF) or U+000D CARRIAGE RETURN (CR) character:

      1. ~IF［ %位置↗ ~EQ `CR^i ］~AND［ ( %位置 + 1 )↗ ~EQ `LF^i ］ ⇒ %位置 ~INCBY 1 ◎ If the character at position is a U+000D CARRIAGE RETURN (CR) character and the next character is a U+000A LINE FEED (LF) character, then advance position to the next character in input.
      2. %位置 ~INCBY 1 ◎ Advance position to the next character in input.
      3. %文書片 に`~nodeを付加する$( `要素を作成する$( %文書, `br$e, `~HTML名前空間$ ) ) ◎ Append the result of creating an element given document, br, and the HTML namespace to fragment.
7. 此れの`全~内容を~nodeで置換する$( %文書片 ) ◎ Replace all with fragment within this element.

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

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

`~HTML要素$に対する Accessibility API の意味論を実装するにあたって，~UAに課される要件は、 HTML Accessibility API Mappings にて定義される。 `HTMLAAM$r ◎ User agent requirements for implementing Accessibility API semantics on HTML elements are defined in HTML Accessibility API Mappings. [HTMLAAM]

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