DOM

【この訳に固有の表記規約】

この訳では，以下の表記が用いられる：

• この仕様を通して，よく用いられる［ “結付けられる”, “初期化される”, “新たな … ” ］等々の句については、 ~~共通の慣用表現を~~参照されたし。
• ~algoや定義の記述に利用されている各種記号（ ε, ~LET, ~EQ, ~IF, ~EACH(…), ~RET, ~THROW, 等々）の意味や定義の詳細は、~SYMBOL_DEF_REFを~~参照されたし。
• 太字の “此れ” は，`文脈~obj$を意味する。
• 所与の［ 有限個の~objからなる有順序~集合（例えば`木$や~list）の部分集合（例えば ある条件を満たすものなど） ］ %S に対し，その［ `最初のもの？@ ／ `最後のもの？@ ］とは、 %S が空（例えば，条件を満たす~objが存在しない）ならば ~NULL であり，そうでなければ その順序において %S の中で［ 最初 ／ 最後 ］に在る~objとする。 （ “最初” ／ “最後” がこの意味で用いられる所（ ~NULL にもなり得る所）では、常に（ WebIDL 方式に倣って） "?" が付記される。 ）
• 整数 %index に対する “%index 番” は 0 番から数えるものとする。

1.1. 木

`木@ とは、有限の階層的な木~構造を意味する。 `木~順序@ は、深優先前順走査に基づく。 ◎ A tree is a finite hierarchical tree structure. In tree order is preorder, depth-first traversal of a tree.

<e><e></e>~sourceに<e>現れる<e>順序が</e><e>そのまま<e>木~順序に</e></e>なる</e></e>

`木$に `関与して@ いる各~objは、~objまたは~NULL をとる `親@ を持ち， 0 個以上の~objからなる`有順序~集合$を成す `子たち@ を持つ。 ~obj %A の`親$ %B ~NEQ ~NULL ならば， %A は %B の`子$である。 ◎ An object that participates in a tree has a parent, which is either null or an object, and has children, which is an ordered set of objects. An object A whose parent is object B is a child of B.

【 %A は %B の “子である” という句は、［ %A ~IN %B の`子たち$ ］を意味する。 】【 %B は “子を持つ” という句は、［ %B の`子たち$は`空$でない ］ことを意味する。 】【 同じ~objが同時に複数の~objの子になることはない。 】

~objの `根@ とは、［ ~objの`親$ ~EQ ~NULL ］ならば~obj自身であり，他の場合は~objの`親$の`根$である。 `木$の`根$は、その`木$に`関与して$いる~objであって，［ `親$ ~EQ ~NULL ］なるものである。 ◎ The root of an object is itself, if its parent is null, or else it is the root of its parent. The root of a tree is any object participating in that tree whose parent is null.

【 この定義は、`親$を順々に辿った結果は循環しない（自身には戻らない）ことも含意している。 同様に，`子$を順々に辿った結果も循環しない。 】

~obj %A が~obj %B の `子孫@ であるとは、次を意味する ⇒ ［ %A は %B の`子$である ］~OR［ %A は %B のある`子孫$の`子$である ］ ◎ An object A is called a descendant of an object B, if either A is a child of B or A is a child of an object C that is a descendant of B.

【 上述したように循環しないので、 %A 自身が %A の`子孫$になることはない。 】

~obj %A が~obj %B の `広義子孫@ であるとは、次を意味する ⇒ ［ %A ~EQ %B ］~OR［ %A は %B の`子孫$である ］ ◎ An inclusive descendant is an object or one of its descendants.

【 “広義” という対訳は，よいとは言えないが、より忠実に “自身も含めた子孫” などと訳すのでは，用語として定義する意義 — 他から簡潔に参照できるようにする — も失われる（単に “自身または子孫” と記すのと同じことになる）。 】

~obj %A が~obj %B の `先祖@ であるとは、次を意味する ⇒ %B は %A の`子孫$である ◎ An object A is called an ancestor of an object B if and only if B is a descendant of A.

~obj %A が~obj %B の `広義先祖@ であるとは、次を意味する ⇒ ［ %A ~EQ %B ］~OR［ %A は %B の`先祖$である ］ ◎ An inclusive ancestor is an object or one of its ancestors.

~obj %A が~obj %B の `同胞@ （ “兄弟” ）であるとは、次を意味する ⇒ ［ %A の`親$ ~NEQ ~NULL ］~AND［ %A の`親$ ~EQ %B の`親$ ］ ◎ An object A is called a sibling of an object B, if and only if B and A share the same non-null parent.

【 定義により， %A 自身も 親が非~NULLならば %A の`同胞$になる。 この仕様の中では、この点について特に注意を要する箇所は（現時点では）ないが。 例えば、この同胞の定義を “%A と %B は同じでない” と解釈したとしても，この仕様の残りの部分には影響しない。 】

~obj %A が~obj %B の `広義同胞@ であるとは、次を意味する ⇒ ［ %A ~EQ %B ］~OR［ %A は %B の`同胞$である ］ ◎ An inclusive sibling is an object or one of its siblings.

【 %A 自身は，親が~NULLであっても %A の広義同胞になる点で、`同胞$の定義と異なる。 この定義は、もっぱら他の仕様~用にあり，この仕様~内では利用されない。 】

~obj %A が~obj %B に `先行-@ するとは、次を意味する ⇒ ［ %A と %B は同じ`木$に関与する ］~AND［ `木~順序$において %A は %B より前に在る ］ ◎ An object A is preceding an object B if A and B are in the same tree and A comes before B in tree order.

~obj %A が~obj %B に `後続-@ するとは、次を意味する ⇒ ［ %A と %B は同じ`木$に関与する ］~AND［ `木~順序$において %A は %B より後に在る ］ ◎ An object A is following an object B if A and B are in the same tree and A comes after B in tree order.

~objの `最初の子？@ とは、~objの`子$のうち，`最初のもの？$である。 ◎ The first child of an object is its first child or null if it has no children.

~objの `最後の子？@ とは、~objの`子$のうち，`最後のもの？$である。 ◎ The last child of an object is its last child or null if it has no children.

~objの `前-同胞？@ とは、~objに`先行-$する`同胞$のうち，`最後のもの？$である。 ◎ The previous sibling of an object is its first preceding sibling or null if it has no preceding sibling.

~objの `次-同胞？@ とは、~objに`後続-$する`同胞$のうち，`最初のもの？$である。 ◎ The next sibling of an object is its first following sibling or null if it has no following sibling.

~objの `指数@ とは、~objに`先行-$する`同胞$の個数である（なければ 0 になる）。 ◎ The index of an object is its number of preceding siblings, or 0 if it has none.

1.2. 有順序~集合

文字列 %入力 を `有順序~集合 構文解析器@ にかけるときは、次を走らす： ◎ The ordered set parser takes a string input and then runs these steps:

1. %入力~token列 ~LET `~ASCII空白で分割する$( %入力 ) ◎ Let inputTokens be the result of splitting input on ASCII whitespace.
2. %~token列 ~LET 新たな`有順序~集合$ ◎ Let tokens be a new ordered set.
3. %入力~token列 内の ~EACH( %~token ) に対し ⇒ %~token列 に %~token を`付加する$set ◎ For each token in inputTokens, append token to tokens.
4. ~RET %~token列 ◎ Return tokens.

文字列からなる有順序~集合 %S を `有順序~集合 直列化器@ にかけるときは、 %S を U+0020 で`連結-$した結果を返す。 ◎ The ordered set serializer takes a set and returns the concatenation of set using U+0020 SPACE.

1.3. 選択子

%node の `視野の下で選択子を照合する@ ときは、所与の ( 文字列 %選択子 ) に対し，次を走らす： ◎ To scope-match a selectors string selectors against a node, run these steps:

1. %S ~LET `選択子として構文解析する$( %選択子 ) `SELECTORS4$r ◎ Let s be the result of parse a selector selectors. [SELECTORS4]
2. ~IF［ %S ~EQ `失敗^i ］ ⇒ ~THROW `SyntaxError$E ◎ If s is failure, then throw a "SyntaxError" DOMException.
3. ~RET `木に対し選択子を照合する$( 選択子 %S, 根~要素たち %node の`根$, `視野根$ %node ) `SELECTORS4$r ◎ Return the result of match a selector against a tree with s and node’s root using scoping root node. [SELECTORS4].

注記： 選択子の中の~nsに対する~supportは、計画されておらず，追加されることはない。 ◎ Support for namespaces within selectors is not planned and will not be added.

1.4. ~ns

`有修飾~名として検証する@ ときは、所与の ( %名前 ) に対し，次を走らす ⇒ ~IF［ %名前 は `Name$prod 生成規則にも `QName$prod 生成規則にも合致しない ］ ⇒ ~THROW `InvalidCharacterError$E ◎ To validate a qualifiedName, throw an "InvalidCharacterError" DOMException if qualifiedName does not match the Name or QName production.

`検証して抽出する@ ときは、所与の ( %~ns, %名前 ) に対し，次を走らす： ◎ To validate and extract a namespace and qualifiedName, run these steps:

1. ~IF［ %~ns ~EQ 空~文字列 ］ ⇒ %~ns ~SET ~NULL ◎ If namespace is the empty string, set it to null.
2. `有修飾~名として検証する$( %名前 ) ◎ Validate qualifiedName.
3. %接頭辞 ~LET ~NULL ◎ Let prefix be null.
4. %局所~名 ~LET %名前 ◎ Let localName be qualifiedName.
5. ~IF［ %名前 は `:^l (U+003A) を含む 【 `PrefixedName$prod 生成規則に合致】 ］ ⇒ ( %接頭辞, %局所~名 ) ~SET %名前 をそこで分割して得られる ( 前の部分, 後の部分 ) ◎ If qualifiedName contains a ":" (U+003E), then split the string on it and set prefix to the part before and localName to the part after.

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

   • ［ %~ns ~EQ ~NULL ］~AND［ %接頭辞 ~NEQ ~NULL ］ ◎ If prefix is non-null and namespace is null, then throw a "NamespaceError" DOMException.
   • ［ %~ns ~NEQ `~XML~ns$ ］~AND［ %接頭辞 ~EQ `xml^l ］ ◎ If prefix is "xml" and namespace is not the XML namespace, then throw a "NamespaceError" DOMException.
   • ［ %~ns ~NEQ `~XMLNS~ns$ ］~AND［［ %名前 ~EQ `xmlns^l ］~OR［ %接頭辞 ~EQ `xmlns^l ］］ ◎ If either qualifiedName or prefix is "xmlns" and namespace is not the XMLNS namespace, then throw a "NamespaceError" DOMException.
   • ［ %~ns ~EQ `~XMLNS~ns$ ］~AND［ %名前 ~NEQ `xmlns^l ］~AND［ %接頭辞 ~NEQ `xmlns^l ］ ◎ If namespace is the XMLNS namespace and neither qualifiedName nor prefix is "xmlns", then throw a "NamespaceError" DOMException.

   …ならば ⇒ ~THROW `NamespaceError$E ◎ ↑

7. ~RET ( %~ns, %接頭辞, %局所~名 ) ◎ Return namespace, prefix, and localName.

2.1. “DOM Events” 序論

Web ~platformを全体を通して，`~event$は、~network活動や利用者との対話など，何かが生じた際に通達するために，~objに向けて`配送-$される。 これらの~objは $EventTarget ~ifcを実装し， その $addEventListener() を~callすることにより `~event$を観測するための`~event~listener$を追加できる： ◎ Throughout the web platform events are dispatched to objects to signal an occurrence, such as network activity or user interaction. These objects implement the EventTarget interface and can therefore add event listeners to observe events by calling addEventListener():

%obj.addEventListener("load", imgFetched)

function imgFetched(%ev) {
  // 成功裡に load できた
  …
}

`~event~listener$は、 $removeEventListener() ~methに同じ引数を渡すことにより除去できる。 ◎ Event listeners can be removed by utilizing the removeEventListener() method, passing the same arguments.

`~event$もまた~objであり， $Event ~ifc（またはその派生d~ifc）を実装する。 上の例では、 %ev が`~event$である。 %ev は、`~event~listener$の `callback$evL （概して上に示したような~JS Function ）に引数として渡される。 `~event~listener$は、まず，`~event$の $type 属性~値（上の例では `load^l ）をその~~制御に利用する。 `~event$の $target 属性~値は`~event$の`配送-$先の~obj（上の例の %obj ）を返す。 ◎ Events are objects too and implement the Event interface (or a derived interface). In the example above ev is the event. ev is passed as an argument to the event listener’s callback (typically a JavaScript Function as shown above). Event listeners key off the event’s type attribute value ("load" in the above example). The event’s target attribute value returns the object to which the event was dispatched (obj above).

`~event$は、概して，利用者との対話や何らかの~task完了の結果，~UAにより`配送-$されるが、~app自身も，合成~eventと共通的に称されるものを利用して`~event$を`配送-$できる： ◎ Although events are typically dispatched by the user agent as the result of user interaction or the completion of some task, applications can dispatch events themselves by using what are commonly known as synthetic events:

// ~custom~event~listenerを追加する
obj.addEventListener("cat", function(%e) { process(%e.detail) })

// ~eventを作成して配送する
var %event = new CustomEvent("cat", {"detail":{"hazcheeseburger":true}})
%obj.dispatchEvent(%event)

通達-時の他にも、`~event$は，演算の中で次に起きる出来事を~appに制御させる~~目的で利用されることがある。 例えば，~form提出の一環として、 $type 属性が `submit^l にされた`~event$が`配送-$される。 この`~event$の $preventDefault() ~methが呼出されると，~formは提出されずに終了されることになる。 ~appにより`配送-$される`~event$（合成~event）を通して，この機能性を利用する場合、 $EventTarget.dispatchEvent() ~methの返値も利用できる： ◎ Apart from signaling, events are sometimes also used to let an application control what happens next in an operation. For instance as part of form submission an event whose type attribute value is "submit" is dispatched. If this event’s preventDefault() method is invoked, form submission will be terminated. Applications who wish to make use of this functionality through events dispatched by the application (synthetic events) can make use of the return value of the dispatchEvent() method:

if(%obj.dispatchEvent(%event)) {
  // ~eventは取消されなかった。手品の時間だ。
  …
}

`~event$が`木$に`関与して$いる~obj（例えば`要素$）に向けて`配送-$される場合、その~eventは，その~objの`先祖$ 上の`~event~listener$にも到達し得る： ◎ When an event is dispatched to an object that participates in a tree (e.g. an element), it can reach event listeners on that object’s ancestors too.＼

1. 最初は、~objの各 `先祖$に対し， `capture$evL 変数が ~T にされている`~event~listener$が`木~順序$で呼出される。 ◎ First all object’s ancestor event listeners whose capture variable is set to true are invoked, in tree order.＼
2. 次に、~obj自身の`~event~listener$が呼出される。 ◎ Second, object’s own event listeners are invoked.＼
3. 最後に、`~event$の $bubbles 属性~値が true のときにのみ，~objの各 `先祖$に対し 【 `capture$evL 変数が ~F にされている】 `~event~listener$が，今度は`木~順序$の逆順に呼出される。 ◎ And finally, and only if event’s bubbles attribute value is true, object’s ancestor event listeners are invoked again, but now in reverse tree order.

<!doctype html>
<html>
 <head>
  <title>つまらない例</title>
 </head>
 <body>
  <p>Hello <span id=x>world</span>!</p>
  <script>
function test(%e) {
  debug(%e.target, %e.currentTarget, %e.eventPhase); // A
}
document.addEventListener("hey", test, {capture: true}); // B
document.body.addEventListener("hey", test); // C
var %ev = new Event("hey", {bubbles:true})
document.getElementById("x").dispatchEvent(%ev);
  </script>
 </body>
</html>

2.2. ^@Event ~ifc

$Event ~objは、単に `~event@ とも称される。 それは、何かが生じたときにそれが通達されるようにする — 例えば，画像を~downloadし終えたときなど。 ◎ An Event object is simply named an event. It allows for signaling that something has occurred, e.g., that an image has completed downloading.

`~event~targetになり得るもの@ は、 ~NULL または $EventTarget ~objである。 ◎ A potential event target is null or an EventTarget object.

各`~event$には、次のものが結付けられる： ◎ ↓

`~target@

`~event~targetになり得るもの$。 他が言明されない限り， ~NULL とする。 ◎ An event has an associated target (a potential event target). Unless stated otherwise it is null.

`関係d~target@

`~event~targetになり得るもの$。 他が言明されない限り， ~NULL とする。 ◎ An event has an associated relatedTarget (a potential event target). Unless stated otherwise it is null.

注記： 他の仕様は ^relatedTarget 属性を定義するときに `関係d~target$を利用する。 `UIEVENTS$r ◎ Other specifications use relatedTarget to define a relatedTarget attribute. [UIEVENTS]

`~touch~target~list@

0 個~以上の`~event~targetになり得るもの$からなる`~list$。 他が言明されない限り，空~listとする。 ◎ An event has an associated touch target list (a list of zero or more potential event targets). Unless stated otherwise it is the empty list.

注記： `~touch~target~list$は、もっぱら $TouchEvent ~ifcとそれに関係する~ifcを定義するために利用される。 `TOUCH-EVENTS$r ◎ The touch target list is for the exclusive use of defining the TouchEvent interface and related interfaces. [TOUCH-EVENTS]

`経路@

0 個~以上の`構造体$からなる`~list$であり、初期~時は空とする。 それを成す各 `構造体$は次のものからなる：

`~item@evP

$EventTarget ~obj。

`~shadow木~内？@evP

真偽値。

`~target@evP

`~event~targetになり得るもの$

`関係d~target@evP

`~event~targetになり得るもの$

`~touch~target~list@evP

0 個以上の`~event~targetになり得るもの$からなる`~list$

`~closed木の根？@evP

真偽値。

`~slotは~closed木~内？@evP

真偽値。

◎ An event has an associated path. A path is a list of structs. Each struct consists of an item (an EventTarget object), an item-in-shadow-tree (a boolean), a target (a potential event target), a relatedTarget (a potential event target), a touch target list (a list of potential event targets), a root-of-closed-tree (a boolean), and a slot-in-closed-tree (a boolean). A path is initially the empty list.

%event = new $Event(type [, eventInitDict])

$type 属性~値が %type にされた，新たな %event を返す。 %eventInitDict 引数により，［ $bubbles ／ $cancelable ］属性も — 同じ名前の~obj~memberを介して — 設定できる。 ◎ Returns a new event whose type attribute value is set to type. The eventInitDict argument allows for setting the bubbles and cancelable attributes via object members of the same name.

%event . $type

%event の型を返す。 例えば `click^l, `hashchange^l, `submit^l など。 ◎ Returns the type of event, e.g. "click", "hashchange", or "submit".

%event . $target

%event の`配送-$先の~obj（ %event の`~target$ ）を返す。 ◎ Returns the object to which event is dispatched (its target).

%event . $currentTarget

現在~呼出されている `callback$evL を持つ`~event~listener$が登録されている~objを返す。 ◎ Returns the object whose event listener’s callback is currently being invoked.

%event . $composedPath()

%event の`経路$内に在る各 `~item$evP ~obj（それ上で~listenerが呼出される~obj）からなる~listを返す — ただし、［ `~shadow根$の`~mode$sR ~EQ `closed^l ］なる`~shadow木$内の`~node$であって， %event の $currentTarget からは到達できないものは、返値から除かれる。 ◎ Returns the item objects of event’s path (objects on which listeners will be invoked), except for any nodes in shadow trees of which the shadow root’s mode is "closed" that are not reachable from event’s currentTarget.

%event . $eventPhase

`~event$の相： $NONE, $CAPTURING_PHASE, $AT_TARGET, $BUBBLING_PHASE のいずれかを返す。 ◎ Returns the event’s phase, which is one of NONE, CAPTURING_PHASE, AT_TARGET, and BUBBLING_PHASE.

%event . $stopPropagation()

`木$ 内に`配送-$されているとき、この~methを呼出すことにより，現在の~obj以外の~objには %event が到達しないようになる。 ◎ When dispatched in a tree, invoking this method prevents event from reaching any objects other than the current object.

%event . $stopImmediatePropagation()

この~methを呼出すことにより、 %event は 現在の~listenerを走り終えた後に［ それまでに登録された`~event~listener$ ］には到達しなくなり、`木$ 内に`配送-$されたときには， %event は他のどの~objにも到達しなくなる。 ◎ Invoking this method prevents event from reaching any registered event listeners after the current one finishes running and, when dispatched in a tree, also prevents event from reaching any other objects.

%event . $bubbles

%event がどう初期化されたかに応じて，~T か~F を返す。 %event がその`~target$の`先祖$へ`木~順序$の逆順にも遡る場合は ~T を返し, 他の場合は~F を返す。 ◎ Returns true or false depending on how event was initialized. True if event goes through its target’s ancestors in reverse tree order, and false otherwise.

%event . $cancelable

%event がどう初期化されたかに応じて，~T か~F を返す。 その返値は常に意味を持つとは限らないが、~T の場合， %event が`配送-$されている間の演算は $preventDefault() ~methを呼出すことにより取消せることを指示し得る。 ◎ Returns true or false depending on how event was initialized. Its return value does not always carry meaning, but true can indicate that part of the operation during which event was dispatched, can be canceled by invoking the preventDefault() method.

%event . $preventDefault()

%event の $cancelable 属性~値が ~T にされている下で，［ $AddEventListenerOptions.passive 属性が ~F に設定された %event ］用の~listenerの実行-中に呼出された場合、 %event が取消される必要がある旨をその`配送-$ 演算に通達する。 ◎ If invoked when the cancelable attribute value is true, and while executing a listener for the event with passive set to false, signals to the operation that caused event to be dispatched that it needs to be canceled.

%event . $defaultPrevented

~T は、 $preventDefault() が呼出され, 成功裡に取消されたことを指示する。 他の場合は~F を返す。 ◎ Returns true if preventDefault() was invoked successfully to indicate cancelation, and false otherwise.

%event . $composed

%event がどう初期化されたかに依存して ~T か ~F を返す。 ［ %event の`~target$の`根$が $ShadowRoot `~node$である ］ときに，その~nodeを過ぎた先†に在る~listenerも呼出す場合は ~T になり、他の場合は~F になる。 ◎ Returns true or false depending on how event was initialized. True if event invokes listeners past a ShadowRoot node that is the root of its target, and false otherwise.

【† %~event の`経路$が、`~shadow根$の`~host$を通して別の`~node木$へつながるように，構成される。 】

%event . $isTrusted

%event が~UA から`配送-$されたものである場合は~T を, 他の場合は~F を返す。 ◎ Returns true if event was dispatched by the user agent, and false otherwise.

%event . $timeStamp

%event の時刻印を`時刻起点$からのミリ秒数で返す。 ◎ Returns the event’s timestamp as the number of milliseconds measured relative to the time origin.

@type

取得子は、初期化-時の値を返すモノトスル。 ◎ The type attribute must return the value it was initialized to.＼

`~event$の作成-時には、この属性は空~文字列に初期化されるモノトスル。 ◎ When an event is created the attribute must be initialized to the empty string.

@target

取得子は、此れの`~target$を返すモノトスル。 ◎ The target attribute’s getter, when invoked, must return the context object’s target.

@srcElement

取得子は、此れの`~target$を返すモノトスル。 ◎ The srcElement attribute’s getter, when invoked, must return the context object’s target.

@currentTarget

取得子は、初期化-時の値を返すモノトスル。 ◎ The currentTarget attribute must return the value it was initialized to.＼

`~event$の作成-時には、この属性は ~NULL に初期化されるモノトスル。 ◎ When an event is created the attribute must be initialized to null.

@composedPath()

被呼出時には、次を走らすモノトスル： ◎ The composedPath() method, when invoked, must run these steps:

1. %~composed経路 ~LET 空`~list$ ◎ Let composedPath be an empty list.
2. %経路 ~LET 此れの`経路$ ◎ Let path be the context object’s path.
3. ~IF［ %経路 は`空$である ］ ⇒ ~RET %~composed経路 ◎ If path is empty, then return composedPath.
4. %現-~target ~LET 此れの $currentTarget 属性~値 ◎ Let currentTarget be the context object’s currentTarget attribute value.
5. %~composed経路 に %現-~target を`付加する$ ◎ Append currentTarget to composedPath.
6. %現-~target~index ~LET 0 ◎ Let currentTargetIndex be 0.
7. %現-~targetの~hidden部分木~level ~LET 0 ◎ Let currentTargetHiddenSubtreeLevel be 0.
8. %~index ~LET %経路 の`~size$ − 1 ◎ Let index be path’s size − 1.

9. ~WHILE［ %~index ~GTE 0 ］： ◎ While index is greater than or equal to 0:

   1. ~IF［ %経路[ %~index ] の`~closed木の根？$evP ~EQ ~T ］ ⇒ %現-~targetの~hidden部分木~level ~INCBY 1 ◎ If path[index]'s root-of-closed-tree is true, then increase currentTargetHiddenSubtreeLevel by 1.
   2. ~IF［ %経路[ %~index ] の`~item$evP ~EQ %現-~target ］ ⇒＃ %現-~target~index ~SET %~index； ~BREAK ◎ If path[index]'s item is currentTarget, then set currentTargetIndex to index and break.
   3. ~IF［ %経路[ %~index ] の`~slotは~closed木~内？$evP ~EQ ~T ］ ⇒ %現-~targetの~hidden部分木~level ~DECBY 1 ◎ If path[index]'s slot-in-closed-tree is true, then decrease currentTargetHiddenSubtreeLevel by 1.
   4. %~index ~DECBY 1 ◎ Decrease index by 1.
10. ( %現-~hidden~level, %最大~hidden~level ) ~LET ( %現-~targetの~hidden部分木~level, %現-~targetの~hidden部分木~level ) ◎ Let currentHiddenLevel and maxHiddenLevel be currentTargetHiddenSubtreeLevel.
11. %~index ~SET %現-~target~index ~MINUS 1 ◎ Set index to currentTargetIndex − 1.

12. ~WHILE［ %~index ~GTE 0 ］： ◎ While index is greater than or equal to 0:

    1. ~IF［ %経路[ %~index ] の`~closed木の根？$evP ~EQ ~T ］ ⇒ %現-~hidden~level ~INCBY 1 ◎ If path[index]'s root-of-closed-tree is true, then increase currentHiddenLevel by 1.
    2. ~IF［ %現-~hidden~level ~LTE %最大~hidden~level ］ ⇒ %~composed経路 に %経路[ %~index ] の`~item$evPを`前付加する$ ◎ If currentHiddenLevel is less than or equal to maxHiddenLevel, then prepend path[index]'s item to composedPath.

    3. ~IF［ %経路[ %~index ] の`~slotは~closed木~内？$evP ~EQ ~T ］： ◎ If path[index]'s slot-in-closed-tree is true, then:

       1. %現-~hidden~level ~DECBY 1 ◎ Decrease currentHiddenLevel by 1.
       2. ~IF［ %最大~hidden~level ~GTE %現-~hidden~level ］ ⇒ %最大~hidden~level ~SET %現-~hidden~level ◎ If currentHiddenLevel is less than maxHiddenLevel, then set maxHiddenLevel to currentHiddenLevel.
    4. %~index ~DECBY 1 ◎ Decrease index by 1.
13. ( %現-~hidden~level, %最大~hidden~level ) ~SET ( %現-~targetの~hidden部分木~level, %現-~targetの~hidden部分木~level ) ◎ Set currentHiddenLevel and maxHiddenLevel to currentTargetHiddenSubtreeLevel.
14. %~index ~SET %現-~target~index ~PLUS 1 ◎ Set index to currentTargetIndex + 1.

15. ~WHILE［ %~index ~LT %経路 の`~size$ ］： ◎ While index is less than path’s size:

    1. ~IF［ %経路[ %~index ] の`~slotは~closed木~内？$evP ~EQ ~T ］ ⇒ %現-~hidden~level ~INCBY 1 ◎ If path[index]'s slot-in-closed-tree is true, then increase currentHiddenLevel by 1.
    2. ~IF［ %現-~hidden~level ~LTE %最大~hidden~level ］ ⇒ %~composed経路 に %経路[ %~index ] の`~item$evPを`付加する$ ◎ If currentHiddenLevel is less than or equal to maxHiddenLevel, then append path[index]'s item to composedPath.

    3. ~IF［ %経路[ %~index ] の`~closed木の根？$evP ~EQ ~T ］： ◎ If path[index]'s root-of-closed-tree is true, then:

       1. %現-~hidden~level ~DECBY 1 ◎ Decrease currentHiddenLevel by 1.
       2. ~IF［ %最大~hidden~level ~GTE %現-~hidden~level ］ ⇒ %最大~hidden~level ~SET %現-~hidden~level ◎ If currentHiddenLevel is less than maxHiddenLevel, then set maxHiddenLevel to currentHiddenLevel.
    4. %~index ~INCBY 1 ◎ Increase index by 1.
16. ~RET %~composed経路 ◎ Return composedPath.

@eventPhase

取得子は、初期化-時の値を返すモノトスル。 値は、次のいずれかをとるモノトスル（括弧内は数-値）： ◎ The eventPhase attribute must return the value it was initialized to, which must be one of the following:

@NONE (0)

まだ`配送-$されていない`~event$はこの相に属する。 ◎ Events not currently dispatched are in this phase.

@CAPTURING_PHASE (1)

`~event$が`木$に`関与して$いる~objに向けて`配送-$されるとき、~eventがその`~target$に到達するまでは，この相に属する。 ◎ When an event is dispatched to an object that participates in a tree it will be in this phase before it reaches its target.

@AT_TARGET (2)

`~event$が`配送-$されるとき、~eventの`~target$上では，この相に属する。 ◎ When an event is dispatched it will be in this phase on its target.

@BUBBLING_PHASE (3)

`~event$が`木$に`関与して$いる~objに向けて`配送-$されるとき、~eventがその`~target$に到達した後は，この相に属する。 ◎ When an event is dispatched to an object that participates in a tree it will be in this phase after it reaches its target.

`~event$の作成-時には、この属性は $NONE に初期化されるモノトスル。 ◎ Initially the attribute must be initialized to NONE.

各`~event$には、次に挙げる~flagが結付けられる — いずれも初期~時は ~OFF とする ⇒＃ `伝播停止@f, `伝播即停止@f, `取消d@f, `受動~listener内@f, `~composed@f, `初期化-済み@f, `配送-@f ◎ Each event has the following associated flags that are all initially unset: • stop propagation flag • stop immediate propagation flag • canceled flag • in passive listener flag • composed flag • initialized flag • dispatch flag

@stopPropagation()

被呼出時には、次を走らすモノトスル ⇒ 此れの`伝播停止$f ~SET ~ON ◎ The stopPropagation() method, when invoked, must set the context object’s stop propagation flag.

@cancelBubble

取得子は、此れの`伝播停止$fに応じて，次を返すモノトスル ⇒＃ ~ON ならば ~T ／ ~OFF ならば ~F ◎ The cancelBubble attribute’s getter, when invoked, must return true if the context object’s stop propagation flag is set, and false otherwise.

設定子は、次を走らすモノトスル ⇒ ~IF［ 所与の値 ~EQ ~T ］ ⇒ 此れの`伝播停止$f ~SET ~ON ◎ The cancelBubble attribute’s setter, when invoked, must set the context object’s stop propagation flag if the given value is true, and do nothing otherwise.

@stopImmediatePropagation()

被呼出時には、次を走らすモノトスル ⇒ 此れの ( `伝播停止$f, `伝播即停止$f ) ~SET ( ~ON, ~ON ) ◎ The stopImmediatePropagation() method, when invoked, must set the context object’s stop propagation flag and the context object’s stop immediate propagation flag.

@bubbles

@cancelable

これらのいずれも，取得子は、それぞれの初期化-時の値を返すモノトスル。 ◎ The bubbles and cancelable attributes must return the values they were initialized to.

`取消d~flagを設定する@ ときは、所与の ( `~event$ %~event ) に対し，次を走らすモノトスル ⇒ ~IF［ %~event の $cancelable 属性~値 ~EQ ~T ］~AND［ %~event の`受動~listener内$f ~EQ ~OFF ］ ⇒ %~event の`取消d$f ~SET ~ON ◎ To set the canceled flag, given an event event, if event’s cancelable attribute value is true and event’s in passive listener flag is unset, then set event’s canceled flag, and do nothing otherwise.

@returnValue

取得子は、此れの`取消d$fに応じて，次を返すモノトスル ⇒＃ ~ON ならば ~T ／ ~OFF ならば ~F ◎ The returnValue attribute’s getter, when invoked, must return false if context object’s canceled flag is set, and true otherwise.

設定子は、次を走らすモノトスル ⇒ ~IF［ 所与の値 ~EQ ~F ］ ⇒ `取消d~flagを設定する$( 此れ ) ◎ The returnValue attribute’s setter, when invoked, must set the canceled flag with the context object if the given value is false, and do nothing otherwise.

@preventDefault()

被呼出時には、次を走らすモノトスル ⇒ `取消d~flagを設定する$( 此れ ) ◎ The preventDefault() method, when invoked, must set the canceled flag with the context object.

注記： $preventDefault() を呼出しても効果がない局面もある。 ~UAには、~debugを援助するため，精確な~~原因を開発者~consoleに~logすることが奨励される。 ◎ There are scenarios where invoking preventDefault() has no effect. User agents are encouraged to log the precise cause in a developer console, to aid debugging.

@defaultPrevented

取得子は、此れの`取消d$f に応じて，次を返すモノトスル ⇒＃ ~ON ならば ~T ／ ~OFF ならば ~F ◎ The defaultPrevented attribute’s getter, when invoked, must return true if the context object’s canceled flag is set, and false otherwise.

@composed

取得子は、此れの`~composed$f に応じて，次を返すモノトスル ⇒＃ ~ON ならば ~T ／ ~OFF ならば ~F ◎ The composed attribute’s getter, when invoked, must return true if the context object’s composed flag is set, and false otherwise.

@isTrusted

取得子は、初期化-時の値を返すモノトスル。 ◎ The isTrusted attribute must return the value it was initialized to.＼

`~event$の作成-時には、この属性は~F に初期化されるモノトスル。 ◎ When an event is created the attribute must be initialized to false.

注記： $isTrusted は、`~event$は（ $EventTarget.dispatchEvent() を利用してではなく）~UAにより`配送-$されたかどうかを簡便に指示する。 唯一の旧来の例外は `click()$m であり，~UAに`~event$を［ $isTrusted 属性は ~F に初期化- ］した上で配送させる。 ◎ isTrusted is a convenience that indicates whether an event is dispatched by the user agent (as opposed to using dispatchEvent()). The sole legacy exception is click(), which causes the user agent to dispatch an event whose isTrusted attribute is initialized to false.

@timeStamp

取得子は、初期化-時の値を返すモノトスル。 ◎ The timeStamp attribute must return the value it was initialized to.

`~eventを初期化する@ ときは、所与の ( %event, %type, %bubbles, %cancelable ) に対し， %event の各種~propを次のように設定するモノトスル ⇒＃ `初期化-済み$f ~SET ~ON, `伝播停止$f ~SET ~OFF, `伝播即停止$f ~SET ~OFF, `取消d$f ~SET ~OFF, $isTrusted 属性 ~SET ~F, `~target$ ~SET ~NULL, $type 属性 ~SET %type, $bubbles 属性 ~SET %bubbles, $cancelable 属性 ~SET %cancelable ◎ To initialize an event, with type, bubbles, and cancelable, run these steps: • Set event’s initialized flag. • Unset event’s stop propagation flag, stop immediate propagation flag, and canceled flag. • Set event’s isTrusted attribute to false. • Set event’s target to null. • Set event’s type attribute to type. • Set event’s bubbles attribute to bubbles. • Set event’s cancelable attribute to cancelable.

@initEvent(type, bubbles, cancelable)

被呼出時には、次を走らすモノトスル： ◎ The initEvent(type, bubbles, cancelable) method, when invoked, must run these steps:

1. ~IF［ 此れの`配送-$f ~EQ ~ON ］ ⇒ ~RET ◎ If the context object’s dispatch flag is set, then return.
2. `~eventを初期化する$( 此れ, %type, %bubbles, %cancelable ) ◎ Initialize the context object with type, bubbles, and cancelable.

注記： $initEvent() は、`~event$には構築子が在るので冗長であり，また $composed も設定できないが、旧来の内容~用に~supportされる必要がある。 ◎ As events have constructors initEvent() is redundant and incapable of setting composed. It has to be supported for legacy content.

2.3. ^Window ~ifcに対する旧来の拡張

各 $Window ~objには `現在の~event@ が結付けられる。 それは，［ `undefined^c ／ $Event ~obj ］であり、他が言明されない限り， `undefined^c とする。 ◎ Each Window object has an associated current event (undefined or an Event object). Unless stated otherwise it is undefined.

`event@m

取得子は、此れの`現在の~event$を返すモノトスル。 ◎ The event attribute’s getter, when invoked, must return the context object’s current event.

注記： ~web開発者には、代わりに~event~listenerに渡される $Event ~objに依拠することが強く奨励される — その方が、~codeは より~portableになるので。 この属性は、~workerや~worklet内では可用でなく， `~shadow木$内に配送される~event用には 不正確になる。 ◎ Web developers are strongly encouraged to instead rely on the Event object passed to event listeners, as that will result in more portable code. This attribute is not available in workers or worklets, and is inaccurate for events dispatched in shadow trees.

2.4. ^@CustomEvent ~ifc

~custom~dataを運ばせる用途に， $CustomEvent ~ifcを利用する`~event$を利用できる。 ◎ Events using the CustomEvent interface can be used to carry custom data.

%event = new $CustomEvent(type [, eventInitDict])

$Event の構築子と相似的に働く — %eventInitDict 引数により， $detail 属性も設定できることを除いて。 ◎ Works analogously to the constructor for Event except that the eventInitDict argument now allows for setting the detail attribute too.

%event . $detail

%event の作成-時に与えられた~custom~dataを返す。 概して，合成~eventで利用される。 ◎ Returns any custom data event was created with. Typically used for synthetic events.

@detail

取得子は、初期化-時の値を返すモノトスル。 ◎ The detail attribute must return the value it was initialized to.

@initCustomEvent(type, bubbles, cancelable, detail)

被呼出時には、次を走らすモノトスル： ◎ The initCustomEvent(type, bubbles, cancelable, detail) method must, when invoked, run these steps:

1. ~IF［ 此れの`配送-$f ~EQ ~ON ］ ⇒ ~RET ◎ If the context object’s dispatch flag is set, then return.
2. `~eventを初期化する$( 此れ, %type, %bubbles, %cancelable ) ◎ Initialize the context object with type, bubbles, and cancelable.
3. 此れの $detail 属性 ~SET %detail ◎ Set the context object’s detail attribute to detail.

2.5. ~eventの構築-法

`適用-可能な仕様$は、すべてまたは一部の`~event$用に `~event構築-時の手続き@ を定義してもヨイ。 この~algoは、`~eventを内部的に作成する$手続き内から， ( `~event$ ) を渡して呼出される。 ◎ Specifications may define event constructing steps for all or some events. The algorithm is passed an event as indicated in the inner event creation steps.

注記： この構成子は、 $Event 下位classが，その初期化-用の辞書~memberと~IDL属性とが一対一に対応していない，より複階的な構造を備えるときに利用できる。 ◎ This construct can be used by Event subclasses that have a more complex structure than a simple 1:1 mapping between their initializing dictionary members and IDL attributes.

@Event.Event(type, eventInitDict)

@CustomEvent.CustomEvent(type, eventInitDict)

`~event構築子@ — すなわち，［ $Event ~ifc, または それを継承する~ifc ］ %~ifc の構築子 — は、次を走らすモノトスル： ◎ When a constructor of the Event interface, or of an interface that inherits from the Event interface, is invoked, these steps must be run, given the arguments type and eventInitDict:

1. %~event ~LET `~eventを内部的に作成する$( %~ifc, ~NULL, 現在時, %eventInitDict ) ◎ Let event be the result of running the inner event creation steps with this interface, null, now, and eventInitDict.
2. %~event の $Event.type 属性 ~SET %type に初期化する ◎ Initialize event’s type attribute to type.
3. ~RET %~event ◎ Return event.

`~eventを作成する@ ときは、所与の ⇒＃ %~event~ifc （ $Event または それを継承する~ifc ）, %~realm （ `~Realm$, 省略時は ~NULL ） ◎終 に対し，次を走らす： ◎ To create an event using eventInterface, which must be either Event or an interface that inherits from it, and optionally given a Realm realm, run these steps: • If realm is not given, then set it to null.

1. %辞書 ~LET ~JS `undefined^c 値を［ %~event~ifc の構築子が引数に受容する`辞書$型（ $EventInit またはそれを継承する辞書~型） ］に`変換-$した結果 ◎ Let dictionary be the result of converting the JavaScript value undefined to the dictionary type accepted by eventInterface’s constructor. (This dictionary type will either be EventInit or a dictionary that inherits from it.)

   これは、当の辞書~型に必須の~memberが在る場合に働かない。 whatwg/dom#600 を見よ。 ◎ This does not work if members are required; see whatwg/dom#600.

2. %今 ~LET ~eventを通達している時点の時刻 ◎ ↓

3. %~event ~LET `~eventを内部的に作成する$( %~event~ifc, %~realm, %今, %辞書~値 ) ◎ Let event be the result of running the inner event creation steps with eventInterface, realm, the time of the occurrence that the event is signaling, and dictionary.

   注記： 例えば macOS においては、入力~動作が生じた時刻は ^NSEvent ~objの ^timestamp ~propを介して可用になる。 ◎ In macOS the time of the occurrence for input actions is available via the timestamp property of NSEvent objects.

4. %~event の $isTrusted 属性 ~SET ~T に初期化する ◎ Initialize event’s isTrusted attribute to true.
5. ~RET %~event ◎ Return event.

注記： `~eventを作成する$手続きは、単純に`~eventを発火する$代わりに［ `~eventを作成する$, ~eventを`配送-$する ］手続きを別々に呼出す必要がある，他の仕様からの利用が~~意図されている。 これは、~eventの属性が既定の値に正しく初期化されることを確保する。 ◎ Create an event is meant to be used by other specifications which need to separately create and dispatch events, instead of simply firing them. It ensures the event’s attributes are initialized to the correct defaults.

`~eventを内部的に作成する@ ときは、所与の ( %~ifc, %~realm, %時刻, %辞書 ) に対し，次を走らす： ◎ The inner event creation steps, given an interface, realm, time, and dictionary, are as follows:

1. %~event ~LET %~ifc を利用する, %~realm 内の，新たな~obj — ただし， %~realm ~EQ ε の場合は Web IDL に定義される既定の挙動に従う ◎ Let event be the result of creating a new object using eventInterface. If realm is non-null, then use that Realm; otherwise, use the default behavior defined in Web IDL.

   これを書いている時点では、まだ Web IDL はこの既定の挙動を定義していない。 heycam/webidl#135 を見よ。 ◎ As of the time of this writing Web IDL does not yet define any default behavior; see heycam/webidl#135.

2. %~event の`初期化-済み$f ~SET ~ON ◎ Set event’s initialized flag.

3. %~event の $Event.timeStamp 属性 ~SET ［ `時刻起点$から %時刻 までの高分解能な時間差 ］を表現している $DOMHighResTimeStamp 値に初期化する ◎ Initialize event’s timeStamp attribute to a DOMHighResTimeStamp representing the high resolution time from the time origin to time.

   既存の時計~分解能の推奨 に従って、~UAは， $Event.timeStamp 属性を 5 マイクロ秒までの分解能に設定するべきである。 `HR-TIME$r 【現在のその仕様では、この推奨は，具体的な数値に代えて別の形で述べられている。】 ◎ User agents should set a minimum resolution of event’s timeStamp attribute to 5 microseconds following the existing clock resolution recommendation. [HR-TIME]

4. %辞書 内の ~EACH( %~member → %値 ) に対し ⇒ ~IF［ %~event には %~member を`識別子$とする属性はある ］ ⇒ その属性 ~SET %値 に初期化する ◎ For each member → value in dictionary, if event has an attribute whose identifier is member, then initialize that attribute to value.
5. `~event構築-時の手続き$に ( %~event ) を渡して走らす ◎ Run the event constructing steps with event.
6. ~RET %~event ◎ Return event.

2.6. ~event~ifcの定義-法

一般に、$Event を継承する新たな~ifcを定義する際には，常に WHATWG または W3C WebApps WG ~communityからの~feedbackを仰ぐように願う。 ◎ In general, when defining a new interface that inherits from Event please always ask feedback from the WHATWG or the W3C WebApps WG community.

$CustomEvent ~ifcはその出発点に利用できるものだが、 `init*Event()^c の類いの~methは，構築子とかぶって冗長になるので導入しないように。 $Event ~ifcを継承する~ifcがその種の~methを備えているのは、歴史上の理由に限られている。 ◎ The CustomEvent interface can be used as starting point. However, do not introduce any init*Event() methods as they are redundant with constructors. Interfaces that inherit from the Event interface that have such a method only have it for historical reasons.

2.7. ^@EventTarget ~ifc

$@EventTarget ~objは、何かが起きた時に`~event$を`配送-$できる~targetを表現する。 ◎ An EventTarget object represents a target to which an event can be dispatched when something has occurred.

（ 各 $EventTarget ~objには、 `~event~listener~list@ が結付けられる — それは、 0 個~以上の`~event~listener$からなる`~list$であり，初期~時には空とする。 ◎ Each EventTarget object has an associated event listener list (a list of zero or more event listeners). It is initially the empty list.

`~event~listener@ を利用すれば、特定の`~event$を観測できる — それは、次のものからなる： ◎ An event listener can be used to observe a specific event and consists of:

• `type@evL — 文字列 ◎ type (a string)
• `callback@evL — ~NULL, または $EventListener ~obj ◎ callback (null or an EventListener object)
• `capture@evL — 真偽値, 初期~時は ~F とする。 ◎ capture (a boolean, initially false)
• `passive@evL — 真偽値, 初期~時は ~F とする。 ◎ passive (a boolean, initially false)
• `once@evL — 真偽値, 初期~時は ~F とする。 ◎ once (a boolean, initially false)
• `removed@evL — 内部処理用の真偽値, 初期~時は ~F とする。 ◎ removed (a boolean for bookkeeping purposes, initially false)

注記： `callback$evL は $EventListener ~objであるが、`~event~listener$は 上に示したように より広い概念である。 ◎ Although callback is an EventListener object, an event listener is a broader concept as can be seen above.

各 $EventTarget ~objには、その `親~targetを取得する@ ~algoも結付けられる。 それは、所与の`~event$に対し，［ $EventTarget ~obj, または ~NULL ］を返す。 他から指定されない限り， ~NULL を返すとする。 ◎ Each EventTarget object also has an associated get the parent algorithm, which takes an event event, and returns an EventTarget object. Unless specified otherwise it returns null.

注記： ［ `~node$ ／ `~shadow根$ ／ `文書$ ］は、`親~targetを取得する$~algoを上書きする。 ◎ Nodes, shadow roots, and documents override the get the parent algorithm.

【 この~algoは、~eventの`配送-$時にその伝播`経路$を構築するために利用される。 】【 指定される個々の~algoには、渡された~eventを利用しないものもある（その場合、~eventは省略して記述され得る）。 】

各 $EventTarget ~objには、 `作動化の挙動@ が結付けられ得る。 この~algoは、`配送-$する~algo内から， ( `~event$ ) を渡して呼出される。 ◎ Each EventTarget object can have an associated activation behavior algorithm. The activation behavior algorithm is passed an event, as indicated in the dispatch algorithm.

注記： これが存在するのは、~UAが ある種の $EventTarget ~objに対し，ある種の動作を遂行するためである — 例えば `area$e 要素は、合成 $MouseEvent `~event$に呼応して，その $Event.type 属性は `click^l にされる。 それを除去することは、~Web互換性のため できない。 それはまた、今や，何らかの作動化を定義するときに~~尊守されている仕方になっている。 `HTML$r ◎ This exists because user agents perform certain actions for certain EventTarget objects, e.g., the area element, in response to synthetic MouseEvent events whose type attribute is click. Web compatibility prevented it from being removed and it is now the enshrined way of defining an activation of something. [HTML]

加えて、`作動化の挙動$を有する各 $EventTarget ~objには、［ `旧来の作動化~前の挙動@, `旧来の作動化~取消~時の挙動@ ］を備えるものもある（片方のみ備えることはない）。 ◎ Each EventTarget object that has activation behavior, can additionally have both (not either) a legacy-pre-activation behavior algorithm and a legacy-canceled-activation behavior algorithm.

注記 これらの~algoは，［ Checkbox ／ Radio ］状態にある `input$e 要素のみに存在し、他では利用されない。 `HTML$r ◎ These algorithms only exist for checkbox and radio input elements and are not to be used for anything else. [HTML]

%target = new $EventTarget();

開発者が`~event$を`配送-$して~listenするために利用できる，新たな $EventTarget ~objを作成する。 ◎ Creates a new EventTarget object, which can be used by developers to dispatch and listen for events.

%target . $addEventListener(type, callback [, options])

%target の`~event~listener~list$に［ $Event.type 属性~値が %type である`~event$用の`~event~listener$ ］を付加する。 %callback 引数が，`~event$が`配送-$されたときに呼出される `callback$evL として設定される。 ◎ Appends an event listener for events whose type attribute value is type. The callback argument sets the callback that will be invoked when the event is dispatched.

%options 引数は、~listener特有な~optionを設定する。 互換性のため、これは真偽値もとり得る — その場合、この~methは，正確に［ %options の $EventListenerOptions.capture に その値が指定された ］かのように挙動する。 ◎ The options argument sets listener-specific options. For compatibility this can be a boolean, in which case the method behaves exactly as if the value was specified as options’s capture.

%options の $EventListenerOptions.capture が［ ~T ／ ［ ~F または無い ］］ならば、 `callback$evL は，［ `~event$の $eventPhase 属性~値が［ $Event.BUBBLING_PHASE ／ $Event.CAPTURING_PHASE ］の間は，呼出されない ］ようになる。 いずれにせよ、`~event$の $Event.eventPhase 属性~値が $Event.AT_TARGET のときは， `callback$evL は呼出される。 ◎ When set to true, options’s capture prevents callback from being invoked when the event’s eventPhase attribute value is BUBBLING_PHASE. When false (or not present), callback will not be invoked when event’s eventPhase attribute value is CAPTURING_PHASE. Either way, callback will be invoked if event’s eventPhase attribute value is AT_TARGET.

%options の $AddEventListenerOptions.passive が ~T に設定されている場合、 `callback$evL は $Event.preventDefault() を呼出しても`~event$を取消さないことを指示する。 これは、 ~event~listenerの観測-法 に述べる処理能の最適化を可能化するために利用される ◎ When set to true, options’s passive indicates that the callback will not cancel the event by invoking preventDefault(). This is used to enable performance optimizations described in §2.8 Observing event listeners.

%options の $AddEventListenerOptions.once が ~T に設定されている場合、~callbackが呼出されるのは一度限りであり，その後には`~event~listener$は除去されることを指示する。 ◎ When set to true, options’s once indicates that the callback will only be invoked once after which the event listener will be removed.

`~event~listener$は、重複しない — すなわち， `type$evL, `callback$evL, `capture$evL のいずれかが異なる — 場合に限り， %target の`~event~listener~list$に付加される。 ◎ The event listener is appended to target’s event listener list and is not appended if it has the same type, callback, and capture.

%target . $removeEventListener(type, callback [, options])

引数と同じ［ `type$evL, `callback$evL, `capture$evL ］を持つ`~event~listener$を， %target の`~event~listener~list$から除去する。 ◎ Removes the event listener in target’s event listener list with the same type, callback, and options.

%target . $dispatchEvent(event)

合成~event %event を %target に向けて`配送-$する。 ［ %event の $cancelable 属性~値が ~F であるか, または %event の $preventDefault() ~methが呼出されていないとき ］は~T，他の場合は~F を返す。 ◎ Dispatches a synthetic event event to target and returns true if either event’s cancelable attribute value is false or its preventDefault() method was not invoked, and false otherwise.

%options を `平坦化-@ するときは、次を走らす： ◎ To flatten options, run these steps:

1. ~IF［ %options は ~B 型である ］ ⇒ ~RET %options ◎ If options is a boolean, then return options.
2. ~RET %options の $EventListenerOptions.capture ~member値 ◎ Return options’s capture.

%options を `もっと平坦化-@ するときは、次を走らす： ◎ To flatten more options, run these steps:

1. %capture ~LET %options を `平坦化-$した結果 ◎ Let capture be the result of flattening options.
2. ( %once, %passive ) ~LET ( ~F, ~F ) ◎ Let once and passive be false.
3. ~IF［ %options は`辞書$である ］ ⇒ ( %passive, %once ) ~SET %options の ( $AddEventListenerOptions.passive, $AddEventListenerOptions.once ) ~member値 ◎ If options is a dictionary, then set passive to options’s passive and once to options’s once.
4. ~RET ( %capture, %passive, %once ) ◎ Return capture, passive, and once.

@EventTarget()

この構築子の被呼出時には、新たな $EventTarget を返すモノトスル。 ◎ The EventTarget() constructor, when invoked, must return a new EventTarget.

注記： 他所に言明される既定により、返される $EventTarget の`親~targetを取得する$~algoは，~NULL を返すことになり、［ `作動化の挙動$, `旧来の作動化~前の挙動$, `旧来の作動化~取消~時の挙動$ ］は無い。 ◎ Because of the defaults stated elsewhere, the returned EventTarget's get the parent algorithm will return null, and it will have no activation behavior, legacy-pre-activation behavior, or legacy-canceled-activation behavior.

注記： 将来には、`親~targetを取得する$~custom~algoも許容され得る。 作者は、それが自身の~programに有用になるなら知らせてほしい。 今の所は、作者が作成したどの $EventTarget も，木~構造には関与しない。 ◎ In the future we could allow custom get the parent algorithms. Let us know if this would be useful for your programs. For now, all author-created EventTargets do not participate in a tree structure.

`~event~listenerを追加する@ ときは、所与の ( $EventTarget ~obj %~target, `~event~listener$ %~listener ) に対し，次を走らす： ◎ To add an event listener given an EventTarget object eventTarget and an event listener listener, run these steps:

1. ~IF［ %~target に`関連する大域~obj$ %G は $ServiceWorkerGlobalScope ~objである ］~AND［ %G に結付けられている`~sw$の`~script資源$の，`評価されたことがある~flag$ ~EQ ~ON ］`SERVICE-WORKERS$r ⇒ ~THROW `TypeError$E ◎ If eventTarget’s relevant global object is a ServiceWorkerGlobalScope object and its associated service worker’s script resource’s has ever been evaluated flag is set, then throw a TypeError. [SERVICE-WORKERS]

   注記： ［ 当の~sw用に許容される~event型の格納-法を最適化する ］ため, および［ ~event~listenerに対する非決定的な変更を避ける ］ため、この【手続きを利用する】~methの呼出が許容されるのは，~sw~scriptが初めて評価される間に限られる。 ◎ To optimize storing the event types allowed for the service worker and to avoid non-deterministic changes to the event listeners, invocation of the method is allowed only during the very first evaluation of the service worker script.

2. ~IF［ %~listener の`callback$evL ~EQ ~NULL ］ ⇒ ~RET ◎ If listener’s callback is null, then return.
3. ~IF［ ある［ `~event~listener$ ~IN %~target の`~event~listener~list$ ］が在って，［ ( `type$evL, `callback$evL, `capture$evL ) ~EQ %~listener の ( `type$evL, `callback$evL, `capture$evL ) ］を満たす ］ ⇒ ~RET ◎ If eventTarget’s event listener list does not contain an event listener whose type is listener’s type, callback is listener’s callback, and capture is listener’s capture, then＼
4. %~target の`~event~listener~list$に %~listener を`付加する$ ◎ append listener to eventTarget’s event listener list.

注記： ［ `~event~listenerを追加する$ ］の概念は、［ `~event~handler$ `HTML$r が同じ `code path^en を利用する ］ことを確保するためにある。 ◎ The add an event listener concept exists to ensure event handlers use the same code path. [HTML]

@addEventListener(type, callback, options)

被呼出時には、次を走らすモノトスル： ◎ The addEventListener(type, callback, options) method, when invoked, must run these steps:

1. ( %capture, %passive, %once ) ~LET %options を`もっと平坦化-$した結果 ◎ Let capture, passive, and once be the result of flattening more options.
2. `~event~listenerを追加する$( 此れ, 次のようにされた`~event~listener$ ) ⇒＃ `type$evL ~SET %type , `callback$evL ~SET %callback , `capture$evL ~SET %capture , `passive$evL ~SET %passive , `once$evL ~SET %once ◎ Add an event listener with the context object and an event listener whose type is type, callback is callback, capture is capture, passive is passive, and once is once.

`~event~listenerを除去する@ ときは、所与の ( $EventTarget ~obj %~target, `~event~listener$ %~listener ) に対し，次を走らす ⇒＃ %~listener の `removed$evL ~SET ~T； %~target の`~event~listener~list$から %~listener を`除去する$ ◎ To remove an event listener, given an EventTarget object eventTarget and an event listener listener, set listener’s removed to true and remove listener from eventTarget’s event listener list.

`~event~listenerをすべて除去する@ ときは、所与の ( $EventTarget ~obj %~target ) に対し，次を走らす ⇒ %~target の`~event~listener~list$内の ~EACH( %~listener ) に対し ⇒ `~event~listenerを除去する$( %~target, %~listener ) ◎ To remove all event listeners, given an EventTarget object eventTarget, for each listener of eventTarget’s event listener list, remove an event listener with eventTarget and listener.

注記： ~HTMLは、 ^document.open() を定義するために これを必要とする。 `HTML$r ◎ HTML needs this to define document.open(). [HTML]

@removeEventListener(type, callback, options)

被呼出時には、次を走らすモノトスル： ◎ The removeEventListener(type, callback, options) method, when invoked, must run these steps:

1. ~IF［ 此れに`関連する大域~obj$ %G は $ServiceWorkerGlobalScope ~objである ］~AND［ %G に結付けられている`~sw$の`~script資源$の，`評価されたことがある~flag$ ~EQ ~ON ］`SERVICE-WORKERS$r ⇒ ~THROW `TypeError$E ◎ If the context object’s relevant global object is a ServiceWorkerGlobalScope object and its associated service worker’s script resource’s has ever been evaluated flag is set, then throw a TypeError. [SERVICE-WORKERS]
2. ~IF［ ある［ `~event~listener$ %~listener ~IN 此れの`~event~listener~list$ ］が在って，［ ( `type$evL, `callback$evL, `capture$evL ) ~EQ ( %type, %callback, %capture ) ］を満たす ］ ⇒ `~event~listenerを除去する$( 此れ, %~listener ) ◎ If the context object’s event listener list contains an event listener whose type is type, callback is callback, and capture is capture, then remove an event listener with the context object and that event listener.

注記： ~event~listener~listが ( `type^evL, `callback^evL, `capture^evL ) が互いに等しい複数の~event~listenerを包含することはない。 それは、`~event~listenerを追加する$ときに防止される。 ◎ The event listener list will not contain multiple event listeners with equal type, callback, and capture, as add an event listener prevents that.

@dispatchEvent(event)

被呼出時には、次を走らすモノトスル： ◎ The dispatchEvent(event) method, when invoked, must run these steps:

1. ~IF［ %event の`配送-$f ~EQ ~ON ］~OR［ %event の`初期化-済み$f ~EQ ~OFF ］ ⇒ ~THROW `InvalidStateError$E ◎ If event’s dispatch flag is set, or if its initialized flag is not set, then throw an "InvalidStateError" DOMException.
2. %event の $isTrusted 属性 ~SET ~F に初期化する ◎ Initialize event’s isTrusted attribute to false.
3. ~RET 此れに向けて %event を`配送-$した結果 ◎ Return the result of dispatching event to the context object.

2.8. ~event~listenerの観測-法

一般に、開発者は，`~event~listener$の有無が観測-可能になるものとは予期しない。 `~event~listener$の影響0は、その `callback$evL により決定される。 すなわち開発者は、何もしない`~event~listener$を追加しても，副作用が生じるとは予期しない。 ◎ In general, developers do not expect the presence of an event listener to be observable. The impact of an event listener is determined by its callback. That is, a developer adding a no-op event listener would not expect it to have any side effects.

あいにく，一部の~event~APIは、効率的に実装するためには，`~event~listener$を観測することが要求される設計になっている。 すなわち、何もしない~listenerであっても，~appの挙動における処理能に劇的に影響0し得る結果、~listenerの有無が観測-可能になっている。 例えば ~touch／~wheel ~eventの利用は、非同期~scrollingを阻むことがある。 一部の事例では、［ ~eventが $cancelable になるのは， $AddEventListenerOptions.passive でない~listenerが 1 個~以上あるときに限る ］ように指定することで，この問題を軽減できる。 例えば、 $AddEventListenerOptions.passive でない $TouchEvent ~listenerは，~scrollingを阻まなければならないが、どの~listenerも $AddEventListenerOptions.passive であれば，［ $TouchEvent を（ $preventDefault() の~callは無視されるように）取消せなくすることで，~scrollingを`並列的$に開始できる ］ようになる。 ~eventを配送している~codeは、そのように $AddEventListenerOptions.passive でない~listenerの~~不在を観測でき，それを利用して配送-中の~eventの $cancelable ~propを ~F にできる。 ◎ Unfortunately, some event APIs have been designed such that implementing them efficiently requires observing event listeners. This can make the presence of listeners observable in that even empty listeners can have a dramatic performance impact on the behavior of the application. For example, touch and wheel events which can be used to block asynchronous scrolling. In some cases this problem can be mitigated by specifying the event to be cancelable only when there is at least one non-passive listener. For example, non-passive TouchEvent listeners must block scrolling, but if all listeners are passive then scrolling can be allowed to start in parallel by making the TouchEvent uncancelable (so that calls to preventDefault() are ignored). So code dispatching an event is able to observe the absence of non-passive listeners, and use that to clear the cancelable property of the event being dispatched.

新たな~event~APIは、この~propを必要としないように定義されるのが理想的である（論を交わしたければ public-script-coord@w3.org を利用されたし）。 ◎ Ideally, any new event APIs are defined such that they do not need this property (use public-script-coord@w3.org for discussion).

2.9. ~eventの配送-法

1. %~event の`配送-$f ~SET ~ON ◎ Set event’s dispatch flag.

2. %上書きする~target ~LET ［ %旧来の~targetを上書きする~flag ~EQ ε ならば %target ／ ~ELSE_ %target に`結付けられている文書$ `HTML$r ］ ◎ Let targetOverride be target, if legacy target override flag is not given, and target’s associated Document otherwise. [HTML]

   注記： %旧来の~targetを上書きする~flag は、~HTMLからのみ, それも %target が $Window ~objである場合に限り，非 ε にされる。 ◎ legacy target override flag is only used by HTML and only when target is a Window object.

3. %作動化~target ~LET ~NULL ◎ Let activationTarget be null.
4. %関係d~target ~LET %~event の`関係d~target$を %target に向けて`~targetし直す$ ◎ Let relatedTarget be the result of retargeting event’s relatedTarget against target.

5. ~IF［ %target ~NEQ %関係d~target ］~OR［ %target ~EQ %~event の`関係d~target$ ］： ◎ If target is not relatedTarget or target is event’s relatedTarget, then:

   1. %~touch~target~list ~LET 新たな`~list$ ◎ Let touchTargets be a new list.
   2. %~event の`~touch~target~list$内の ~EACH( %~touch~target ) に対し ⇒ %~touch~target~list に次の結果を`付加する$ ⇒ %~touch~target を %~target に向けて`~targetし直す$ ◎ For each touchTarget of event’s touch target list, append the result of retargeting touchTarget against target to touchTargets.
   3. `~event経路に付加する$( %~event, %target, %上書きする~target, %関係d~target, %~touch~target~list, ~F ) ◎ Append to an event path with event, target, targetOverride, relatedTarget, touchTargets, and false.
   4. %作動化~eventか？ ~LET［ %~event は次を満たすならば ~T ／ ~ELSE_ ~F ］ ⇒ ［ $MouseEvent ~objである ］~AND［ $type 属性 ~EQ `click^l ］ ◎ Let isActivationEvent be true, if event is a MouseEvent object and event’s type attribute is "click", and false otherwise.
   5. ~IF［ %作動化~eventか？ ~EQ ~T ］~AND［ %target は`作動化の挙動$を有する ］ ⇒ %作動化~target ~SET %target ◎ If isActivationEvent is true and target has activation behavior, then set activationTarget to target.
   6. %~slotable ~LET［ 次が満たされるならば %~target ／ ~ELSE_ ~NULL ］ ⇒ ［ %~target は`~slotable$である ］~AND［ %~target の`割当先~slot$ ~NEQ ~NULL ］ ◎ Let slotable be target, if target is a slotable and is assigned, and null otherwise.
   7. %~slotは~closed木~内？ ~LET ~F ◎ Let slot-in-closed-tree be false.
   8. %親 ~LET %target の`親~targetを取得する$( %~event ) ◎ Let parent be the result of invoking target’s get the parent with event.

   9. ~WHILE［ %親 ~NEQ ~NULL ］： ◎ While parent is non-null:

      1. ~IF［ %~slotable ~NEQ ~NULL ］： ◎ If slotable is non-null:

         1. ~Assert： %親 は`~slot$である ◎ Assert: parent is a slot.
         2. %~slotable ~SET ~NULL ◎ Set slotable to null.
         3. ~IF［ %親 の`根$は［ `~shadow根$である ］~AND［ `~mode$sR ~EQ `closed^l ］を満たす ］ ⇒ %~slotは~closed木~内？ ~SET ~T ◎ If parent’s root is a shadow root whose mode is "closed", then set slot-in-closed-tree to true.
      2. ~IF［ %親 は`~slotable$である ］~AND［ %親 の`割当先~slot$ ~NEQ ~NULL ］ ⇒ %~slotable ~SET %親 ◎ If parent is a slotable and is assigned, then set slotable to parent.
      3. %関係d~target ~LET %関係d~target を %親 に向けて`~targetし直す$ ◎ Let relatedTarget be the result of retargeting event’s relatedTarget against parent.
      4. %~touch~target~list ~LET 新たな`~list$ ◎ Let touchTargets be a new list.
      5. %~event の`~touch~target~list$内の ~EACH( %~touch~target ) に対し ⇒ %~touch~target~list に次の結果を`付加する$ ⇒ %~touch~target を %親 に向けて`~targetし直す$ ◎ For each touchTarget of event’s touch target list, append the result of retargeting touchTarget against parent to touchTargets.

      6. ~IF［ %親 は $Window ~objである ］~OR［［ %親 は`~node$である ］~AND［ %target の`根$ は %親 の`~shadowも含む広義先祖$である ］］： ◎ If parent is a Window object, or parent is a node and target’s root is a shadow-including inclusive ancestor of parent, then:

         1. ~IF［ %作動化~eventか？ ~EQ ~T ］~AND［ %~event の $bubbles 属性 ~EQ ~T ］~AND［ %作動化~target ~EQ ~NULL ］~AND［ %親 は`作動化の挙動$を有する ］ ⇒ %作動化~target ~SET %親 ◎ If isActivationEvent is true, event’s bubbles attribute is true, activationTarget is null, and parent has activation behavior, then set activationTarget to parent.

         2. `~event経路に付加する$( %~event, %親, ~NULL, %関係d~target, %~touch~target~list, %~slotは~closed木~内？ ) ◎ Append to an event path with event, parent, null, relatedTarget, touchTargets, and slot-in-closed-tree.
      7. ~ELIF［ %親 ~EQ %関係d~target ］ ⇒ %親 ~SET ~NULL ◎ Otherwise, if parent is relatedTarget, then set parent to null.

      8. ~ELSE： ◎ Otherwise,＼

         1. %target ~SET %親 ◎ set target to parent and then:
         2. ~IF［ %作動化~eventか？ ~EQ ~T ］~AND［ %作動化~target ~EQ ~NULL ］~AND［ %target は`作動化の挙動$を有する ］ ⇒ %作動化~target ~SET %target ◎ If isActivationEvent is true, activationTarget is null, and target has activation behavior, then set activationTarget to target.
         3. `~event経路に付加する$( %~event, %親, %target, %関係d~target, %~touch~target~list, %~slotは~closed木~内？ ) ◎ Append to an event path with event, parent, target, relatedTarget, touchTargets, and slot-in-closed-tree.
      9. ~IF［ %親 ~NEQ ~NULL ］ ⇒ %親 ~SET %親 の`親~targetを取得する$( %~event ) ◎ If parent is non-null, then set parent to the result of invoking parent’s get the parent with event.
      10. %~slotは~closed木~内？ ~SET ~F ◎ Set slot-in-closed-tree to false.
   10. %~targetを消去する構造体 ~LET %~event の`経路$内の構造体のうち，［ `~target$evP ~NEQ ~NULL ］を満たすもののうち，最後のもの ◎ Let clearTargetsStruct be the last struct in event’s path whose target is non-null.
   11. %~targetたちを消去する ~LET 次を満たす`~node$ %~node は［ 在るならば ~T ／ 無いならば ~F ］ ⇒ ［ %~node の`根$は`~shadow根$である ］~AND［ %~node は次に挙げるいずれかである ］ ⇒＃ %~targetを消去する構造体 の`~target$evP, %~targetを消去する構造体 の`関係d~target$evP, %~targetを消去する構造体 の`~touch~target~list$evP 内にあるもの ◎ Let clearTargets be true if clearTargetsStruct’s target, clearTargetsStruct’s relatedTarget, or an EventTarget object in clearTargetsStruct’s touch target list is a node and its root is a shadow root, and false otherwise.
   12. ~IF［ %作動化~target ~NEQ ~NULL ］~AND［ %作動化~target は `旧来の作動化~前の挙動$を備えている ］ ⇒ その挙動を走らす ◎ If activationTarget is non-null and activationTarget has legacy-pre-activation behavior, then run activationTarget’s legacy-pre-activation behavior.

   13. %~event の`経路$内の ~EACH( %構造体 ) に対し，逆順に： ◎ For each struct in event’s path, in reverse order:

       1. %~event の $eventPhase 属性 ~SET ［ %構造体 の `~target$evP ~NEQ ~NULL ならば $AT_TARGET ／ ~ELSE_ $CAPTURING_PHASE ］ ◎ If struct’s target is non-null, then set event’s eventPhase attribute to AT_TARGET. ◎ Otherwise, set event’s eventPhase attribute to CAPTURING_PHASE.
       2. `~listenerを呼出す$( %構造体, %~event, `capturing^l ) ◎ Invoke with struct, event, "capturing", and legacyOutputDidListenersThrowFlag if given.

   14. ~IF［ %~event の $bubbles 属性 ~EQ ~T ］ ⇒ %~event の`経路$内の ~EACH( %構造体 ) に対し： ◎ If event’s bubbles attribute is true, then for each struct in event’s path:

       1. %~event の $eventPhase 属性 ~SET ［ %構造体 の `~target$evP ~NEQ ~NULL ならば $AT_TARGET ／ ~ELSE_ $BUBBLING_PHASE ］ ◎ If struct’s target is non-null, then set event’s eventPhase attribute to AT_TARGET. ◎ Otherwise, set event’s eventPhase attribute to BUBBLING_PHASE.
       2. `~listenerを呼出す$( %構造体, %~event, `bubbling^l ) ◎ Invoke with struct, event, "bubbling", and legacyOutputDidListenersThrowFlag if given.
6. %~event の $eventPhase 属性 ~SET $NONE ◎ Set event’s eventPhase attribute to NONE.
7. %~event の $currentTarget 属性 ~SET ~NULL ◎ Set event’s currentTarget attribute to null.
8. %~event の`経路$ ~SET 空~list ◎ Set event’s path to the empty list.
9. %~event の ⇒＃ `配送-$f ~SET ~OFF, `伝播停止$f ~SET ~OFF, `伝播即停止$f ~SET ~OFF ◎ Unset event’s dispatch flag, stop propagation flag, and stop immediate propagation flag.

10. ~IF［ %~targetたちを消去する ~EQ ~T ］ ⇒ %~event の ⇒＃ `~target$ ~SET ~NULL `関係d~target$ ~SET ~NULL `~touch~target~list$ ~SET 空~list ◎ If clearTargets, then: • Set event’s target to null. • Set event’s relatedTarget to null. • Set event’s touch target list to the empty list.

11. ~IF［ %作動化~target ~NEQ ~NULL ］： ◎ If activationTarget is non-null, then:

    1. ~IF［ %~event の`取消d$f ~EQ ~OFF ］ ⇒ %~event を渡して， %作動化~target の`作動化の挙動$を走らす ◎ If event’s canceled flag is unset, then run activationTarget’s activation behavior with event.
    2. ~ELIF［ %作動化~target は `旧来の作動化~取消~時の挙動$を備えている ］ ⇒ その挙動を走らす ◎ Otherwise, if activationTarget has legacy-canceled-activation behavior, then run activationTarget’s legacy-canceled-activation behavior.
12. ~RET %~event の`取消d$f に応じて ⇒＃ ~ON ならば ~T ／ ~OFF ならば ~F ◎ Return false if event’s canceled flag is set, and true otherwise.

`~event経路に付加する@ ときは、所与の ( %~event, %~target, %上書きする~target, %関係d~target, %~touch~target~list, %~slotは~closed木~内？ ) に対し，次を走らす： ◎ To append to an event path, given an event, target, targetOverride, relatedTarget, touchTargets, and a slot-in-closed-tree, run these steps:

1. %~shadow木~内？ ~LET ［ %~target は次を満たすならば ~T ／ ~ELSE_ ~F ］ ⇒ ［ %~target は`~node$である ］~AND［ %~target の`根$は`~shadow根$である ］ ◎ Let item-in-shadow-tree be false. ◎ If target is a node and its root is a shadow root, then set item-in-shadow-tree to true.
2. %~closed木の根？ ~LET ［ %~target は次を満たすならば ~T ／ ~ELSE_ ~F ］ ⇒ ［ `~shadow根$である ］~AND［ `~mode$sR ~EQ `closed^l ］ ◎ Let root-of-closed-tree be false. ◎ If target is a shadow root whose mode is "closed", then set root-of-closed-tree to true.
3. %~event の`経路$に次のようにされた新たな`構造体$を`付加する$ ⇒＃ `~item$evP ~SET %~target, `~shadow木~内？$evP ~SET %~shadow木~内？ `~target$evP ~SET %上書きする~target, `関係d~target$evP ~SET %関係d~target, `~closed木の根？$evP ~SET %~closed木の根？, `~touch~target~list$evP ~SET %~touch~target~list `~slotは~closed木~内？$evP ~SET %~slotは~closed木~内？ ◎ Append a new struct to event’s path whose item is target, item-in-shadow-tree is item-in-shadow-tree, target is targetOverride, relatedTarget is relatedTarget, touch target list is touchTargets, root-of-closed-tree is root-of-closed-tree, and slot-in-closed-tree is slot-in-closed-tree.

`~listenerを呼出す@ ときは、所与の ( %構造体, %~event, %相 ) に対し，次を走らす： ◎ To invoke, given a struct, event, phase, and an optional legacyOutputDidListenersThrowFlag, run these steps:

1. %~event の`~target$ ~SET ［ %~event の`経路$内の［ %構造体 または %構造体 に先行する構造体 ］のうち，［ `~target$evP ~NEQ ~NULL ］を満たすもののうち，最後の構造体 ］の`~target$evP ◎ Set event’s target to the target of the last struct in event’s path, that is either struct or preceding struct, whose target is non-null.
2. %~event の`関係d~target$ ~SET %構造体 の `関係d~target$evP ◎ Set event’s relatedTarget to struct’s relatedTarget.
3. %~event の`~touch~target~list$ ~SET %構造体 の`~touch~target~list$evP ◎ Set event’s touch target list to struct’s touch target list.
4. ~IF［ %~event の`伝播停止$f ~EQ ~ON ］ ⇒ ~RET ◎ If event’s stop propagation flag is set, then return.
5. %~event の $currentTarget 属性 ~SET %構造体 の`~item$evPに初期化する ◎ Initialize event’s currentTarget attribute to struct’s item.

6. %~listener~list ~LET %構造体 の`~item$evPの`~event~listener~list$を`~cloneする$ ◎ Let listeners be a clone of event’s currentTarget attribute value’s event listener list.

   注記： これは、この時点以降に追加された~event~listenerは，走らせないようにする。 除去については、 `removed$evL ~fieldに因り，依然として効果を及ぼすことに注意。 ◎ This avoids event listeners added after this point from being run. Note that removal still has an effect due to the removed field.

7. %見出された？ ~LET `~listenerを内部的に呼出す$( %~event, %~listener~list, %相 ) ◎ Let found be the result of running inner invoke with event, listeners, phase, and legacyOutputDidListenersThrowFlag if given.

8. ~IF［ %見出された？ ~EQ ~F ］~AND［ %~event の $isTrusted 属性 ~EQ ~T ］~AND［ %~event の $type 属性~値は［ 下の表の 1 列目に挙げるいずれかの文字列 ］に `~ASCII大小無視$で合致する ］…： ◎ If found is false and event’s isTrusted attribute is true, then: ◎ Let originalEventType be event’s type attribute value. ◎ If event’s type attribute value is a match for any of the strings in the first column in the following table, set event’s type attribute value to the string in the second column on the same row as the matching string, and return otherwise.

   ~event型◎ Event type	旧来の~event型◎ Legacy event type
   `animationend^l	`webkitAnimationEnd^l
   `animationiteration^l	`webkitAnimationIteration^l
   `animationstart^l	`webkitAnimationStart^l
   `transitionend^l	`webkitTransitionEnd^l

   …ならば：

   1. %元の~event型 ~LET %~event の $type 属性~値 ◎ ↑
   2. %~event の $type 属性 ~SET 合致した行の 2 列目に与える文字列 ◎ ↑
   3. `~listenerを内部的に呼出す$( %~event, %~listener~list, %相 ) ◎ Inner invoke with event, listeners, phase, and legacyOutputDidListenersThrowFlag if given.
   4. %~event の $type 属性 ~SET %元の~event型 ◎ Set event’s type attribute value to originalEventType.

`~listenerを内部的に呼出す@ ときは、所与の ( %~event, %~listener~list, %相 ) に対し，次を走らす： ◎ To inner invoke, given an event, listeners, phase, and an optional legacyOutputDidListenersThrowFlag, run these steps:

1. %見出された？ ~LET ~F ◎ Let found be false.

2. %~listener~list 内の ~EACH( `~event~listener$ %~listener ) に対し： ◎ For each listener in listeners, whose removed is false:

   1. ~IF［ %~listener の `removed$evL ~EQ ~T ］ ⇒ ~CONTINUE ◎ ↑
   2. ~IF［ %~listener の `type$evL ~NEQ %~event の $type 属性~値 ］ ⇒ ~CONTINUE ◎ If event’s type attribute value is not listener’s type, then continue.
   3. %見出された？ ~SET ~T ◎ Set found to true.
   4. ~IF［ %相 ~EQ `capturing^l ］~AND［ %~listener の `capture$evL ~EQ ~F ］ ⇒ ~CONTINUE ◎ If phase is "capturing" and listener’s capture is false, then continue.
   5. ~IF［ %相 ~EQ `bubbling^l ］~AND［ %~listener の `capture$evL ~EQ ~T ］ ⇒ ~CONTINUE ◎ If phase is "bubbling" and listener’s capture is true, then continue.
   6. ~IF［ %~listener の `once$evL ~EQ ~T ］ ⇒ %~event の $currentTarget 属性~値の`~event~listener~list$から %~listener を`除去する$ ◎ If listener’s once is true, then remove listener from event’s currentTarget attribute value’s event listener list.
   7. %大域 ~LET %~listener の `callback$evL が`属する~Realm$の`大域~obj$rM ◎ Let global be listener callback’s associated Realm’s global object.
   8. %現在の~event ~LET `undefined^c ◎ Let currentEvent be undefined.

   9. ~IF［ %大域 は $Window ~objである ］： ◎ If global is a Window object, then:

      1. %現在の~event ~SET %大域 の`現在の~event$ ◎ Set currentEvent to global’s current event.
      2. ~IF［ %構造体 の`~shadow木~内？$evP ~EQ ~F ］ ⇒ %大域 の`現在の~event$ ~SET %~event ◎ If struct’s item-in-shadow-tree is false, then set global’s current event to event.
   10. ~IF［ %~listener の `passive$evL ~EQ ~T ］ ⇒ %~event の`受動~listener内$f ~SET ~ON ◎ If listener’s passive is true, then set event’s in passive listener flag.

   11. 次を与える下で，`利用元~objの演算を~callする$ ⇒＃ %~listener の `callback$evL, `handleEvent^l, « %~event », %~event の$currentTarget 属性~値 ◎ Call a user object’s operation with listener’s callback, "handleEvent", « event », and event’s currentTarget attribute value.＼

       ~callした結果，例外が投出されたときは、~catchして： ◎ If this throws an exception, then:

       1. `その例外を報告する$ ◎ Report the exception.
       2. ~IF［ この手続きを呼出した`配送-$手続きにて `旧来の（~listenerは投出したか？）~flag$V は与えられている ］ ⇒ `旧来の（~listenerは投出したか？）~flag$V ~SET ~ON ◎ Set legacyOutputDidListenersThrowFlag if given.

       注記： この~flagは、 Indexed Database API `INDEXEDDB$r のみに利用される。 ◎ The legacyOutputDidListenersThrowFlag is only used by Indexed Database API. [INDEXEDDB]

   12. %~event の`受動~listener内$f ~SET ~OFF ◎ Unset event’s in passive listener flag.
   13. ~IF［ %大域 は $Window ~objである ］ ⇒ %大域 の`現在の~event$ ~SET %現在の~event ◎ If global is a Window object, then set global’s current event to currentEvent.
   14. ~IF［ %~event の`伝播即停止$f ~EQ ~ON ］ ⇒ ~RET %見出された？ ◎ If event’s stop immediate propagation flag is set, then return found.
3. ~RET %見出された？ ◎ Return found.

2.10. ~eventの発火-法

1. %~event ~LET `~eventを作成する$( %~event構築子, %~target に`関連する~Realm$ ) ◎ Let event be the result of creating an event given eventConstructor, in the relevant Realm of target.
2. %~event の $type 属性 ~SET %e に初期化する ◎ Initialize event’s type attribute to e.

3. %~event の各種~IDL属性を %記述 に従って初期化する ◎ Initialize any other IDL attributes of event as described in the invocation of this algorithm.

   注記： ここでは［ $isTrusted 属性 ~SET ~F ］にすることも許容される。 ◎ This also allows for the isTrusted attribute to be set to false.

   【 この手続きを利用している他の仕様には、~IDL属性の他にも，~eventの各種~flag（ `~composed$f など）を初期化する記述を含んでいるものもある。 】

4. ~RET %~event を%~target に向けて`配送-$する( %旧来の~targetを上書きする~flag ) ◎ Return the result of dispatching event at target, with legacy target override flag set if set.

注記： ~DOMの文脈における “`~eventを発火する$” とは、`~event$を［ 作成-して, 初期化して, `配送-$する ］ことの略語であり，この処理過程を記述し易くするものである。 ◎ Fire in the context of DOM is short for creating, initializing, and dispatching an event. Fire an event makes that process easier to write down.

2.11. 動作 vs. 発生

`~event$は、動作（ `action^en ）ではなく，発生（ `occurrence^en ）をしるす（ `signify^en する）ものである。 言葉を代えれば、~algoからの通知を表現し，その~algoの進路に（例えば $preventDefault() を呼出すことを通して）波及させるために利用できるものである。 `~event$は、何らかの~algoを走らすような［ 動作, あるいは動作を起動するもの ］として利用されてはナラナイ。 そのような用途のためのものではない。 ◎ An event signifies an occurrence, not an action. Phrased differently, it represents a notification from an algorithm and can be used to influence the future course of that algorithm (e.g., through invoking preventDefault()). Events must not be used as actions or initiators that cause some algorithm to start running. That is not what they are for.

注記： ここで特に~~強調している~~理由は、以前の~DOMでは，`~event$に “既定~動作” の概念が結付けられていて，人を誤った考えに~~導いていたからである。 `~event$は、動作を表現したり, 生じさせるものではなく，進行中の何かに波及させるために限り利用できるものである。 ◎ This is called out here specifically because previous iterations of the DOM had a concept of "default actions" associated with events that gave folks all the wrong ideas. Events do not represent or cause actions, they can only be used to influence an ongoing one.

3.1. ^@AbortController ~ifc

%controller = new $AbortController()

新たな %controller を，その $signal を［ 新たな $AbortSignal ~obj ］に設定した上で返す。 ◎ Returns a new controller whose signal is set to a newly created AbortSignal object.

%controller . $signal

この~objに結付けられている $AbortSignal ~objを返す。 ◎ Returns the AbortSignal object associated with this object.

%controller . $abort()

この~methを呼出すと、この~objの $AbortSignal の`中止-済み~flag$aBを設定した上で、結付けられている活動が中止されることになるよう，~obたちにも通達することになる。 ◎ Invoking this method will set this object’s AbortSignal's aborted flag and signal to any observers that the associated activity is to be aborted.

各 $AbortController ~objには、 `通達@aB （ $AbortSignal ~obj）が結付けられる。 ◎ An AbortController object has an associated signal (an AbortSignal object).

@AbortController()

この構築子の被呼出時には、次のようにされた，新たな $AbortController ~objを返すモノトスル ⇒ `通達$aB ~SET 新たな $AbortSignal ~obj ◎ The AbortController() constructor, when invoked, must run these steps: • Let signal be a new AbortSignal object. • Let controller be a new AbortController object whose signal is signal. • Return controller.

@signal

取得子は、此れの`通達$aBを返すモノトスル。 ◎ The signal attribute’s getter, when invoked, must return the context object’s signal.

@abort()

被呼出時には、次を走らすモノトスル ⇒ `中止-を通達する$( 此れの`通達$aB ) ◎ The abort() method, when invoked, must signal abort on the context object’s signal.

3.2. ^@AbortSignal ~ifc

%signal . $aborted

この $AbortSignal の $AbortController が，中止するよう通達されて［ いれば ~T ／ いなければ ~F ］を返す。 ◎ Returns true if this AbortSignal's AbortController has signaled to abort, and false otherwise.

各 $AbortSignal ~objには、次のものが結付けられる：

`中止-済み~flag@aB

他が指定されない限り， ~OFF とする。 ◎ An AbortSignal object has an associated aborted flag. It is unset unless specified otherwise.

`中止する~algoたち@aB

何個かの~algoからなる`有順序~集合$。 他が指定されない限り，空とする。 これらの~algoは、［ `中止-済み~flag$aB ~SET ~ON ］にされたとき，実行されることになる。 ◎ An AbortSignal object has associated abort algorithms, which is a set of algorithms which are to be executed when its aborted flag is set. Unless specified otherwise, its value is the empty set.

【 集合なので，同じ~algoは重ねて現れ得ないことになるが、 “同じ” がどう定義されるかは， “`通達に~algoを追加する$” を利用する他の仕様を見ないとはっきりしない。 】

`通達に~algoを追加する@ ときは、所与の ( $AbortSignal ~obj %通達, ~algo %~algo ) に対し，次を走らす： ◎ To add an algorithm algorithm to an AbortSignal object signal, run these steps:

1. ~IF［ %通達 の`中止-済み~flag$aB ~EQ ~ON ］ ⇒ ~RET ◎ If signal’s aborted flag is set, then return.
2. %通達 の`中止する~algoたち$aBに %~algo を`付加する$set ◎ Append algorithm to signal’s abort algorithms.

`通達から~algoを除去する@ ときは、所与の ( $AbortSignal ~obj %通達, ~algo %A ) に対し ⇒ %通達 の`中止する~algoたち$aBから %A を`除去する$ ◎ To remove an algorithm algorithm from an AbortSignal signal, remove algorithm from signal’s abort algorithms.

注記： `中止する~algoたち$aBは、 $abort() に対し適度な仕方で反応するような，複階的な要件を伴う~APIを可能化する。 例えば，所与の~APIの`中止-済み~flag$aBは、~swなどの別~thread環境へ伝播される必要があるかもしれない。 ◎ The abort algorithms enable APIs with complex requirements to react in a reasonable way to abort(). For example, a given API’s aborted flag might need to be propagated to a cross-thread environment, such as a service worker.

@aborted

取得子は、此れの`中止-済み~flag$aBに応じて，次を返すモノトスル ⇒＃ ~ON ならば ~T ／ ~OFF ならば ~F ◎ The aborted attribute’s getter, when invoked, must return true if the context object’s aborted flag is set, and false otherwise.

注記： $AbortSignal ~objに対する変化は，対応している $AbortController ~objの望みを表現するが、 $AbortSignal ~objを観測している~APIは，それを無視することも選べる — 一例として、演算がすでに完了していた場合など。 ◎ Changes to an AbortSignal object represent the wishes of the corresponding AbortController object, but an API observing the AbortSignal object can chose to ignore them. For instance, if the operation has already completed.

`中止-を通達する@ ときは、所与の ( $AbortSignal ~obj %通達 ) に対し，次を走らす： ◎ To signal abort, given a AbortSignal object signal, run these steps:

1. ~IF［ %通達 の`中止-済み~flag$aB ~EQ ~ON ］ ⇒ ~RET ◎ If signal’s aborted flag is set, then return.
2. %通達 の`中止-済み~flag$aB ~SET ~ON ◎ Set signal’s aborted flag.
3. %通達 の`中止する~algoたち$aB内の ~EACH( %~algo ) に対し ⇒ %~algo を走らす ◎ For each algorithm in signal’s abort algorithms: run algorithm.
4. %通達 の`中止する~algoたち$aBを`空にする$ ◎ Empty signal’s abort algorithms.
5. %通達 に向けて名前 `abort^et の`~eventを発火する$ ◎ Fire an event named abort at signal.

`通達に追従させる@ ときは、所与の ( $AbortSignal %追従する通達, $AbortSignal %親~通達 ) に対し，次の手続きを走らす： ◎ A followingSignal (an AbortSignal) is made to follow a parentSignal (an AbortSignal) by running these steps:

1. ~IF［ %追従する通達 の`中止-済み~flag$aB ~EQ ~ON ］ ⇒ ~RET ◎ If followingSignal’s aborted flag is set, then return.
2. ~IF［ %親~通達 の`中止-済み~flag$aB ~EQ ~ON ］ ⇒＃ `中止-を通達する$( %追従する通達 )； ~RET ◎ If parentSignal’s aborted flag is set, then signal abort on followingSignal.

3. `通達に~algoを追加する$( %親~通達, 次に与える中止-手続き )： ◎ Otherwise, add the following abort steps to parentSignal:

   1. `中止-を通達する$( %追従する通達 ) ◎ Signal abort on followingSignal.

3.3. ~APIにおける ^AbortController, ^AbortSignal ~objの用法

中止できる演算を表現する~promiseを利用している~web~platform~APIは、次を固守するモノトスル： ◎ Any web platform API using promises to represent operations that can be aborted must adhere to the following:

• ^signal `辞書~member$を通して， $AbortSignal ~objを受容すること。 ◎ Accept AbortSignal objects through a signal dictionary member.
• 演算が中止されたときは、 `AbortError$E 例外で~promiseを却下することにより，それを~~伝えること。 ◎ Convey that the operation got aborted by rejecting the promise with an "AbortError" DOMException.

• $AbortSignal の`中止-済み~flag$aBに応じて：

  • すでに ~ON の場合： 即時に却下すること。 ◎ Reject immediately if the AbortSignal's aborted flag is already set, otherwise:
  • 他の場合： $AbortSignal ~objの変化を観測するときは、`中止する~algoたち$aBによる仕組みを，他の~obと衝突し得ない方式で利用すること。 ◎ Use the abort algorithms mechanism to observe changes to the AbortSignal object and do so in a manner that does not lead to clashes with other observers.

~promiseを利用していない~APIであっても、アリな限り，上述を固守するべきである。 ◎ APIs not using promises should still adhere to the above as much as possible.

4.1. ~DOM序論

~DOM（ “The DOM（ Document Object Model ）” ）は元々，文書（特に，~HTML文書や~XML文書）に~accessして操作するための~APIを意味するものであったが、この仕様における語 “文書” は、短い静的な文書から 多彩な~multimediaを伴う長い小論や報告書，更には本格的な対話的~appまでに渡る、任意の~markupに基づく資源を指すものとして用いられる。 ◎ In its original sense, "The DOM" is an API for accessing and manipulating documents (in particular, HTML and XML documents). In this specification, the term "document" is used for any markup-based resource, ranging from short static documents to long essays or reports with rich multimedia, as well as to fully-fledged interactive applications.

そのような各~文書は、`~node木$として表現される。 `木$を成す`~node$のうち一部は 他の`~node$を`子$に持ち，他のものは葉（末端）~nodeになる。 ◎ Each such document is represented as a node tree. Some of the nodes in a tree can have children, while others are always leaves.

<!DOCTYPE html>
<html class=e>
 <head><title>Aliens?</title></head>
 <body>Why yes.</body>
</html>

`~HTML構文解析器$の~~仕組みから，すべての`~ASCII空白$が $Text `~node$にされてはいないが、一般~概念は明らかである。 ~~入力の~markupから，`~node$たちが成す`木$が出来上がる。 ◎ Note that, due to the magic that is HTML parsing, not all ASCII whitespace were turned into Text nodes, but the general concept is clear. Markup goes in, a tree of nodes comes out.

注記： さらに探求してみたければ、最高によくできている Live DOM Viewer を利用するといい。 ◎ The most excellent Live DOM Viewer can be used to explore this matter in more detail.

4.2. ~node木

`~node木$には、`~node$の型とそれに許容される`子$との関係性で表出される，次の拘束が課される： ◎ A node tree is constrained as follows, expressed as a relationship between the type of node and its allowed children:

$Document

`木~順序$において，次からなる： ◎ In tree order:

1. それぞれが $ProcessingInstruction または $Comment である， 0 個以上の~node ◎ Zero or more nodes each of which is ProcessingInstruction or Comment.
2. 0 個または 1 個の $DocumentType ~node ◎ Optionally one DocumentType node.
3. 0 個または 1 個の $Element ~node ◎ Optionally one Element node.

$DocumentFragment

$Element

それぞれが $Element, $ProcessingInstruction, $Comment, $Text のいずれかである， 0 個以上の~nodeからなる ◎ Zero or more nodes each of which is Element, Text, ProcessingInstruction, or Comment.

$DocumentType

$Text

$ProcessingInstruction

$Comment

子を持たない ◎ None.

`~node$ %node の `長さ@ とは、 %node に応じて，次で与えられる整数である： ◎ To determine the length of a node node, switch on node:

$DocumentType

0 ◎ Zero.

`文字~data~node$ ◎ Text, ProcessingInstruction, Comment

その`~data$の`長さ$jStr ◎ Its data’s length.

$Document

$DocumentFragment

$Element

その`子$の個数 ◎ Its number of children.

`~node$が `空@node であるとは、［ その`長さ$ ~EQ 0 ］を意味する。 【この訳では、この用語は利用しない — ほぼ利用されておらず，単に “長さ ~EQ 0” と記せば済むので。】 ◎ A node is considered empty if its length is zero.

4.3. 変異~ob

`変異~ob 複合~小taskを~queueする@ ときは、次を走らす： ◎ To queue a mutation observer compound microtask, run these steps:

1. ~IF［ `変異~ob 複合~小task~queue済み$f ~EQ ~ON ］ ⇒ ~RET ◎ If mutation observer compound microtask queued flag is set, then return.
2. `変異~ob 複合~小task~queue済み$f ~SET ~ON ◎ Set mutation observer compound microtask queued flag.
3. 次に与える`小taskを~queueする$ ⇒ 次を走らす`複合~小task$ ⇒ `変異~obに通知する$ ◎ Queue a compound microtask to notify mutation observers.

`変異~obに通知する@ ときは、次を走らす： ◎ To notify mutation observers, run these steps:

1. `変異~ob 複合~小task~queue済み$f ← ~OFF ◎ Unset mutation observer compound microtask queued flag.
2. %通知-集合 ~LET `~surrounding~agent$の`変異~obたち$を`~cloneする$ ◎ Let notifySet be a clone of the surrounding agent’s mutation observers.
3. %通達~slot集合 ~LET `~surrounding~agent$の`通達~slotたち$を`~cloneする$ ◎ Let signalSet be a clone of the surrounding agent’s signal slots.
4. `~surrounding~agent$の`通達~slotたち$を`空にする$ ◎ Empty the surrounding agent’s signal slots.

5. %通知-集合 を成す ~EACH( %MO ) に対し ⇒ 次の手続きを走らす`複合~小task下位~taskを実行する$ `HTML$r ： ◎ For each mo of notifySet, execute a compound microtask subtask to run these steps: [HTML]

   1. %記録たち ~LET %MO の`記録~queue$moを`~cloneする$ ◎ Let records be a clone of mo’s record queue.
   2. %MO の`記録~queue$moを`空にする$ ◎ Empty mo’s record queue.
   3. %MO の`~node~list$mo内の ~EACH( %~node ) に対し ⇒ %~node の`登録-済み~ob~list$から 次を満たす`一時~登録-済み~ob$をすべて`除去する$ ⇒ その`~ob$ob ~EQ %MO ◎ For each node of mo’s node list, remove all transient registered observers whose observer is mo from node’s registered observer list.
   4. ~IF［ %記録たち は`空$でない ］ ⇒ `~callback関数を呼出す$( %MO の`~callback$mo, « %記録たち, %MO », %MO ) ⇒ 例外が投出されたときは、~catchして ⇒ `その例外を報告する$ ◎ If records is not empty, then invoke mo’s callback with « records, mo », and mo. If this throws an exception, then report the exception.
6. %通達~slot集合 を成す ~EACH( `~slot$ %~slot ) に対し ⇒ %~slot に向けて名前 `slotchange^et の, 次のように初期化される`~eventを発火する$ ⇒ $Event.bubbles 属性 ~SET ~T ◎ For each slot of signalSet, fire an event named slotchange, with its bubbles attribute set to true, at slot.

各 `~node$には、 `登録-済み~ob~list@ が結付けられる — それは、 0 個~以上の`登録-済み~ob$からなる`~list$であり，初期~時には空とする。 【この~nodeにおける変異を観測している~obたちを表す。】 ◎ Each node has a registered observer list (a list of zero or more registered observers), which is initially empty.

注記： `一時~登録-済み~ob$は、所与の`~node$に対し，それが除去された後も`~node$の`子孫$における変異を追跡するために利用される — これにより、`~node$の`親$にて $MutationObserverInit.subtree が ~T に設定されているときでも，それらの変異は失われずに済む。 ◎ Transient registered observers are used to track mutations within a given node’s descendants after node has been removed so they do not get lost when subtree is set to true on node’s parent.

4.4. ^@Node ~ifc

注記： $@Node は抽象~ifcであり，`~node$として存在することはない。 それは、すべての`~node$（ $Document, $DocumentType, $DocumentFragment, $Element, $Text, $ProcessingInstruction, $Comment ）から利用される。 ◎ Node is an abstract interface and does not exist as node. It is used by all nodes (Document, DocumentType, DocumentFragment, Element, Text, ProcessingInstruction, and Comment).

【 $Attr も $Node を継承しているが、定義により，木には`関与-$しないことに注意。 （ “^Attr `~node$” という語も何箇所かに現れていて紛らわしいが。） 】

注記： `~node$の`~node文書$は、`~nodeを受入する$~algoにより変更され得る。 ◎ A node’s node document can be changed by the adopt algorithm.

【 ~nodeが`文書~木~内$になくても，結付けられることになる。 】

`~node$ %node の`親~targetを取得する$ときは、［ %node の`割当先~slot$ ~NEQ ~NULL ならば それ ／ ~ELSE_ %node の`親$ ］を返す。 ◎ A node’s get the parent algorithm, given an event, returns the node’s assigned slot, if node is assigned, and node’s parent otherwise.

【 `文書$は、~nodeの`親~targetを取得する$~algoを上書きする。 】

%node . $nodeType

次に挙げる数で表現される, %node の型を返す： ◎ Returns the type of node, represented by a number from the following list:

$Node . $ELEMENT_NODE `(1)^i

%node は`要素$である。 ◎ node is an element.

$Node . $TEXT_NODE `(3)^i

%node は $Text `~node$である。 ◎ node is a Text node.

$Node . $CDATA_SECTION_NODE `(4)^i

%node は $CDATASection `~node$である。 ◎ node is a CDATASection node.

$Node . $PROCESSING_INSTRUCTION_NODE `(7)^i

%node は $ProcessingInstruction `~node$である。 ◎ node is a ProcessingInstruction node.

$Node . $COMMENT_NODE `(8)^i

%node は $Comment `~node$である。 ◎ node is a Comment node.

$Node . $DOCUMENT_NODE `(9)^i

%node は`文書$である。 ◎ node is a document.

$Node . $DOCUMENT_TYPE_NODE `(10)^i

%node は`~doctype$である。 ◎ node is a doctype.

$Node . $DOCUMENT_FRAGMENT_NODE `(11)^i

%node は`文書片$である。 ◎ node is a DocumentFragment node.

%node . $nodeName

%node に応じて，次の文字列を返す： ◎ Returns a string appropriate for the type of node, as follows:

$Element

その`~HTML大文字~化~有修飾~名$ ◎ Its HTML-uppercased qualified name.

$Attr

その`有修飾~名$a ◎ Its qualified name.

$Text

`#text^l ◎ "#text".

$CDATASection

`#cdata-section^l ◎ "#cdata-section".

$ProcessingInstruction

その $target ◎ Its target.

$Comment

`#comment^l ◎ "#comment".

$Document

`#document^l ◎ "#document".

$DocumentType

その`名前$dT ◎ Its name.

$DocumentFragment

`#document-fragment^l ◎ "#document-fragment".

@nodeType

取得子は、此れに応じて，次を返すモノトスル（括弧内は数-値）： ◎ The nodeType attribute’s getter, when invoked, must return the first matching statement, switching on the context object:

$Element

@ELEMENT_NODE (1)

$Attr

@ATTRIBUTE_NODE (2)

$Text

@TEXT_NODE (3)

$CDATASection

@CDATA_SECTION_NODE (4)

$ProcessingInstruction

@PROCESSING_INSTRUCTION_NODE (7)

$Comment

@COMMENT_NODE (8)

$Document

@DOCUMENT_NODE (9)

$DocumentType

@DOCUMENT_TYPE_NODE (10)

$DocumentFragment

@DOCUMENT_FRAGMENT_NODE (11)

@nodeName

取得子は、此れに応じて，次を返すモノトスル： ◎ The nodeName attribute’s getter, when invoked, must return the first matching statement, switching on the context object:

$Element

此れの`~HTML大文字~化~有修飾~名$ ◎ Its HTML-uppercased qualified name.

$Attr

此れの`有修飾~名$a ◎ Its qualified name.

$Text

`#text^l ◎ "#text".

$CDATASection

`#cdata-section^l ◎ "#cdata-section".

$ProcessingInstruction

此れの`~target$pI ◎ Its target.

$Comment

`#comment^l ◎ "#comment".

$Document

`#document^l ◎ "#document".

$DocumentType

此れの`名前$dT ◎ Its name.

$DocumentFragment

`#document-fragment^l ◎ "#document-fragment".

%node . $baseURI

%node の`~node文書$の`文書~基底~URL$を返す。 ◎ Returns node’s node document’s document base URL.

@baseURI

取得子は、次を走らせた結果を返すモノトスル ⇒ `~URLを直列化する$( 此れの`~node文書$の`文書~基底~URL$ ) ◎ The baseURI attribute’s getter must return node document’s document base URL, serialized.

%node . $isConnected

［ %node は`接続されて$いるならば ~T ／ ~ELSE_ ~F ］を返す。 ◎ Returns true if node is connected and false otherwise.

%node . $ownerDocument

`~node文書$を返す。 `文書$に対しては ~NULL を返す。 ◎ Returns the node document. Returns null for documents.

%node . $getRootNode()

%node の`根$を返す。 ◎ Returns node’s root.

%node . $getRootNode({ composed:true })

%node の`~shadowも含む根$を返す。 ◎ Returns node’s shadow-including root.

%node . $parentNode

`親$を返す。 ◎ Returns the parent.

%node . $parentElement

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

%node . $hasChildNodes()

%node が`子$を持っているかどうかを返す。 ◎ Returns whether node has children.

%node . $childNodes

すべての`子$を返す。 ◎ Returns the children.

%node . $firstChild

`最初の子？$を返す。 ◎ Returns the first child.

%node . $lastChild

`最後の子？$を返す。 ◎ Returns the last child.

%node . $previousSibling

`前-同胞？$を返す。 ◎ Returns the previous sibling.

%node . $nextSibling

`次-同胞？$を返す。 ◎ Returns the next sibling.

@isConnected

取得子は、［ 此れは次を満たすならば ~T ／ ~ELSE_ ~F ］を返すモノトスル ⇒ `接続されて$いる ◎ The isConnected attribute’s getter must return true, if context object is connected, and false otherwise.

@ownerDocument

取得子は、［ 此れは`文書$である ならば ~NULL ／ ~ELSE_ 此れの`~node文書$ ］を返すモノトスル。 ◎ The ownerDocument attribute’s getter must return null, if the context object is a document, and the context object’s node document otherwise.

注記： `文書$の`~node文書$は，`文書$ 自身である。 すべての`~node$は、どの時点であれ，`~node文書$を持つ。 ◎ The node document of a document is that document itself. All nodes have a node document at all times.

@getRootNode(options)

被呼出時には、［［ %options の $GetRootNodeOptions.composed ~EQ ~T ］ならば 此れの`~shadowも含む根$ ／ ~ELSE_ 此れの`根$ ］を返すモノトスル。 ◎ The getRootNode(options) method, when invoked, must return context object’s shadow-including root if options’s composed is true, and context object’s root otherwise.

@parentNode

取得子は、此れの`親$を返すモノトスル。 ◎ The parentNode attribute’s getter must return the context object’s parent.

注記： $Attr `~node$には親はない。 ◎ An Attr node has no parent.

@parentElement

取得子は、此れの`親~要素$を返すモノトスル。 ◎ The parentElement attribute’s getter must return the context object’s parent element.

@hasChildNodes()

被呼出時には、［ 此れは次を満たすならば ~T ／ ~ELSE_ ~F ］を返すモノトスル ⇒ `子$を持つ ◎ The hasChildNodes() method, when invoked, must return true if the context object has children, and false otherwise.

@childNodes

取得子は、次のようにされた $NodeList `~collection$を返すモノトスル ⇒＃ `根$cL ~SET 此れ, `~filter$cLは 此れの`子$のみに合致する ◎ The childNodes attribute’s getter must return a NodeList rooted at the context object matching only children.

@firstChild

取得子は、此れの`最初の子？$を返すモノトスル。 ◎ The firstChild attribute’s getter must return the context object’s first child.

@lastChild

取得子は、此れの`最後の子？$を返すモノトスル。 ◎ The lastChild attribute’s getter must return the context object’s last child.

@previousSibling

取得子は、此れの`前-同胞？$を返すモノトスル。 ◎ The previousSibling attribute’s getter must return the context object’s previous sibling.

注記： $Attr `~node$には`同胞$はない。 ◎ An Attr node has no siblings.

@nextSibling

取得子は、此れの`次-同胞？$を返すモノトスル。 ◎ The nextSibling attribute’s getter must return the context object’s next sibling.

@nodeValue

取得子は、此れに応じて，次を返すモノトスル： ◎ The nodeValue attribute must return the following, depending on the context object:

$Attr

此れの`値$a ◎ Context object’s value.

`文字~data~node$ ◎ Text, ProcessingInstruction, Comment

此れの`~data$ ◎ Context object’s data.

他の~node

~NULL

設定子は、次を走らすモノトスル： ◎ The nodeValue attribute must, on setting,＼

1. %値 ~LET ［ 所与の値 ~NEQ ~NULL ならば それ ／ ~ELSE_ 空~文字列 ］ ◎ if the new value is null, act as if it was the empty string instead, and then＼

2. 此れに応じて： ◎ do as described below, depending on the context object:

   $Attr

   `既存の属性o値を設定する$( 此れ, %値 ) ◎ Set an existing attribute value with context object and new value.

   `文字~data~node$ ◎ Text, ProcessingInstruction, Comment

   此れの`~dataを置換する$( 0, 此れの`長さ$, %値 ) ◎ Replace data with node context object, offset 0, count context object’s length, and data new value.

   他の~node

   何もしない ◎ Do nothing.

@textContent

取得子は、此れに応じて，次を返すモノトスル： ◎ The textContent attribute’s getter must return the following, switching on context object:

$DocumentFragment

$Element

次を`連結-$した結果 ⇒ `木~順序$による，此れのすべての $Text `~node$`子孫$の`~data$ ◎ The concatenation of data of all the Text node descendants of the context object, in tree order.

$Attr

此れの`値$a ◎ Context object’s value.

`文字~data~node$ ◎ Text, ProcessingInstruction, Comment

此れの`~data$ ◎ Context object’s data.

$Document

$DocumentType

~NULL ◎ Null.

設定子は、次を走らすモノトスル： ◎ The textContent attribute’s setter must,＼

1. %値 ~LET ［ 所与の値 ~NEQ ~NULL ならば それ ／ ~ELSE_ 空~文字列 ］ ◎ if the given value is null, act as if it was the empty string instead, and then＼

2. 此れに応じて： ◎ do as described below, switching on context object:

   $DocumentFragment

   $Element

   1. %node ~LET ~NULL ◎ Let node be null.
   2. ~IF［ %値 ~NEQ 空~文字列 ］ ⇒ %node ~SET `新たな~Text~node$( %値, 此れの`~node文書$ ) ◎ If the given value is not the empty string, set node to a new Text node whose data is the given value and node document is context object’s node document.
   3. 此れの`全~内容を~nodeで置換する$( %node ) ◎ Replace all with node within the context object.

   $Attr

   `既存の属性o値を設定する$( 此れ, 所与の値 ) ◎ Set an existing attribute value with context object and new value.

   `文字~data~node$ ◎ Text, ProcessingInstruction, Comment

   此れの`~dataを置換する$( 0, 此れの`長さ$, %値 ) ◎ Replace data with node context object, offset 0, count context object’s length, and data the given value.

   $Document

   $DocumentType

   何もしない ◎ Do nothing.

%node . $normalize()

%node に含まれている`狭義の~Text~node$のうち［ `長さ$ ~EQ 0 ］のものは除去し、`連続的な狭義の~Text~node列$に対しては，その最初の`~node$に~~後続の`~data$を連結してひとまとめにする。 ◎ Removes empty exclusive Text nodes and concatenates the data of remaining contiguous exclusive Text nodes into the first of their nodes.

【 この記述は、 “除去-” と “連結-” の順序に関し，微妙に正確でない — 実際の~algoでは、空 ^Text ~nodeのうち，［ 最初の~node %N が空でないような`連続的な狭義の~Text~node列$ ］に含まれるものは、後続の空 ^Text ~nodeより先に %N に連結される（その結果として，除去されるが）。 】

@normalize()

被呼出時には、次を走らすモノトスル： ◎ The normalize() method, when invoked, must run these steps＼

1. 此れの`子孫$である ~EACH( `狭義の~Text~node$ %node ) に対し： ◎ for each descendant exclusive Text node node of context object:

   【 木~順序で。 加えて，~~厳密に言えば、このループの中で木から除去される ^Text ~nodeは反復対象から除外する必要もある。 】

   1. %長さ ~LET %node の`長さ$ ◎ Let length be node’s length.
   2. %長さ ~EQ 0 ⇒＃ %node の`親$から`子を除去する$( %node )； ~CONTINUE ◎ If length is zero, then remove node and continue with the next exclusive Text node, if any.
   3. %除去対象 ~LET %node を含む`連続的な狭義の~Text~node列$から %node 自身（常に先頭になる）は除外した結果の~list ◎ ↓
   4. %data ~LET 次を`連結-$した結果 ⇒ %除去対象 内のすべての~nodeの`~data$ ◎ Let data be the concatenation of the data of node’s contiguous exclusive Text nodes (excluding itself), in tree order.
   5. %node の`~dataを置換する$( %長さ, 0, %data ) ◎ Replace data with node node, offset length, count 0, and data data.

   6. %除去対象 内の ~EACH( %text ) に対し，順に： ◎ Let currentNode be node’s next sibling. ◎ While currentNode is an exclusive Text node:

      1. ~EACH( `~live範囲o$ %R ) に対し： ◎ ↓

         1. ~IF［ %範囲o の`始端~node$ ~EQ %text ］ ⇒＃ %範囲o の`始端~offset$ ~INCBY %長さ； %範囲o の`始端~node$ ~SET %node ◎ For each live range whose start node is currentNode, add length to its start offset and set its start node to node.
         2. ~IF［ %範囲o の`終端~node$ ~EQ %text ］ ⇒＃ %範囲o の`終端~offset$ ~INCBY %長さ； %範囲o の`終端~node$ ~SET %node ◎ For each live range whose end node is currentNode, add length to its end offset and set its end node to node.
         3. ~IF［ %範囲o の`始端~node$ ~EQ %text の`親$ ］~AND［ %範囲o の`始端~offset$ ~EQ %text の`指数$ ］ ⇒＃ %範囲o の`始端~node$ ~SET %node； %範囲o の`始端~offset$ ~SET %長さ ◎ For each live range whose start node is currentNode’s parent and start offset is currentNode’s index, set its start node to node and its start offset to length.
         4. ~IF［ %範囲o の`終端~node$ ~EQ %text の`親$ ］~AND［ %範囲o の`終端~offset$ ~EQ %text の`指数$ ］ ⇒＃ %範囲o の`終端~node$ ~SET %node； %範囲o の`終端~offset$ ~SET %長さ ◎ For each live range whose end node is currentNode’s parent and end offset is currentNode’s index, set its end node to node and its end offset to length.
      2. %長さ ~INCBY %text の`長さ$ ◎ Add currentNode’s length to length. ◎ Set currentNode to its next sibling.
   7. %除去対象 内の ~EACH( %text ) に対し，順に ⇒ %text の`親$から`子を除去する$( %text ) ◎ Remove node’s contiguous exclusive Text nodes (excluding itself), in tree order.

注記： $normalize() は`子~text内容~変更-時の手続き$を走らす必要はない。 それは $Text ~nodeたちを弄り倒すが，`子~text内容$は特に保全するように行うので。 ◎ normalize() does not need to run any child text content change steps, since although it messes with Text nodes extensively, it does so specifically in a way that preserves the child text content.

%node . $cloneNode([deep = false])

%node の複製を返す。 %deep が~T の場合、複製には %node の`子孫$も含められる。 ◎ Returns a copy of node. If deep is true, the copy also includes the node’s descendants.

%node . $isEqualNode(otherNode)

%node と %otherNode が同じ~propを持つかどうかを返す。 ◎ Returns whether node and otherNode have the same properties.

`適用-可能な仕様$は、すべてまたは一部の`~node$用に `~clone時の手続き@ を定義してもヨイ。 この~algoは、`~nodeを~cloneする$ ~algo内から， ( %複製, %node, %文書, %子も~cloneする~flag ~IN { `子も~cloneする^i, ε }（省略時は ε ） ) を渡して呼出される。 ◎ Specifications may define cloning steps for all or some nodes. The algorithm is passed copy, node, document, and an optional clone children flag, as indicated in the clone algorithm.

注記： ~HTMLは `script$e ／ `input$e 要素~用に`~clone時の手続き$を定義する。 ~SVGもその `script^e 要素~用にも同様にされるべきだが、現時点では，呼び出すことはない。 ◎ HTML defines cloning steps for script and input elements. SVG ought to do the same for its script elements, but does not call this out at the moment.

【 同じ~node用に，そのような手続きが（例えば，複数の仕様にて）複数~定義された場合、それらを走らす順序も有意になり得るが，言及されていないので想定されていないと思われる。 】

`~nodeを~cloneする@ ときは、所与の ( %node, `文書$ %文書 （省略時は ε ）, %子も~cloneする~flag ~IN { `子も~cloneする^i, ε }（省略時は ε ） ) に対し，次を走らす： ◎ To clone a node, with an optional document and clone children flag, run these steps:

1. ~IF［ %文書 ~EQ ε ］ ⇒ %文書 ~LET %node の`~node文書$ ◎ If document is not given, let document be node’s node document.

2. ~IF［ %node は`要素$である ］： ◎ If node is an element, then:

   1. %複製 ~LET `要素を作成する$( %文書, %node の`局所~名$, %node の`~ns$, %node の`~ns接頭辞$, %node の`~is0値$ ) ◎ Let copy be the result of creating an element, given document, node’s local name, node’s namespace, node’s namespace prefix, and node’s is value, with the synchronous custom elements flag unset.
   2. %node の`属性o~list$内の ~EACH( %属性o ) に対し ⇒ %複製 に`属性oを付加する$( `~nodeを~cloneする$( %属性o ) ) ◎ For each attribute in node’s attribute list: • Let copyAttribute be a clone of attribute. • Append copyAttribute to copy.

3. ~ELSE： ◎ Otherwise,＼

   1. %複製 ~LET %node と同じ~ifcを実装する新たな`~node$ ◎ let copy be a node that implements the same interfaces as node, and＼

   2. %node に応じて， %複製 を次に従って設定する： ◎ fulfills these additional requirements, switching on node:

      $Document

      %複製 の［ `符号化法$doc, `内容~型$doc, `~URL$doc, `生成元$doc, `種別$doc, `~mode$doc ］ ~SET %node のそれら ◎ Set copy’s encoding, content type, URL, origin, type, and mode, to those of node.

      $DocumentType

      %複製 の［ `名前$dT, `~publicID$dT, `~systemID$dT ］ ~SET %node のそれら ◎ Set copy’s name, public ID, and system ID, to those of node.

      $Attr

      %複製 の［ `~ns$a, `~ns接頭辞$a, `局所~名$a, `値$a ］ ~SET %node のそれら ◎ Set copy’s namespace, namespace prefix, local name, and value, to those of node.

      $Text

      $Comment

      %複製 の`~data$ ~SET %node のそれ ◎ Set copy’s data, to that of node.

      $ProcessingInstruction

      %複製 の［ `~target$pI, `~data$ ］ ~SET %node のそれら ◎ Set copy’s target and data to those of node.

      他の~node

      —

      【 すなわち， $DocumentFragment （ $ShadowRoot ）が該当するが、［ これらに対しこの~algoが呼出されることはない ］ことを意味すると思われる。 】

4. ~IF［ %複製 は`文書$である ］ ⇒ %文書 ~SET %複製 ◎ ↓
5. %複製 の`~node文書$ ~SET %文書 ◎ Set copy’s node document and document to copy, if copy is a document, and set copy’s node document to document otherwise.
6. ~IF［ 他の`適用-可能な仕様$において %node 用に定義されている`~clone時の手続き$がある ］ ⇒ その手続きに ( %複製, %node, %文書, `子も~cloneする^i ) を渡して走らす ◎ Run any cloning steps defined for node in other applicable specifications and pass copy, node, document and the clone children flag if set, as parameters.
7. ~IF［ %子も~cloneする~flag ~NEQ ε ］ ⇒ %node の ~EACH( `子$ %子 ) に対し 【木~順序で】 ⇒ %複製 に次を付加する ⇒ `~nodeを~cloneする$( %子, %文書, `子も~cloneする^i ) ◎ If the clone children flag is set, clone all the children of node and append them to copy, with document as specified and the clone children flag being set.
8. ~RET %複製 ◎ Return copy.

@cloneNode(deep)

被呼出時には、次を走らすモノトスル： ◎ The cloneNode(deep) method, when invoked, must run these steps:

1. ~IF［ 此れは`~shadow根$である ］ ⇒ ~THROW `NotSupportedError$E ◎ If context object is a shadow root, then throw a "NotSupportedError" DOMException.
2. ~RET `~nodeを~cloneする$( 此れ, ε, ［ %deep ~EQ ~T ならば `子も~cloneする^i ／ ~ELSE_ ε ］ ) ◎ Return a clone of the context object, with the clone children flag set if deep is true.

2 つの`~node$ %A, %B は、次に挙げるすべての条件を満たすならば， `同等@ であるとされる。 ◎ A node A equals a node B if all of the following conditions are true:

• %A と %B の $nodeType 属性~値は一致する。 ◎ A and B’s nodeType attribute value is identical.

• %A に応じて，次も同等： ◎ The following are also equal, depending on A:

  $DocumentType

  `名前$dT, `~publicID$dT, `~systemID$dT ◎ Its name, public ID, and system ID.

  $Element

  `~ns$, `~ns接頭辞$, `局所~名$, `属性o~list$の`~size$ ◎ Its namespace, namespace prefix, local name, and its attribute list’s size.

  $Attr

  `~ns$a, `局所~名$a, `値$a ◎ Its namespace, local name, and value.

  $ProcessingInstruction

  `~target$pI, `~data$ ◎ Its target and data.

  $Text

  $Comment

  `~data$ ◎ Its data.

  その他

  —

  【 すなわち，［ $Document, $DocumentFragment （ $ShadowRoot ） ］が該当するが、［ これらに対しこの~algoが呼出されることはない ］ことを意味すると思われる。 】

• %A が`要素$である場合に限り ⇒ %A が`有する$どの`属性o$ %属性 に対しても ⇒ %B は［ %属性 に`同等$である`属性o$ ］を`有する$ ◎ If A is an element, each attribute in its attribute list has an attribute that equals an attribute in B’s attribute list.
• %A と %B は同じ個数の`子$を持つ ◎ A and B have the same number of children.
• %A のどの`子$も，同じ`指数$に位置する %B の`子$に`同等$である ◎ Each child of A equals the child of B at the identical index.

@isEqualNode(otherNode)

被呼出時には、［ 次が満たされるならば ~T ／ ~ELSE_ ~F ］を返すモノトスル ⇒ ［ %otherNode ~NEQ ~NULL ］~AND［ 此れと %otherNode は`同等$である ］ ◎ The isEqualNode(otherNode) method, when invoked, must return true if otherNode is non-null and context object equals otherNode, and false otherwise.

@isSameNode(otherNode)

被呼出時には、［ 次が満たされるならば ~T ／ ~ELSE_ ~F ］を返すモノトスル ⇒ %otherNode ~EQ 此れ ◎ The isSameNode(otherNode) method, when invoked, must return true if otherNode is context object, and false otherwise.

%node . $compareDocumentPosition(other)

%node に相対的な %other の位置を指示する~bitmaskを返す。 それを成す各~bitは、対応する条件が満たされる場合には， “1” に設定される： ◎ Returns a bitmask indicating the position of other relative to node. These are the bits that can be set:

$Node . $DOCUMENT_POSITION_DISCONNECTED `(1)^i

%node と %other は同じ`木$に属さない。 ◎ Set when node and other are not in the same tree.

$Node . $DOCUMENT_POSITION_PRECEDING `(2)^i

%other は %node に`先行-$する。 ◎ Set when other is preceding node.

$Node . $DOCUMENT_POSITION_FOLLOWING `(4)^i

%other は %node に`後続-$する。 ◎ Set when other is following node.

$Node . $DOCUMENT_POSITION_CONTAINS `(8)^i

%other は %node の`先祖$である。 ◎ Set when other is an ancestor of node.

$Node . $DOCUMENT_POSITION_CONTAINED_BY `(16)^i

%other は %node の`子孫$である。 ◎ Set when other is a descendant of node.

%node . $contains(other)

%other が %node の`広義子孫$ならば ~T, 他の場合は~F を返す。 ◎ Returns true if other is an inclusive descendant of node, and false otherwise.

次のものは $compareDocumentPosition() が~bitmaskとして返す定数である（括弧内は数-値）： ◎ These are the constants compareDocumentPosition() returns as mask:

• @DOCUMENT_POSITION_DISCONNECTED (1)
• @DOCUMENT_POSITION_PRECEDING (2)
• @DOCUMENT_POSITION_FOLLOWING (4)
• @DOCUMENT_POSITION_CONTAINS (8)
• @DOCUMENT_POSITION_CONTAINED_BY (16 ~EQ 0x10)
• @DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC (32 ~EQ 0x20)

@compareDocumentPosition(other)

被呼出時には、次を走らすモノトスル： ◎ The compareDocumentPosition(other) method, when invoked, must run these steps:

1. ~IF［ 此れ ~EQ %other ］ ⇒ ~RET 0 ◎ If context object is other, then return zero.
2. ( %他~node, %自~node ) ~LET ( %other, 此れ ) ◎ Let node1 be other and node2 be context object.
3. ( %他~属性o, %自~属性o ) ~LET ( ~NULL, ~NULL ) ◎ Let attr1 and attr2 be null.
4. ~IF［ %他~node は`属性o$である ］ ⇒＃ %他~属性o ~SET %他~node； %他~node ~SET %他~属性o が`属する要素$ ◎ If node1 is an attribute, then set attr1 to node1 and node1 to attr1’s element.

5. ~IF［ %自~node は`属性o$である ］： ◎ If node2 is an attribute, then:

   1. %自~属性o ~SET %自~node ◎ ↓
   2. %自~node ~SET %自~属性o が`属する要素$ ◎ Set attr2 to node2 and node2 to attr2’s element.

   3. ~IF［ %他~属性o ~NEQ ~NULL ］~AND［ %自~属性o ~NEQ ~NULL ］~AND［ %自~node ~EQ %他~node ］： ◎ If attr1 and node1 are non-null, and node2 is node1, then:

      1. %自~node の`属性o~list$内の ~EACH( %属性o ) に対し： ◎ For each attr in node2’s attribute list:

         1. ~IF［ ( %属性o, %他~属性o ) は`同等$である ］ ⇒ ~RET $DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC ~PLUS $DOCUMENT_POSITION_PRECEDING ◎ If attr equals attr1, then return the result of adding DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC and DOCUMENT_POSITION_PRECEDING.
         2. ~IF［ ( %属性o, %自~属性o ) は`同等$である ］ ⇒ ~RET $DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC ~PLUS $DOCUMENT_POSITION_FOLLOWING ◎ If attr equals attr2, then return the result of adding DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC and DOCUMENT_POSITION_FOLLOWING.

6. ~IF［ %他~node ~EQ ~NULL ］~OR［ %自~node ~EQ ~NULL ］~OR［ %他~node の`根$ ~NEQ %自~node の`根$ ］ ⇒ ~RET ［ $DOCUMENT_POSITION_DISCONNECTED ~PLUS $DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC ~PLUS ［ $DOCUMENT_POSITION_PRECEDING または $DOCUMENT_POSITION_FOLLOWING （ただし，いずれが~~選択されるかは一貫するものとする）］ ］ ◎ If node1 or node2 is null, or node1’s root is not node2’s root, then return the result of adding DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, and either DOCUMENT_POSITION_PRECEDING or DOCUMENT_POSITION_FOLLOWING, with the constraint that this is to be consistent, together.

   注記： $DOCUMENT_POSITION_PRECEDING, $DOCUMENT_POSITION_FOLLOWING のいずれを返値に用いるかは，概して~pointer比較を介して行われる。 ~JS実装においては `Math.random()^c 値を利用できる。 【理想的には、各~node木どうしの順序も循環しないように一貫するべきであろう。】 ◎ Whether to return DOCUMENT_POSITION_PRECEDING or DOCUMENT_POSITION_FOLLOWING is typically implemented via pointer comparison. In JavaScript implementations a cached Math.random() value can be used.

7. ~IF［［ %他~node は %自~node の`先祖$である ］~AND［ %他~属性o ~EQ ~NULL ］］~OR［［ %他~node ~EQ %自~node ］~AND［ %自~属性o ~NEQ ~NULL ］］ ⇒ ~RET $DOCUMENT_POSITION_CONTAINS ~PLUS $DOCUMENT_POSITION_PRECEDING ◎ If node1 is an ancestor of node2 and attr1 is null, or node1 is node2 and attr2 is non-null, then return the result of adding DOCUMENT_POSITION_CONTAINS to DOCUMENT_POSITION_PRECEDING.
8. ~IF［［ %他~node は %自~node の`子孫$である ］~AND［ %自~属性o ~EQ ~NULL ］］~OR［［ %他~node ~EQ %自~node ］~AND［ %他~属性o ~NEQ ~NULL ］］ ⇒ ~RET $DOCUMENT_POSITION_CONTAINED_BY ~PLUS $DOCUMENT_POSITION_FOLLOWING ◎ If node1 is a descendant of node2 and attr2 is null, or node1 is node2 and attr1 is non-null, then return the result of adding DOCUMENT_POSITION_CONTAINED_BY to DOCUMENT_POSITION_FOLLOWING.

9. ~IF［ %他~node は %自~node に`先行-$する ］ ⇒ ~RET $DOCUMENT_POSITION_PRECEDING ◎ If node1 is preceding node2, then return DOCUMENT_POSITION_PRECEDING.

   `属性o$は`木$に`関与-$しないが、この~algoに因り、`属性o$は，［ それを有する`要素$ ］の`子$に`先行-$するものとされることになる。 ◎ Due to the way attributes are handled in this algorithm this results in a node’s attributes counting as preceding that node’s children, despite attributes not participating in a tree.

10. ~RET $DOCUMENT_POSITION_FOLLOWING ◎ Return DOCUMENT_POSITION_FOLLOWING.

@contains(other)

被呼出時には、［ %other は此れの`広義子孫$であるならば ~T ／ ~ELSE_（ %other ~EQ ~NULL の場合も含む） ~F ］を返すモノトスル。 ◎ The contains(other) method, when invoked, must return true if other is an inclusive descendant of context object, and false otherwise (including when other is null).

%要素 用の `~ns接頭辞を~locateする@ ときは、所与の ( %~ns ) に対し，次を走らす： ◎ To locate a namespace prefix for an element using namespace, run these steps:

1. ~IF［ %要素 の`~ns$ ~EQ %~ns ］~AND［ %要素 の`~ns接頭辞$ ~NEQ ~NULL ］ ⇒ ~RET %要素 の`~ns接頭辞$ ◎ If element’s namespace is namespace and its namespace prefix is not null, then return its namespace prefix.
2. %属性o ~LET %要素 が`有する$`属性o$のうち，次を満たす`最初のもの？$ ⇒ ［ `~ns接頭辞$a ~EQ `xmlns^l ］~AND［ `値$a ~EQ %~ns ］ ◎ If element has an attribute whose namespace prefix is "xmlns" and value is namespace, then return element’s first such attribute’s local name.
3. ~IF［ %属性o ~NEQ ~NULL ］ ⇒ ~RET %属性 の`局所~名$a ◎ ↑
4. %親 ~SET %要素 の`親~要素$ ◎ ↓
5. ~IF［ %親 ~NEQ ~NULL ］ ⇒ ~RET %親 用の`~ns接頭辞を~locateする$( %~ns ) ◎ If element’s parent element is not null, then return the result of running locate a namespace prefix on that element using namespace.
6. ~RET ~NULL ◎ Return null.

%node 用の `~nsを~locateする@ ときは、所与の ( %接頭辞 ) に対し，次を走らす： ◎ To locate a namespace for a node using prefix,＼

1. %要素 ~LET ~NULL ◎ ↓

2. %node に応じて： ◎ switch on node:

   $Element

   1. ~IF［ %node の`~ns$ ~NEQ ~NULL ］~AND［ %node の`~ns接頭辞$ ~EQ %接頭辞 ］ ⇒ ~RET その`~ns$ ◎ If its namespace is not null and its namespace prefix is prefix, then return namespace.

   2. %属性o ~LET %要素 が`有する$`属性o$のうち［ %接頭辞 に応じて，次に与える条件 ］を満たす`最初のもの？$：

      • %接頭辞 ~NEQ ~NULL の場合 ⇒ ［ `~ns$a ~EQ `~XMLNS~ns$ ］~AND［ `~ns接頭辞$a ~EQ `xmlns^l ］~AND［ `局所~名$a ~EQ %接頭辞 ］
      • %接頭辞 ~EQ ~NULL の場合 ⇒ ［ `~ns$a ~EQ `~XMLNS~ns$ ］~AND［ `~ns接頭辞$a ~EQ ~NULL ］~AND［ `局所~名$a ~EQ `xmlns^l ］
      ◎ If it has an attribute whose namespace is the XMLNS namespace, namespace prefix is "xmlns", and local name is prefix, or if prefix is null and it has an attribute whose namespace is the XMLNS namespace, namespace prefix is null, and local name is "xmlns",＼
   3. ~IF［ %属性o ~NEQ ~NULL ］ ⇒ ~RET ［ %属性o の`値$a ~NEQ 空~文字列 ならばそれ ／ ~ELSE_ ~NULL ］ ◎ then return its value if it is not the empty string, and null otherwise.
   4. %要素 ~SET %node の`親~要素$ ◎ If its parent element is null, then return null. ◎ Return the result of running locate a namespace on its parent element using prefix.

   $Document

   %要素 ~SET %node の`文書~要素$ ◎ If its document element is null, then return null. ◎ Return the result of running locate a namespace on its document element using prefix.

   $DocumentType

   $DocumentFragment

   ~RET ~NULL ◎ Return null.

   $Attr

   %要素 ~SET %node が`属する要素$ ◎ If its element is null, then return null. ◎ Return the result of running locate a namespace on its element using prefix.

   他の~node（`文字~data~node$） ◎ Any other node

   %要素 ~SET %node の`親~要素$ ◎ If its parent element is null, then return null. ◎ Return the result of running locate a namespace on its parent element using prefix.

3. ~IF［ %要素 ~NEQ ~NULL ］ ⇒ ~RET %要素 用の`~nsを~locateする$( %接頭辞 ) ◎ ↑
4. ~RET ~NULL ◎ ↑

@lookupPrefix(namespace)

被呼出時には、次を走らすモノトスル： ◎ The lookupPrefix(namespace) method, when invoked, must run these steps:

1. ~IF［ %namespace ~IN { ~NULL, 空~文字列 } ］ ⇒ ~RET ~NULL ◎ If namespace is null or the empty string, then return null.

2. %要素 ~LET 此れに応じて，次で与えられる［ 要素, または ~NULL ］： ◎ Switch on the context object:

   $Element

   此れ ◎ Return the result of locating a namespace prefix for it using namespace.

   $Document

   此れの`文書~要素$ ◎ Return the result of locating a namespace prefix for its document element, if its document element is non-null, and null otherwise.

   $DocumentType

   $DocumentFragment

   ~NULL ◎ Return null.

   $Attr

   此れが`属する要素$ ◎ Return the result of locating a namespace prefix for its element, if its element is non-null, and null otherwise.

   他の~node（`文字~data~node$） ◎ Any other node

   此れの`親~要素$ ◎ Return the result of locating a namespace prefix for its parent element, if its parent element is non-null, and null otherwise.

3. ~IF ［ %要素 ~NEQ ~NULL ］ ⇒ ~RET %要素 用の`~ns接頭辞を~locateする$( %namespace ) ◎ ↑
4. ~RET ~NULL ◎ ↑

@lookupNamespaceURI(prefix)

被呼出時には、次を走らすモノトスル： ◎ The lookupNamespaceURI(prefix) method, when invoked, must run these steps:

1. ~IF［ %prefix ~EQ 空~文字列 ］ ⇒ %prefix ~SET ~NULL ◎ If prefix is the empty string, then set it to null.
2. ~RET 此れ用の`~nsを~locateする$( %prefix ) ◎ Return the result of running locate a namespace for the context object using prefix.

@isDefaultNamespace(namespace)

被呼出時には、次を走らすモノトスル： ◎ The isDefaultNamespace(namespace) method, when invoked, must run these steps:

1. ~IF［ %namespace ~EQ 空~文字列 ］ ⇒ %namespace ~SET ~NULL ◎ If namespace is the empty string, then set it to null.
2. %既定~ns ~LET 此れ用の`~nsを~locateする$( ~NULL ) ◎ Let defaultNamespace be the result of running locate a namespace for context object using null.
3. ~RET ［ 次が満たされるならば ~T ／ ~ELSE_ ~F ］ ⇒ %既定~ns ~EQ %namespace ◎ Return true if defaultNamespace is the same as namespace, and false otherwise.

@insertBefore(node, child)

被呼出時には、次の結果を返すモノトスル ⇒ 此れの中で`~nodeを子の前に前挿入する$( %node, %child ) ◎ The insertBefore(node, child) method, when invoked, must return the result of pre-inserting node into context object before child.

【 ~HTMLの `br^e のような~void要素であっても（あるいは `script^e 要素であっても）、子~nodeを挿入でき，木の一部を成すことになる — より一般には、文書~言語の内容~modelでは許容されなくても，`~node木$の拘束に反しない限り挿入できる。 木を改変する他の~meth（次の $appendChild() など）も同様。 】

@appendChild(node)

被呼出時には、次の結果を返すモノトスル ⇒ 此れに`~nodeを付加する$( %node ) ◎ The appendChild(node) method, when invoked, must return the result of appending node to context object.

@replaceChild(node, child)

被呼出時には、次の結果を返すモノトスル ⇒ 此れの中で`子を~nodeに置換する$( %child, %node ) ◎ The replaceChild(node, child) method, when invoked, must return the result of replacing child with node within context object.

@removeChild(child)

被呼出時には、次の結果を返すモノトスル ⇒ 此れから`子を前除去する$( %child ) ◎ The removeChild(child) method, when invoked, must return the result of pre-removing child from context object.

`~node$ %根 に対する， %有修飾~名 を `有修飾~名に持つ要素の~list@ とは、次のようにされた $HTMLCollection である ⇒＃ `根$cL ~SET %根, `~filter$cLは［ %根 の`子孫$である`要素$ %要素 のうち，次を走らせた結果 ~EQ ~T になるもの ］に合致する： ◎ The list of elements with qualified name qualifiedName for a node root is the HTMLCollection returned by the following algorithm:

1. ~IF［ %有修飾~名 ~EQ `*^l (U+002A) ］ ⇒ ~RET ~T ◎ If qualifiedName is "*" (U+002A), return a HTMLCollection rooted at root, whose filter matches only descendant elements.

2. ~IF［ %根 の`~node文書$は`~HTML文書$である ］ ⇒ ~RET［ %要素 は次のいずれかを満たすならば ~T ／ ~ELSE_ ~F ］： ◎ Otherwise, if root’s node document is an HTML document, return a HTMLCollection rooted at root, whose filter matches the following descendant elements:

   • ［ `~ns$ ~EQ `~HTML~ns$ ］~AND［ `有修飾~名$ ~EQ `~ASCII小文字~化する$( %有修飾~名 ) ］ ◎ Whose namespace is the HTML namespace and whose qualified name is qualifiedName, in ASCII lowercase.
   • ［ `~ns$ ~NEQ `~HTML~ns$ ］~AND［ `有修飾~名$ ~EQ %有修飾~名 ］ ◎ Whose namespace is not the HTML namespace and whose qualified name is qualifiedName.
3. ~RET［ %要素 は次を満たすならば ~T ／ ~ELSE_ ~F ］ ⇒ `有修飾~名$ ~EQ %有修飾~名 ◎ Otherwise, return a HTMLCollection rooted at root, whose filter matches descendant elements whose qualified name is qualifiedName.

以前の~callと同じ引数で呼出されたときは、 %根 の`~node文書$の`種別$docが変化していない限り，そのときに返したものと同じ $HTMLCollection ~objを返してもヨイ。 ◎ When invoked with the same argument, and as long as root’s node document’s type has not changed, the same HTMLCollection object may be returned as returned by an earlier call.

`~node$ %根 に対する， ( %~ns, %局所~名 ) を `( ~ns, 局所~名 ) に持つ要素の~list@ とは、次のようにされた $HTMLCollection である ⇒＃ `根$cL ~SET %根, `~filter$cLは［ %根 の`子孫$である`要素$ %要素 のうち，次を走らせた結果 ~EQ ~T になるもの ］に合致する： ◎ The list of elements with namespace namespace and local name localName for a node root is the HTMLCollection returned by the following algorithm:

1. %C ~LET `*^l (U+002A) ◎ ↓
2. ~IF［ %~ns ~EQ %C ］~AND［ %局所~名 ~EQ %C ］ ⇒ ~RET ~T ◎ If both namespace and localName are "*" (U+002A), return a HTMLCollection rooted at root, whose filter matches descendant elements.
3. ~IF［ %~ns ~EQ %C ］ ⇒ ~RET［ %要素 は次を満たすならば ~T ／ ~ELSE_ ~F ］ ⇒ `局所~名$ ~EQ %局所~名 ◎ Otherwise, if namespace is "*" (U+002A), return a HTMLCollection rooted at root, whose filter matches descendant elements whose local name is localName.
4. ~IF［ %局所~名 ~EQ %C ］ ⇒ ~RET［ %要素 は次を満たすならば ~T ／ ~ELSE_ ~F ］ ⇒ `~ns$ ~EQ %~ns ◎ Otherwise, if localName is "*" (U+002A), return a HTMLCollection rooted at root, whose filter matches descendant elements whose namespace is namespace.
5. ~RET［ %要素 は次を満たすならば ~T ／ ~ELSE_ ~F ］ ⇒ ［ `~ns$ ~EQ %~ns ］~AND［ `局所~名$ ~EQ %局所~名 ］ ◎ Otherwise, return a HTMLCollection rooted at root, whose filter matches descendant elements whose namespace is namespace and local name is localName.

以前の~callと同じ引数で呼出されたときは，そのときに返したものと同じ $HTMLCollection ~objを返してもヨイ。 ◎ When invoked with the same argument, the same HTMLCollection object may be returned as returned by an earlier call.

`~node$ %根 に対する， %classNames を `~classesに含む要素の~list@ とは、次の~algoが返す $HTMLCollection である： ◎ The list of elements with class names classNames for a node root is the HTMLCollection returned by the following algorithm:

1. %~classes ~LET %classNames を`有順序~集合 構文解析器$にかけた結果 ◎ Let classes be the result of running the ordered set parser on classNames.
2. ~IF［ %~classes は空である ］ ⇒ ~RET 空の $HTMLCollection ◎ If classes is the empty set, return an empty HTMLCollection.

3. ~RET 次のようにされた $HTMLCollection `~collection$ ⇒ `根$cL ~SET %根, `~filter$cLは［ %根 の`子孫$ %子孫 のうち，次を満たすもの ］に合致する ⇒ ［ %子孫 は`要素$である ］~AND［ %子孫 の`~classes$は %~classes に含まれるすべての~tokenを含む ］ ◎ Return a HTMLCollection rooted at root, whose filter matches descendant elements that have all their classes in classes.

   `~classes$と %~classes の中の各~tokenの比較は、［ %根 の`~node文書$の`~mode$docが `quirks^l ならば `~ASCII大小無視$ ／ ~ELSE_ `大小区別$ ］で行うモノトスル。 ◎ The comparisons for the classes must be done in an ASCII case-insensitive manner if root’s node document’s mode is "quirks", and in a case-sensitive manner otherwise.

4.5. ^@Document ~ifc

$@Document `~node$は、単に `文書@ （ `document^en ）とも称される。 ◎ Document nodes are simply known as documents.

注記： ~modeが既定の~modeから変更されるのは、`文書$が，新たな`閲覧文脈$（初期の `about:blank^l ）から，［ DOCTYPE 文字列の有無, およびその値 ］に基づいて `~HTML構文解析器$を通して作成される場合に限られる。 `HTML$r ◎ The mode is only ever changed from the default for documents created by the HTML parser based on the presence, absence, or value of the DOCTYPE string, and by a new browsing context (initial "about:blank"). [HTML]

注記： `非過去互換~mode$ は 元々は “標準~mode” と称され， `限定的互換~mode$ は かつては “ほぼ標準~mode” と称されていた。 それらは今や標準により定義されたので（また、それらの元々の名称が~~的外れであることから Ian Hickson が~~否決したので）、改称された。 ◎ No-quirks mode was originally known as "standards mode" and limited-quirks mode was once known as "almost standards mode". They have been renamed because their details are now defined by standards. (And because Ian Hickson vetoed their original names on the basis that they are nonsensical.)

%document = new $Document()

新たな`文書$を返す。 ◎ Returns a new document.

%document . $implementation

%document の $DOMImplementation ~objを返す。 ◎ Returns document’s DOMImplementation object.

%document . $URL

%document . $documentURI

%document の`~URL$doc を返す。 ◎ Returns document’s URL.

%document . $origin

%document の`生成元$docを返す。 ◎ Returns document’s origin.

%document . $compatMode

%document の`~mode$docが［ `quirks^l ならば文字列 `BackCompat^l ／ ~ELSE_ `CSS1Compat^l ］を返す。 ◎ Returns the string "BackCompat" if document’s mode is "quirks", and "CSS1Compat" otherwise.

%document . $characterSet

%document の`符号化法$docを返す。 ◎ Returns document’s encoding.

%document . $contentType

%document の`内容~型$docを返す。 ◎ Returns document’s content type.

@Document()

この構築子の被呼出時には、次のようにされた，新たな`文書$を返すモノトスル ⇒ `生成元$doc ~SET `現在の大域~obj$に`結付けられている文書$の`生成元$doc `HTML$r ◎ The Document() constructor, when invoked, must return a new document whose origin is the origin of current global object’s associated Document. [HTML]

注記： $DOMImplementation.createDocument() と違って、この構築子は $XMLDocument ~objではなく，`文書$（ $Document ~obj）を返す。 ◎ Unlike createDocument(), this constructor does not return an XMLDocument object, but a document (Document object).

@implementation

取得子は、此れ（`文書$）に結付けられている $DOMImplementation ~objを返すモノトスル。 ◎ The implementation attribute’s getter must return the DOMImplementation object that is associated with the document.

@URL

@documentURI

これらのいずれも，取得子は、次を走らせた結果を返すモノトスル ⇒ `~URLを直列化する$( 此れの`~URL$doc ) ◎ The URL attribute’s getter and documentURI attribute’s getter must return the URL, serialized.

@origin

取得子は、次の結果を返すモノトスル ⇒ `生成元を直列化する$( 此れの`生成元$doc ) ◎ The origin attribute’s getter must return the serialization of context object’s origin.

@compatMode

取得子は、此れの`~mode$docに応じて，次を返すモノトスル ⇒＃ `quirks^l ならば `BackCompat^l ／ ~ELSE_ `CSS1Compat^l ◎ The compatMode attribute’s getter must return "BackCompat" if context object’s mode is "quirks", and "CSS1Compat" otherwise.

@characterSet

@charset

@inputEncoding

これらのいずれも，取得子は、此れの`符号化法$docの`名前$encを返すモノトスル。 ◎ The characterSet attribute’s getter, charset attribute’s getter, and inputEncoding attribute’s getter, must return context object’s encoding’s name.

@contentType

取得子は、此れの`内容~型$docを返すモノトスル。 ◎ The contentType attribute’s getter must return the content type.

%document . $doctype

`~doctype$が［ 在ればそれ ／ 無ければ~NULL ］を返す。 ◎ Returns the doctype or null if there is none.

%document . $documentElement

`文書~要素$を返す。 ◎ Returns the document element.

%collection = %document . $getElementsByTagName(qualifiedName)

引数に応じて，次を満たす`子孫$`要素$すべてからなる $HTMLCollection を返す：

• %qualifiedName ~EQ `*^l の場合： 無条件。

• 他の場合、次のいずれかを満たすもの：

  • `有修飾~名$ ~EQ %qualifiedName
  • ［ `~HTML文書$ 内に在る ］~AND［ `~HTML~ns$に属する ］~AND［ `有修飾~名$は %qualifiedName に~ASCII大小無視で合致する ］

◎ If qualifiedName is "*" returns a HTMLCollection of all descendant elements. ◎ Otherwise, returns a HTMLCollection of all descendant elements whose qualified name is qualifiedName. (Matches case-insensitively against elements in the HTML namespace within an HTML document.)

%collection = %document . $getElementsByTagNameNS(namespace, localName)

引数に応じて，次を満たす`子孫$`要素$すべてからなる $HTMLCollection を返す： ◎ ↓

• %namespace, %localName ともに `*^l の場合： 無条件。 ◎ If namespace and localName are "*" returns a HTMLCollection of all descendant elements.
• %namespace のみ `*^l の場合： ［ `局所~名$ ~EQ %localName ］なるもの。 ◎ If only namespace is "*" returns a HTMLCollection of all descendant elements whose local name is localName.
• %localName のみ `*^l の場合： ［ `~ns$ ~EQ %namespace ］なるもの。 ◎ If only localName is "*" returns a HTMLCollection of all descendant elements whose namespace is namespace.
• 他の場合： ［ `~ns$ ~EQ %namespace ］~AND［ `局所~名$ ~EQ %localName ］なるもの。 ◎ Otherwise, returns a HTMLCollection of all descendant elements whose namespace is namespace and local name is localName.

%collection = %document . $getElementsByClassName(classNames)

%collection = %element . $Element.getElementsByClassName(classNames)

~methが呼出された~obj（`文書$または`要素$）内の`要素$のうち，［ %classNames で与えられる一連の~class名をすべて持つもの ］からなる $HTMLCollection を返す。 %classNames 引数は一連の~class名の~space区切り~listとして解釈される。 ◎ Returns a HTMLCollection of the elements in the object on which the method was invoked (a document or an element) that have all the classes given by classNames. The classNames argument is interpreted as a space-separated list of classes.

@doctype

取得子は、次を満たす~nodeのうち，`最初のもの？$を返すモノトスル ⇒ ［ 此れの`子$である ］~AND［ `~doctype$である ］ ◎ The doctype attribute’s getter must return the child of the document that is a doctype, and null otherwise.

@documentElement

取得子は、此れの`文書~要素$を返すモノトスル。 ◎ The documentElement attribute’s getter must return the document element.

@getElementsByTagName(qualifiedName)

被呼出時には、此れに対する， %qualifiedName を`有修飾~名に持つ要素の~list$を返すモノトスル。 ◎ The getElementsByTagName(qualifiedName) method, when invoked, must return the list of elements with qualified name qualifiedName for the context object.

注記： したがって，`~HTML文書$においては、 `document.getElementsByTagName("FOO")^c は `~HTML~ns$に属さない `FOO^e 要素と `~HTML~ns$に属する `foo^e 要素に合致し， `~HTML~ns$に属する `FOO^e 要素には合致しないことになる。 ◎ Thus, in an HTML document, document.getElementsByTagName("FOO") will match <FOO> elements that are not in the HTML namespace, and <foo> elements that are in the HTML namespace, but not <FOO> elements that are in the HTML namespace.

@getElementsByTagNameNS(namespace, localName)

被呼出時には、此れに対する， ( %namespace, %localName ) を `( ~ns, 局所~名 ) に持つ要素の~list$を返すモノトスル。 ◎ The getElementsByTagNameNS(namespace, localName) method, when invoked, must return the list of elements with namespace namespace and local name localName for the context object.

@getElementsByClassName(classNames)

被呼出時には、此れに対する， %classNames を`~classesに含む要素の~list$を返すモノトスル。 ◎ The getElementsByClassName(classNames) method, when invoked, must return the list of elements with class names classNames for the context object.

次の XHTML 片が与えられたとする： ◎ Given the following XHTML fragment:

<div id="example">
  <p id="p1" class="aaa bbb"/>
  <p id="p2" class="aaa ccc"/>
  <p id="p3" class="bbb ccc"/>
</div>

document.getElementById(`example^l).getElementsByClassName(`aaa^l) の~callは、その中の 2 個の paragraph p1 と p2 からなる $HTMLCollection を返すことになる。 ◎ A call to document.getElementById("example").getElementsByClassName("aaa") would return a HTMLCollection with the two paragraphs p1 and p2 in it.

一方で， getElementsByClassName(`ccc bbb^l) の~callは その中の 1 個の~node p3 のみを返すことになる。 document.getElementById(`example^l).getElementsByClassName(`bbb   ccc ^l) の~callも同じものを返すことになる。 ◎ A call to getElementsByClassName("ccc bbb") would only return one node, however, namely p3. A call to document.getElementById("example").getElementsByClassName("bbb ccc ") would return the same thing.

getElementsByClassName(`aaa,bbb^l) の~callは 1 個の~nodeも返さない。 上のどの要素も `aaa,bbb^c ~classに属さない。 ◎ A call to getElementsByClassName("aaa,bbb") would return no nodes; none of the elements above are in the aaa,bbb class.

%element = %document . $createElement(localName [, options])

`局所~名$が %localName にされた`要素$を返す（ %document が`~HTML文書$である場合， %localName は小文字~化される）。 `要素$の`~ns$は，［ 次のいずれかに該当する場合は`~HTML~ns$ ／ 他の場合は ~NULL ］になる ⇒＃ %document は`~HTML文書$である ／ %document の`内容~型$doc ~EQ `application/xhtml+xml^l ◎ Returns an element with localName as local name (if document is an HTML document, localName gets lowercased). The element’s namespace is the HTML namespace when document is an HTML document or document’s content type is "application/xhtml+xml", and null otherwise.

%localName が `Name$prod 生成規則に合致しない場合， `InvalidCharacterError$E 例外が投出される。 ◎ If localName does not match the Name production an "InvalidCharacterError" DOMException will be thrown.

%options の $ElementCreationOptions.is を利用して，`~custom化された組込みの要素$を作成できる。 ◎ When supplied, options’s is can be used to create a customized built-in element.

%element = %document . $createElementNS(namespace, qualifiedName [, options])

`~ns$ %namespace に属するような，新たな`要素$を返す。 その ( `~ns接頭辞$, `局所~名$ ) は、順に次のようにされる ⇒＃ %qualifiedName が `:^l (U+003A) を含むならば それを挟んだ ( 前, 後 ) の部分 ／ 他の場合は ( ~NULL, %qualifiedName ) ◎ Returns an element with namespace namespace. Its namespace prefix will be everything before ":" (U+003E) in qualifiedName or null. Its local name will be everything after ":" (U+003E) in qualifiedName or qualifiedName.

%qualifiedName が `Name$prod 生成規則に合致しない場合， `InvalidCharacterError$E 例外が投出される。 ◎ If localName does not match the Name production an "InvalidCharacterError" DOMException will be thrown.

次のいずれかに該当する場合， `NamespaceError$E 例外が投出される ⇒＃ %localName は `QName$prod 生成規則に合致しない ／ %namespace は空~文字列であるのに，`~ns接頭辞$は~NULL でない ／ %namespace は`~XML~ns$でないのに，`~ns接頭辞$は `xml^l である ／ %namespace は`~XMLNS~ns$でないのに， %qualifiedName または`~ns接頭辞$は `xmlns^l である ／ %namespace は`~XMLNS~ns$であるのに， %qualifiedName も`~ns接頭辞$も `xmlns^l でない ◎ If one of the following conditions is true a "NamespaceError" DOMException will be thrown: ◎ localName does not match the QName production. ◎ Namespace prefix is not null and namespace is the empty string. ◎ Namespace prefix is "xml" and namespace is not the XML namespace. ◎ qualifiedName or namespace prefix is "xmlns" and namespace is not the XMLNS namespace. ◎ namespace is the XMLNS namespace and neither qualifiedName nor namespace prefix is "xmlns".

%documentFragment = %document . $createDocumentFragment()

$DocumentFragment `~node$を返す。 ◎ Returns a DocumentFragment node.

%text = %document . $createTextNode(data)

新たな $Text `~node$を返す — その`~data$は %data にされる。 ◎ Returns a Text node whose data is data.

%text = %document . $createCDATASection(data)

新たな $CDATASection `~node$を返す — その`~data$は %data にされる。 ◎ Returns a CDATASection node whose data is data.

%comment = %document . $createComment(data)

新たな $Comment `~node$を返す — その`~data$は %data にされる。 ◎ Returns a Comment node whose data is data.

%processingInstruction = %document . $createProcessingInstruction(target, data)

新たな $ProcessingInstruction `~node$を返す — その $target は %target にされ, `~data$は %data にされる。 ◎ Returns a ProcessingInstruction node whose target is target and data is data.＼

次のいずれかに該当する場合， `InvalidCharacterError$E 例外が投出される ⇒＃ %target は `Name$prod 生成規則に合致しない ／ %data は `?>^l を含んでいる ◎ If target does not match the Name production an "InvalidCharacterError" DOMException will be thrown. If data contains "?>" an "InvalidCharacterError" DOMException will be thrown.

他が言明されない限り，所与の ( 局所~名, ~ns ) 用の `要素~ifc@ は、 $Element とする。 ◎ The element interface for any name and namespace is Element, unless stated otherwise.

注記： 例えば，~HTML標準は、 ( `html$e, `~HTML~ns$ ) 用のそれを， $HTMLHtmlElement ~ifcと定義している。 `HTML$r ◎ The HTML Standard will e.g. define that for html and the HTML namespace, the HTMLHtmlElement interface is used. [HTML]

@createElement(localName, options)

被呼出時には、次を走らすモノトスル： ◎ The createElement(localName, options) method, when invoked, must run these steps:

1. ~IF［ %localName は `Name$prod 生成規則に合致しない ］ ⇒ ~THROW `InvalidCharacterError$E ◎ If localName does not match the Name production, then throw an "InvalidCharacterError" DOMException.
2. ~IF［ 此れは`~HTML文書$ である ］ ⇒ %localName ~SET `~ASCII小文字~化する$( %localName ) ◎ If the context object is an HTML document, then set localName to localName in ASCII lowercase.
3. %is ~LET ［［ %options は`辞書$である ］~AND［ %options に $ElementCreationOptions.is ~memberは在る ］ならば その~memberの値 ／ ~ELSE_ ~NULL ］ ◎ Let is be null. ◎ If options is a dictionary and options’s is is present, then set is to it.
4. %~ns ~LET ［ 次が満たされるならば `~HTML~ns$ ／ ~ELSE_ ~NULL ］ ⇒ ［ 此れは`~HTML文書$である ］~OR［ 此れの`内容~型$doc ~EQ `application/xhtml+xml^l ］ ◎ Let namespace be the HTML namespace, if the context object is an HTML document or context object’s content type is "application/xhtml+xml", and null otherwise.
5. ~RET `要素を作成する$( 此れ, %localName, %~ns, ~NULL, %is, `同期~custom要素^i ) ◎ Return the result of creating an element given the context object, localName, namespace, null, is, and with the synchronous custom elements flag set.

`内的 createElementNS 手続き@ は、所与の ( %文書, %namespace, %qualifiedName, %options ) に対し，次を走らす： ◎ The internal createElementNS steps, given document, namespace, qualifiedName, and options, are as follows:

1. ( %~ns, %接頭辞, %局所~名 ) ~LET `検証して抽出する$( %namespace, %qualifiedName ) ◎ Let namespace, prefix, and localName be the result of passing namespace and qualifiedName to validate and extract.
2. ~RET `要素を作成する$( %文書, %局所~名, %~ns, %接頭辞, %is, `同期~custom要素^i ) ◎ Return the result of creating an element given document, localName, namespace, prefix, is, and with the synchronous custom elements flag set.

@createElementNS(namespace, qualifiedName, options)

被呼出時には、次の結果を返すモノトスル ⇒ `内的 createElementNS 手続き$( 此れ, %namespace, %qualifiedName, %options ) ◎ The createElementNS(namespace, qualifiedName, options) method, when invoked, must return the result of running the internal createElementNS steps, given context object, namespace, qualifiedName, and options.

注記： ~web互換性のため、［ $createElement() ／ $createElementNS() ］の %options 引数には文字列も許容される【無視されることになる】。 ◎ createElement() and createElementNS()'s options parameter is allowed to be a string for web compatibility.

@createDocumentFragment()

被呼出時には、次のように設定された 新たな`文書片$を返すモノトスル ⇒ `~node文書$ ~SET 此れ ◎ The createDocumentFragment() method, when invoked, must return a new DocumentFragment node with its node document set to the context object.

@createTextNode(data)

被呼出時には、 `新たな~Text~node$( %data, 此れ ) を返すモノトスル ◎ The createTextNode(data) method, when invoked, must return a new Text node with its data set to data and node document set to the context object.

注記： ［ %data が `Char$prod 生成規則に合致しない文字を含む ］かどうかは、検査されない。 ◎ No check is performed that data consists of characters that match the Char production.

@createCDATASection(data)

被呼出時には、次を走らすモノトスル： ◎ The createCDATASection(data) method, when invoked, must run these steps:

1. ~IF［ 此れは`~HTML文書$である ］ ⇒ ~THROW `NotSupportedError$E ◎ If context object is an HTML document, then throw a "NotSupportedError" DOMException.
2. ~IF［ %data は文字列 `]]>^l を包含する ］ ⇒ ~THROW `InvalidCharacterError$E ◎ If data contains the string "]]>", then throw an "InvalidCharacterError" DOMException.
3. ~RET 次のようにされた，新たな $CDATASection `~node$ ⇒ ( `~data$, `~node文書$ ) ~SET ( %data, 此れ ) ◎ Return a new CDATASection node with its data set to data and node document set to the context object.

@createComment(data)

被呼出時には、次のように設定された 新たな $Comment `~node$を返すモノトスル ⇒ ( `~data$, `~node文書$ ) ~SET ( %data, 此れ ) ◎ The createComment(data) method, when invoked, must return a new Comment node with its data set to data and node document set to the context object.

注記： %data が［ `Char$prod 生成規則に合致しない文字を含む ／ 連続する 2 個の~hyphen（ "--" ）を含む ／ ~hyphenで終わる ］かどうかは、検査されない。 ◎ No check is performed that data consists of characters that match the Char production or that it contains two adjacent hyphens or ends with a hyphen.

@createProcessingInstruction(target, data)

被呼出時には、次を走らすモノトスル： ◎ The createProcessingInstruction(target, data) method, when invoked, must run these steps:

1. ~IF［ %target は `Name$prod 生成規則に合致しない ］ ⇒ ~THROW `InvalidCharacterError$E ◎ If target does not match the Name production, then throw an "InvalidCharacterError" DOMException.
2. ~IF［ %data は文字列 `?>^l を含む ］ ⇒ ~THROW `InvalidCharacterError$E ◎ If data contains the string "?>", then throw an "InvalidCharacterError" DOMException.
3. ~RET 次のように設定された 新たな $ProcessingInstruction `~node$ ⇒ ( $ProcessingInstruction.target, `~data$, `~node文書$ ) ~SET ( %target, %data, 此れ ) ◎ Return a new ProcessingInstruction node, with target set to target, data set to data, and node document set to the context object.

注記： ［ %target が `xml^l または `:^l を含む ／ %data が `Char$prod 生成規則に合致しない文字を含む ］かどうかは、検査されない。 ◎ No check is performed that target contains "xml" or ":", or that data contains characters that match the Char production.

%clone = %document . $importNode(node [, deep = false])

%node の複製を返す。 %deep が~T の場合、複製には %node の`子孫$も含められる。 ◎ Returns a copy of node. If deep is true, the copy also includes the node’s descendants.

%node が`文書$または`~shadow根$である場合， `NotSupportedError$E 例外が投出される。 ◎ If node is a document or a shadow root, throws a "NotSupportedError" DOMException.

%node = %document . $adoptNode(node)

%node を他の`文書$から移動させた上で，それを返す。 ◎ Moves node from another document and returns it.

%node が`文書$である場合， `NotSupportedError$E 例外が投出される。 %node が`~shadow根$である場合， `HierarchyRequestError$E 例外が投出される。 ◎ If node is a document, throws a "NotSupportedError" DOMException or, if node is a shadow root, throws a "HierarchyRequestError" DOMException.

@importNode(node, deep)

被呼出時には、次を走らすモノトスル： ◎ The importNode(node, deep) method, when invoked, must run these steps:

1. ~IF［ %node は `文書$または`~shadow根$である ］ ⇒ ~THROW `NotSupportedError$E ◎ If node is a document or shadow root, then throw a "NotSupportedError" DOMException.
2. ~RET `~nodeを~cloneする$( %node, 此れ, ［ %deep ~EQ ~T ならば `子も~cloneする^i ／ ~ELSE_ ε ］ ) ◎ Return a clone of node, with context object and the clone children flag set if deep is true.

`適用-可能な仕様$は、すべてまたは一部の`~node$用に `受入-時の手続き@ を定義してもヨイ。 この~algoは、`~nodeを受入する$~algo内から， ( `~node$, `文書$ ) を渡して呼出される。 ◎ Specifications may define adopting steps for all or some nodes. The algorithm is passed node and oldDocument, as indicated in the adopt algorithm.

%文書 に `~nodeを受入する@ ときは、所与の ( %node ) に対し，次を走らす： ◎ To adopt a node into a document, run these steps:

1. %旧-文書 ~LET %node の`~node文書$ ◎ Let oldDocument be node’s node document.
2. ~IF［ %node の`親$ ~NEQ ~NULL ］ ⇒ %node の`親$から`子を除去する$( %node ) ◎ If node’s parent is not null, remove node from its parent.

3. ~IF［ %文書 ~NEQ %旧-文書 ］： ◎ If document is not oldDocument, then:

   1. %node の ~EACH( `~shadowも含む広義子孫$ %広義子孫 ) に対し ◎ For each inclusiveDescendant in node’s shadow-including inclusive descendants:

      1. %広義子孫 の`~node文書$ ~SET %文書 ◎ Set inclusiveDescendant’s node document to document.
      2. ~IF［ %広義子孫 は`要素$である ］ ⇒ %広義子孫 の`属性o~list$内の ~EACH( %属性o ) に対し ⇒ %属性o の`~node文書$ ~SET %文書 ◎ If inclusiveDescendant is an element, then set the node document of each attribute in inclusiveDescendant’s attribute list to document.
   2. %node の ~EACH( `~shadowも含む広義子孫$ %広義子孫 ) に対し ⇒ ~IF［ %広義子孫 は`~custom$である ］ ⇒ `~custom要素~callback反応を~enqueueする$( %広義子孫, `adoptedCallback^l, « %旧-文書, %文書 » ) ◎ For each inclusiveDescendant in node’s shadow-including inclusive descendants that is custom, enqueue a custom element callback reaction with inclusiveDescendant, callback name "adoptedCallback", and an argument list containing oldDocument and document.
   3. %node の ~EACH( `~shadowも含む広義子孫$ %広義子孫 ) に対し，`~shadowも含む木~順序$で ⇒ `受入-時の手続き$に ( %広義子孫, %旧-文書 ) を渡して走らす ◎ For each inclusiveDescendant in node’s shadow-including inclusive descendants, in shadow-including tree order, run the adopting steps with inclusiveDescendant and oldDocument.

@adoptNode(node)

被呼出時には、次を走らすモノトスル： ◎ The adoptNode(node) method, when invoked, must run these steps:

1. ~IF［ %node は`文書$である ］ ⇒ ~THROW `NotSupportedError$E ◎ If node is a document, then throw a "NotSupportedError" DOMException.
2. ~IF［ %node は`~shadow根$である ］ ⇒ ~THROW `HierarchyRequestError$E ◎ If node is a shadow root, then throw a "HierarchyRequestError" DOMException.
3. 此れに`~nodeを受入する$( %node ) ◎ Adopt node into the context object.
4. ~RET %node ◎ Return node.

@createAttribute(localName)

被呼出時には、次を走らすモノトスル： ◎ The createAttribute(localName) method, when invoked, must run these steps:

1. ~IF［ %localName は~XMLの `Name$prod 生成規則に合致しない ］ ⇒ ~THROW `InvalidCharacterError$E ◎ If localName does not match the Name production in XML, then throw an "InvalidCharacterError" DOMException.
2. ~IF［ 此れは`~HTML文書$である ］ ⇒ %localName ~SET `~ASCII小文字~化する$( %localName ) ◎ If the context object is an HTML document, then set localName to localName in ASCII lowercase.
3. ~RET 次のように設定された 新たな`属性o$ ⇒＃ `局所~名$a ~SET %localName, `~node文書$ ~SET 此れ ◎ Return a new attribute whose local name is localName and node document is context object.

@createAttributeNS(namespace, qualifiedName)

被呼出時には、次を走らすモノトスル： ◎ The createAttributeNS(namespace, qualifiedName) method, when invoked, must run these steps:

1. ~RET 次のように設定された 新たな`属性o$ ⇒＃ `~ns$a ~SET %~ns, `~ns接頭辞$a ~SET %接頭辞, `局所~名$a ~SET %局所~名, `~node文書$ ~SET 此れ ◎ Return a new attribute whose namespace is namespace, namespace prefix is prefix, local name is localName, and node document is context object.

@createEvent(interface)

被呼出時には、次を走らすモノトスル： ◎ The createEvent(interface) method, when invoked, must run these steps:

1. %構築子 ~LET ~NULL ◎ Let constructor be null.

2. ~IF［ %interface は［ 下の表のいずれかの行の 1 列目の文字列 ］に `~ASCII大小無視$で合致する ］ ⇒ %構築子 ~SET ［ 合致した行の 2 列目の~ifc ］の構築子 ◎ If interface is an ASCII case-insensitive match for any of the strings in the first column in the following table, then set constructor to the interface in the second column on the same row as the matching string:

   文字列◎ String	~ifc◎ Interface	仕様（空欄はこの仕様）◎ Notes
   `beforeunloadevent^l	$BeforeUnloadEvent	`HTML$r
   `compositionevent^l	$CompositionEvent	`UIEVENTS$r
   `customevent^l	$CustomEvent
   `devicemotionevent^l	$DeviceMotionEvent	`DEVICE-ORIENTATION$r
   `deviceorientationevent^l	$DeviceOrientationEvent	同上
   `dragevent^l	$DragEvent	`HTML$r
   `event^l	$Event
   `events^l	同上
   `focusevent^l	$FocusEvent	`UIEVENTS$r
   `hashchangeevent^l	$HashChangeEvent	`HTML$r
   `htmlevents^l	$Event
   `keyboardevent^l	$KeyboardEvent	`UIEVENTS$r
   `messageevent^l	$MessageEvent	`HTML$r
   `mouseevent^l	$MouseEvent	`UIEVENTS$r
   `mouseevents^l	同上	同上
   `storageevent^l	$StorageEvent	`HTML$r
   `svgevents^l	$Event
   `textevent^l	$CompositionEvent	`UIEVENTS$r
   `touchevent^l	$TouchEvent	`TOUCH-EVENTS$r
   `uievent^l	$UIEvent	`UIEVENTS$r
   `uievents^l	同上	同上

3. ~IF［ %構築子 ~EQ ~NULL ］ ⇒ ~THROW `NotSupportedError$E ◎ If constructor is null, then throw a "NotSupportedError" DOMException.

4. ~IF［ %構築子 が指示する~ifcは，此れに`関連する大域~obj$に公開されていない ］ ⇒ ~THROW `NotSupportedError$E ◎ If the interface indicated by constructor is not exposed on the relevant global object of the context object, then throw a "NotSupportedError" DOMException.

   注記： 概して~UAは、環境設定によっては，~touch~eventの~supportを不能化する — その場合、この段が $TouchEvent ~ifc用に誘発されることになる。 ◎ Typically user agents disable support for touch events in some configurations, in which case this clause would be triggered for the interface TouchEvent.

5. %~event ~LET `~eventを作成する$( %構築子 ) ◎ Let event be the result of creating an event given constructor.
6. %~event の $Event.type 属性 ~SET 空~文字列に初期化する ◎ Initialize event’s type attribute to the empty string.
7. %~event の $Event.timeStamp 属性 ~SET ［ `時刻起点$から現在時までの高分解能な時間差 ］を表現している $DOMHighResTimeStamp 値に初期化する ◎ Initialize event’s timeStamp attribute to a DOMHighResTimeStamp representing the high resolution time from the time origin to now.
8. %event の $Event.isTrusted 属性 ~SET ~F に初期化する ◎ Initialize event’s isTrusted attribute to false.
9. %~event の`初期化-済み$f ~SET ~OFF ◎ Unset event’s initialized flag.
10. ~RET %~event ◎ Return event.

注記： 代わりに，`~event$構築子が利用されるべきである。 ◎ Event constructors ought to be used instead.

@createRange()

被呼出時には、次のように設定された 新たな`~live範囲o$を返すモノトスル ⇒＃ `始端$ ~SET `境界点$(此れ, 0) , `終端$ ~SET `境界点$(此れ, 0) ◎ The createRange() method, when invoked, must return a new live range with (context object, 0) as its start and end.

注記： 代わりに， $Range.Range() 構築子を利用できる。 ◎ The Range() constructor can be used instead.

@createNodeIterator(root, whatToShow, filter)

被呼出時には、次のように設定された 新たな $NodeIterator ~objを返すモノトスル ⇒＃ `根$tV ~SET %root, `起点$tV ~SET %root, `起点の直前？$tV ~SET ~T, `~whatToShow$tV ~SET %whatToShow, `~filter~callback$tV ~SET %filter ◎ The createNodeIterator(root, whatToShow, filter) method, when invoked, must run these steps: • Let iterator be a new NodeIterator object. • Set iterator’s root and iterator’s reference to root. • Set iterator’s pointer before reference to true. • Set iterator’s whatToShow to whatToShow. • Set iterator’s filter to filter. • Return iterator.

@createTreeWalker(root, whatToShow, filter)

被呼出時には、次のように設定された 新たな $TreeWalker ~objを返すモノトスル ⇒＃ `根$tV ~SET %root, `現-~node$tV ~SET %root, `~whatToShow$tV ~SET %whatToShow, `~filter~callback$tV ~SET %filter ◎ The createTreeWalker(root, whatToShow, filter) method, when invoked, must run these steps: • Let walker be a new TreeWalker object. • Set walker’s root and walker’s current to root. • Set walker’s whatToShow to whatToShow. • Set walker’s filter to filter. • Return walker.

4.6. ^@DocumentType ~ifc

$DocumentType `~node$は、単に `~doctype@ とも称される。 ◎ DocumentType nodes are simply known as doctypes.

@name

取得子は、此れの`名前$dTを返すモノトスル。 ◎ The name attribute’s getter must return the context object’s name.

@publicId

取得子は、此れの`~publicID$dTを返すモノトスル。 ◎ The publicId attribute’s getter must return the context object’s public ID.

@systemId

取得子は、此れの`~systemID$dTを返すモノトスル。 ◎ The systemId attribute’s getter must return the context object’s system ID.

4.7. ^@DocumentFragment ~ifc

$DocumentFragment `~node$は、単に `文書片@ （ `document fragment^en ）とも称される。 【これは、この訳にて導入した非公式な用語である。】

~obj %A が ~obj %B の `~hostも含む広義先祖@ であるとは、次のいずれかが満たされることを意味する： ◎ An object A is a host-including inclusive ancestor of an object B, if either＼

• %A は %B の`広義先祖$である ◎ A is an inclusive ancestor of B, or＼
• %B の`根$の`~host$を %H とするとき，次が満たされる ⇒ ［ %H ~NEQ ~NULL ］~AND［ %A は %H の`~hostも含む広義先祖$である ］ ◎ if B’s root has a non-null host and A is a host-including inclusive ancestor of B’s root’s host.

注記： `文書片$の`~host$は，［ `~shadow根$, ~HTMLの `template$e 要素 ］で有用になる概念であり、［ `~nodeを子の前に前挿入する$／`子を~nodeに置換する$ ］~algoに影響0する。 ◎ The DocumentFragment node’s host concept is useful for HTML’s template element and for shadow roots, and impacts the pre-insert and replace algorithms.

%tree = new $DocumentFragment()

新たな`文書片$を返す。 ◎ Returns a new DocumentFragment node.

@DocumentFragment()

この構築子の被呼出時には、次のようにされた新たな`文書片$を返すモノトスル ⇒ `~node文書$ ~SET `現在の大域~obj$に`結付けられている文書$ ◎ The DocumentFragment() constructor, when invoked, must return a new DocumentFragment node whose node document is current global object’s associated Document.

4.8. ^@ShadowRoot ~ifc

$ShadowRoot ~nodeは、単に `~shadow根@ （ `shadow root^en ）とも称される。 ◎ ShadowRoot nodes are simply known as shadow roots.

`~shadow根$の`~host$が ~NULL になることは決してない。 ◎ Shadow roots’s associated host is never null.

`~shadow根$ %根 の`親~targetを取得する$ときは、所与の~event %~event に対し，次を走らす： ◎ A shadow root’s get the parent algorithm, given an event,＼

1. ~IF［ %~event の`~composed$f ~EQ ~OFF ］~AND［ %根 ~EQ ［［［ %~event の`経路$ ］内の最初の構造体 ］の `~item$evP ］の`根$ ］ ⇒ ~RET ~NULL ◎ returns null if event’s composed flag is unset and shadow root is the root of event’s path’s first struct’s item, and＼
2. ~RET %根 の`~host$ ◎ shadow root’s host otherwise.

@mode

取得子は、此れの`~mode$sRを返すモノトスル。 ◎ The mode attribute’s getter must return the context object’s mode.

@host

取得子は、此れの`~host$を返すモノトスル。 ◎ The host attribute’s getter must return the context object’s host.

`~node木$ %木 に対する `~shadowも含む木~順序@ は、 `~shadowも含む深優先前順走査@ と称される，次に従う順序である ⇒ %木 に対する深優先前順走査 【すなわち，通常の木~順序】 に従いつつ， %木 において［ `~shadow~host$である`要素$ %要素 ］に遭遇した各所では，［［ %要素 の`~shadow根$elmを根とする`~node木$ ］に対する，`~shadowも含む深優先前順走査$ ］に従う。 ◎ In shadow-including tree order, is shadow-including preorder, depth-first traversal of a node tree. shadow-including preorder, depth-first traversal of a node tree tree is preorder, depth-first traversal of tree, with for each shadow host encountered in tree, shadow-including preorder, depth-first traversal of that element’s shadow root’s node tree just after it is encountered.

~obj %O の `~shadowも含む根@ とは、 %O の`根$を %根 とするとき，［ %根 は`~shadow根$であるならば %根 の`~host$の`~shadowも含む根$ ／ ~ELSE_ %根 ］である。 ◎ The shadow-including root of an object is its root’s host’s shadow-including root, if the object’s root is a shadow root, and its root otherwise.

~obj %A が~obj %B の `~shadowも含む子孫@ であるとは、次を意味する ⇒ ［ %A は %B の`子孫$である ］~OR［ %A の`根$は次を満たす ］ ⇒ ［ `~shadow根$である ］~AND［ その`~host$は %B の`~shadowも含む広義子孫$である ］ ◎ An object A is a shadow-including descendant of an object B, if A is a descendant of B, or A’s root is a shadow root and A’s root’s host is a shadow-including inclusive descendant of B.

~obj %A が~obj %B の `~shadowも含む広義子孫@ であるとは、次を意味する ⇒ ［ %A ~EQ %B ］~OR［ %A は %B の`~shadowも含む子孫$である ］ ◎ A shadow-including inclusive descendant is an object or one of its shadow-including descendants.

~obj %A が~obj %B の `~shadowも含む先祖@ であるとは、次を意味する ⇒ %B は %A の`~shadowも含む子孫$である ◎ An object A is a shadow-including ancestor of an object B, if and only if B is a shadow-including descendant of A.

~obj %A が~obj %B の `~shadowも含む広義先祖@ であるとは、次を意味する ⇒ ［ %A ~EQ %B ］~OR［ %A は %B の`~shadowも含む先祖$である ］ ◎ A shadow-including inclusive ancestor is an object or one of its shadow-including ancestors.

`~node$ %A が `~node$ %B から `~closed~shadow~hidden@ であるとは、 %A の`根$ %根 が次のすべてを満たすことを意味する： ◎ A node A is closed-shadow-hidden from a node B if all of the following conditions are true:

• %根 は`~shadow根$である ◎ A’s root is a shadow root.
• %根 は %B の`~shadowも含む広義先祖$でない ◎ A’s root is not a shadow-including inclusive ancestor of B.
• ［ %根 の`~mode$sR ~EQ `closed^l ］~OR［ %根 の`~host$は %B から`~closed~shadow~hidden$である ］ ◎ A’s root is a shadow root whose mode is "closed" or A’s root’s host is closed-shadow-hidden from B.

~obj %A を ~obj %B に向けて `~targetし直す@ ときは、次を走らす： ◎ To retarget an object A against an object B,＼

1. ~WHILE 無条件： ◎ repeat these steps until they return an object:

   1. %根 ~LET %A の`根$ ◎ ↓

   2. ~IF［ 次のいずれかが満たされる ］…： ◎ If one of the following is true

      • %A は`~node$でない ◎ A is not a node
      • %根 は`~shadow根$でない ◎ A’s root is not a shadow root
      • ［ %B は`~node$である ］~AND［ %根 は %B の`~shadowも含む広義先祖$である ］ ◎ B is a node and A’s root is a shadow-including inclusive ancestor of B

      …ならば ⇒ ~RET %A ◎ then return A.

   3. %A ~SET %根 の`~host$ ◎ Set A to A’s root’s host.

注記： `~targetし直す$~algoは、~eventの`配送-$時, および `FULLSCREEN$r などの他の仕様により利用される。 ◎ The retargeting algorithm is used by event dispatch as well as other specifications, such as Fullscreen. [FULLSCREEN]

4.9. ^@Element ~ifc

$@Element `~node$は、単に `要素@ （ `element^en ）とも称される。 ◎ Element nodes are simply known as elements.

各 `要素$には、次のものが結付けられ，いずれも`要素を作成する$ときに初期化される ⇒＃ `~ns@, `~ns接頭辞@, `局所~名@, `~custom要素~状態@, `~custom要素~定義@, `~is0値@ ◎ Elements have an associated namespace, namespace prefix, local name, custom element state, custom element definition, is value. When an element is created, all of these values are initialized.

注記： 要素が`定義-済み$かどうかは、 :defined 疑似類の挙動を決定するときに利用される。 要素が`~custom$であるかどうかは、 変異~algo の挙動を決定するときに利用される。 `failed^l 状態は、`~custom要素~構築子$が初回に正しく実行するのに失敗した場合に，`要素を昇格する$ときに再び実行されないことを確保するために利用される。 ◎ Whether or not an element is defined is used to determine the behavior of the :defined pseudo-class. Whether or not an element is custom is used to determine the behavior of the mutation algorithms. The "failed" state is used to ensure that if a custom element constructor fails to execute correctly the first time, it is not executed again by an upgrade.

<!DOCTYPE html>
<script>
  window.customElements.define(
    "sw-rey",
    class extends HTMLElement {}
  );
  window.customElements.define(
    "sw-finn",
    class extends HTMLElement {},
    { extends: "p" }
  );
  window.customElements.define(
    "sw-kylo",
    class extends HTMLElement {
      constructor() {
        /* 
`super()^c は、この例からは意図的に省略している。
◎
super() intentionally omitted for this example
 */
    }
  });
</script>

<!-- 
`undefined^l （`定義-済み$でも`~custom$でもない）
◎
"undefined" (not defined, not custom)
 -->
<sw-han></sw-han>
<p is="sw-luke"></p>
<p is="asdf"></p>

<!-- 
`failed^l （`定義-済み$でも`~custom$でもない）
◎
"failed" (not defined, not custom)
 -->
<sw-kylo></sw-kylo>

<!-- 
`uncustomized^l （`定義-済み$だが`~custom$ではない）
◎
"uncustomized" (defined, not custom)
 -->
<p></p>
<asdf></asdf>

<!-- 
`custom^l （`定義-済み$かつ`~custom$である）
◎
"custom" (defined, custom)
 -->
<sw-rey></sw-rey>
<p is="sw-finn"></p>

各 `要素$には、 `~shadow根@elm も結付けられる： ◎ Elements also have an associated shadow root＼

• それは，［ ~NULL ／ `~shadow根$ ］であり、他が言明されない限り，~NULL とする。 ◎ (null or a shadow root). It is null unless otherwise stated.＼
• ~NULL でない場合、当の`要素$は `~shadow~host@ であるとされる。 【すなわち，要素は、`~shadow根$elmを根とする ある`~shadow木$を~hostしている（言い換えれば、ある`~shadow根$の`~host$である）。】 ◎ An element is a shadow host if its shadow root is non-null.

`要素$ %要素 の `有修飾~名@ は、 %要素 の`~ns接頭辞$ %接頭辞 に応じて，［ ~NULL ならば %要素 の`局所~名$ ／ 非 ~NULL ならば［ %接頭辞, `:^l, %要素 の`局所~名$ ］の並び ］になる。 ◎ An element’s qualified name is its local name if its namespace prefix is null, and its namespace prefix, followed by ":", followed by its local name, otherwise.

`要素$ %要素 の `~HTML大文字~化~有修飾~名@ は、次の手続きの結果を返す： ◎ An element’s HTML-uppercased qualified name is the return value of these steps:

1. %有修飾~名 ~LET %要素 の`有修飾~名$ ◎ Let qualifiedName be context object’s qualified name.
2. ~IF［ %要素 は`~HTML~ns$に属する ］~AND［ %要素 の`~node文書$は`~HTML文書$である ］ ⇒ ~RET `~ASCII大文字~化する$( %有修飾~名 ) ◎ If the context object is in the HTML namespace and its node document is an HTML document, then set qualifiedName to qualifiedName in ASCII uppercase.
3. ~RET %有修飾~名 ◎ Return qualifiedName.

注記： ~UAは、`有修飾~名$と`~HTML大文字~化~有修飾~名$を内的~slotに格納して最適化することもできる。 ◎ User agents could optimize qualified name and HTML-uppercased qualified name by storing them in internal slots.

`要素を作成する@ ときは、所与の ⇒＃ %文書, %局所~名, %~ns, %接頭辞 （省略時は ~NULL ）, %is （省略時は ~NULL ）, %同期~custom要素~flag ~IN { `同期~custom要素^i, ε }（省略時は ε ） ◎終 に対し，次の手続きを走らす： ◎ To create an element, given a document, localName, namespace, and optional prefix, is, and synchronous custom elements flag, run these steps:

1. %結果 ~LET ~NULL ◎ If prefix was not given, let prefix be null. ◎ If is was not given, let is be null. ◎ Let result be null.
2. %定義 ~LET `~custom要素~定義を検索する$( %文書, %~ns, %局所~名, %is ) ◎ Let definition be the result of looking up a custom element definition given document, namespace, localName, and is.

3. ~IF［ %定義 ~NEQ ~NULL ］~AND［ %定義 の`名前$cD ~NEQ %定義 の`局所~名$cD ］（すなわち，%定義 は`~custom化された組込みの要素$を表現する）： ◎ If definition is non-null, and definition’s name is not equal to its local name (i.e., definition represents a customized built-in element), then:

   1. %~ifc ~LET ( %局所~名, `~HTML~ns$ ) 用の`要素~ifc$ ◎ Let interface be the element interface for localName and the HTML namespace.

   2. %結果 ~SET 次のようにされた，新たな`要素$ ⇒＃ %~ifc を実装する, `属性o$は有さない, `~ns$ ~SET `~HTML~ns$, `~ns接頭辞$ ~SET %接頭辞 , `局所~名$ ~SET %局所~名, `~custom要素~状態$ ~SET `undefined^l, `~custom要素~定義$ ~SET ~NULL, `~is0値$ ~SET %is, `~node文書$ ~SET %文書 ◎ Set result to a new element that implements interface, with no attributes, namespace set to the HTML namespace, namespace prefix set to prefix, local name set to localName, custom element state set to "undefined", custom element definition set to null, is value set to is, and node document set to document.

   3. ~IF［ %同期~custom要素~flag ~NEQ ε ］ ⇒ `要素を昇格する$( %定義, %要素 ) ◎ If the synchronous custom elements flag is set, upgrade element using definition.
   4. ~ELSE ⇒ `~custom要素~昇格~反応を~enqueueする$( %結果, %定義 ) ◎ Otherwise, enqueue a custom element upgrade reaction given result and definition.

4. ~ELIF［ %定義 ~NEQ ~NULL ］~AND［ %同期~custom要素~flag ~NEQ ε ］： ◎ Otherwise, if definition is non-null, then:

   この段から例外が投出されたときは、~catchして，下の (A) に~~移行するとする ◎ If the synchronous custom elements flag is set, then run these steps while catching any exceptions:

   1. %C ~LET %定義 の`構築子$cD ◎ Let C be definition’s constructor.
   2. %結果 ~SET `~callback関数で構築する$( %C, 空の引数~list ) ◎ Set result to the result of constructing C, with no arguments.

   3. ~IF［ %結果 は $HTMLElement ~ifcを実装しない ］ ⇒ ~THROW `TypeError$E ◎ If result does not implement the HTMLElement interface, then throw a TypeError.

      注記： これは、［ 当の~objが~HTML要素~構築子により割振られること ］を確保するための，~brand検査である。 より精確に知りたければ、 webidl #97 を見よ。 ◎ This is meant to be a brand check to ensure that the object was allocated by the HTML element constructor. See webidl #97 about making this more precise.

      この検査に合格したなら、 %結果 の［ `~custom要素~状態$, `~custom要素~定義$ ］はすでに初期化されていることになる。 ◎ If this check passes, then result will already have its custom element state and custom element definition initialized.

   4. ~IF［ %結果 は下に挙げるいずれかを満たす ］ ⇒ ~THROW `NotSupportedError$E： ◎ ↓

      • %結果 の`属性o~list$は`空$でない ◎ If result’s attribute list is not empty, then throw a "NotSupportedError" DOMException.
      • %結果 は`子$を持つ ◎ If result has children, then throw a "NotSupportedError" DOMException.
      • %結果 の`親$ ~NEQ ~NULL ◎ If result’s parent is not null, then throw a "NotSupportedError" DOMException.
      • %結果 の`~node文書$ ~NEQ %文書 ◎ If result’s node document is not document, then throw a "NotSupportedError" DOMException.

      • %結果 の`~ns$ ~NEQ `~HTML~ns$ ◎ If result’s namespace is not the HTML namespace, then throw a "NotSupportedError" DOMException.

        注記： これを書いている時点では、 $HTMLElement ~ifcを実装するどの要素も~HTML~nsに属するので、上の~brand検査から，この検査は冗長であるが、永遠に保障されるわけではない — 例えば、~SVGと~HTMLのある種の~ifcが収束するような，仕様の変更に直面したときなど。 ◎ As of the time of this writing, every element that implements the HTMLElement interface is also in the HTML namespace, so this check is currently redundant with the above brand check. However, this is not guaranteed to be true forever in the face of potential specification changes, such as converging certain SVG and HTML interfaces.

      • %結果 の`局所~名$ ~NEQ %局所~名 ◎ If result’s local name is not equal to localName, then throw a "NotSupportedError" DOMException.
   5. %結果 の`~ns接頭辞$ ~SET %接頭辞 ◎ Set result’s namespace prefix to prefix.
   6. %結果 の`~is0値$ ~SET ~NULL ◎ Set result’s is value to null.

   (A) — 上の手続きにて，例外が投出されたときは： ◎ If any of these steps threw an exception, then:

   1. `その例外を報告する$ ◎ Report the exception.

   2. %結果 ~SET 次のようにされた，新たな`要素$ ⇒＃ $HTMLUnknownElement ~ifcを実装する, 属性oは有さない, `~ns$ ~SET `~HTML~ns$, `~ns接頭辞$ ~SET %接頭辞, `局所~名$ ~SET %局所~名, `~custom要素~状態$ ~SET `failed^l, `~custom要素~定義$ ~SET ~NULL, `~is0値$ ~SET ~NULL, `~node文書$ ~SET %文書 ◎ Set result to a new element that implements the HTMLUnknownElement interface, with no attributes, namespace set to the HTML namespace, namespace prefix set to prefix, local name set to localName, custom element state set to "failed", custom element definition set to null, is value set to null, and node document set to document.

5. ~ELIF［ %定義 ~NEQ ~NULL ］： ◎ ↑ ◎ Otherwise:

   1. %結果 ~SET 次のようにされた，新たな`要素$ ⇒＃ $HTMLElement を実装する, `属性o$は有さない, `~ns$ ~SET `~HTML~ns$, `~ns接頭辞$ ~SET %接頭辞 , `局所~名$ ~SET %局所~名, `~custom要素~状態$ ~SET `undefined^l, `~custom要素~定義$ ~SET ~NULL, `~is0値$ ~SET ~NULL, `~node文書$ ~SET %文書 ◎ Set result to a new element that implements the HTMLElement interface, with no attributes, namespace set to the HTML namespace, namespace prefix set to prefix, local name set to localName, custom element state set to "undefined", custom element definition set to null, is value set to null, and node document set to document.

   2. `~custom要素~昇格~反応を~enqueueする$( %結果, %定義 ) ◎ Enqueue a custom element upgrade reaction given result and definition.

6. ~ELSE： ◎ Otherwise:

   1. %~ifc ~LET ( %局所~名, %~ns ) 用の`要素~ifc$ ◎ Let interface be the element interface for localName and namespace.

   2. %結果 ~SET 次のようにされた，新たな`要素$ ⇒＃ %~ifc を実装する, `属性o$は有さない, `~ns$ ~SET %~ns, `~ns接頭辞$ ~SET %接頭辞 , `局所~名$ ~SET %局所~名, `~custom要素~状態$ ~SET `uncustomized^l, `~custom要素~定義$ ~SET ~NULL, `~is0値$ ~SET %is, `~node文書$ ~SET %文書 ◎ Set result to a new element that implements interface, with no attributes, namespace set to namespace, namespace prefix set to prefix, local name set to localName, custom element state set to "uncustomized", custom element definition set to null, is value set to is, and node document set to document.

   3. ~IF［ 次のいずれも満たされる ］…：

      • %~ns ~EQ `~HTML~ns$
      • ［ %局所~名 は`妥当な~custom要素~名$である ］~OR［ %is ~NEQ ~NULL ］

      …ならば ⇒ %結果 の`~custom要素~状態$ ~SET `undefined^l

      ◎ If namespace is the HTML namespace, and either localName is a valid custom element name or is is non-null, then set result’s custom element state to "undefined".
7. ~RET %結果 ◎ Return result.

各`要素$は、 `属性o~list@ も持つ。 それは、`~list$であり， $NamedNodeMap 【~objを返す $attributes 属性】 を通して公開される。 `要素$の作成-時に明示的に与えられない限り，その`属性o~list$は`空$とする。 ◎ Elements also have an attribute list, which is a list exposed through a NamedNodeMap. Unless explicitly given when an element is created, its attribute list is empty.

`要素$ %要素 が`属性o$ %A を `有する@ とは、［ %A ~IN %要素 の`属性o~list$ ］を意味する。 ◎ An element has an attribute A if its attribute list contains A.

【 この場合、［ %A が`属する要素$ ~EQ %要素 ］も満たすことになる — 複数の`要素$が同じ`属性o$を`有する$ことはない（手続き内のある同期的な瞬間を除いて）。 】

`適用-可能な仕様$は、`要素$上の `属性o変更-時の手続き@ を定義してもヨイ。 この~algoは、当の要素に加えて， ( %局所~名, %旧-値, %値, %~ns ) を渡して呼出される。 ◎ This and other specifications may define attribute change steps for elements. The algorithm is passed element, localName, oldValue, value, and namespace.

`要素$ %要素 の `属性oを変更する@ ときは、所与の ( `属性o$ %属性o, 文字列 %値 ) に対し，次を走らす： ◎ To change an attribute attribute from an element element to value, run these steps:

1. ~Assert： %要素 は %属性o を`有する$ 【この段は、この訳による補完】
2. %要素 用に`属性~変異~記録を~queueする$( %属性o の`局所~名$a, %属性o の`~ns$, %属性o の`値$a ) ◎ Queue an attribute mutation record for element with attribute’s local name, attribute’s namespace, and attribute’s value.
3. ~IF［ %要素 は`~custom$である ］ ⇒ `~custom要素~callback反応を~enqueueする$( %要素, `attributeChangedCallback^l, « %属性o の`局所~名$, %属性o の`値$a, %値, %属性o の`~ns$ » ) ◎ If element is custom, then enqueue a custom element callback reaction with element, callback name "attributeChangedCallback", and an argument list containing attribute’s local name, attribute’s value, value, and attribute’s namespace.
4. 次を渡して， %要素 上の`属性o変更-時の手続き$を走らす ⇒ ( %属性o の`局所~名$a, %属性o の`値$a, %値, %属性o の`~ns$a ) ◎ Run the attribute change steps with element, attribute’s local name, attribute’s value, value, and attribute’s namespace.
5. %属性o の`値$a ~SET %値 ◎ Set attribute’s value to value.

`要素$ %要素 に `属性oを付加する@ ときは、所与の ( `属性o$ %属性o ) に対し，次を走らす： ◎ To append an attribute attribute to an element element, run these steps:

1. ~Assert： %要素 は %属性o を`有さない$ 【この段は、この訳による補完】
2. %要素 用に`属性~変異~記録を~queueする$( %属性o の`局所~名$a, %属性o の`~ns$, ~NULL ) ◎ Queue an attribute mutation record for element with attribute’s local name, attribute’s namespace, and null.
3. ~IF［ %要素 は`~custom$である ］ ⇒ `~custom要素~callback反応を~enqueueする$( %要素, `attributeChangedCallback^l, « %属性o の`局所~名$, ~NULL, %属性o の`値$a, %属性o の`~ns$ » ) ◎ If element is custom, then enqueue a custom element callback reaction with element, callback name "attributeChangedCallback", and an argument list containing attribute’s local name, null, attribute’s value, and attribute’s namespace.
4. 次を渡して， %要素 上の`属性o変更-時の手続き$を走らす ⇒ ( %属性o の`局所~名$a, ~NULL, %属性o の`値$a, %属性o の`~ns$a ) ◎ Run the attribute change steps with element, attribute’s local name, null, attribute’s value, and attribute’s namespace.
5. %要素 の`属性o~list$に %属性o を`付加する$ ◎ Append attribute to element’s attribute list.
6. %属性o が`属する要素$ ~SET %要素 ◎ Set attribute’s element to element.

`要素$ %要素 から `属性oを除去する@ ときは、所与の ( `属性o$ %属性o ) に対し，次を走らす： ◎ To remove an attribute attribute from an element element, run these steps:

1. ~Assert： %要素 は %属性o を`有する$ 【この段は、この訳による補完】
2. %要素 用に`属性~変異~記録を~queueする$( %属性o の`局所~名$a, %属性o の`~ns$, %属性o の`値$a ) ◎ Queue an attribute mutation record for element with attribute’s local name, attribute’s namespace, and attribute’s value.
3. ~IF［ %要素 は`~custom$である ］ ⇒ `~custom要素~callback反応を~enqueueする$( %要素, `attributeChangedCallback^l, « %属性o の`局所~名$, %属性o の`値$a, ~NULL, %属性o の`~ns$ » ) ◎ If element is custom, then enqueue a custom element callback reaction with element, callback name "attributeChangedCallback", and an argument list containing attribute’s local name, attribute’s value, null, and attribute’s namespace.
4. 次を渡して， %要素 上の`属性o変更-時の手続き$を走らす ⇒ ( %属性o の`局所~名$a, %属性o の`値$a, ~NULL, %属性o の`~ns$a ) ◎ Run the attribute change steps with element, attribute’s local name, attribute’s value, null, and attribute’s namespace.
5. %要素 の`属性o~list$から %属性o を`除去する$ ◎ Remove attribute from element’s attribute list.
6. %属性o が`属する要素$ ~SET ~NULL ◎ Set attribute’s element to null.

`要素$ %要素 の `属性oを置換する@ ときは、所与の ( `属性o$ %旧-属性o, `属性o$ %新-属性o ) に対し，次を走らす： ◎ To replace an attribute oldAttr by an attribute newAttr in an element element, run these steps:

1. ~Assert： %要素 は %旧-属性o を`有する$ 【この段は、この訳による補完】
2. %要素 用に`属性~変異~記録を~queueする$( %旧-属性o の`局所~名$a, %旧-属性o の`~ns$a, %旧-属性o の`値$a ) ◎ Queue an attribute mutation record for element with oldAttr’s local name, oldAttr’s namespace, and oldAttr’s value.
3. ~IF［ %要素 は`~custom$である ］ ⇒ `~custom要素~callback反応を~enqueueする$( %要素, `attributeChangedCallback^l, « %旧-属性o の`局所~名$, %旧-属性o の`値$a, %新-属性o の`値$a, %旧-属性o の`~ns$ » ) ◎ If element is custom, then enqueue a custom element callback reaction with element, callback name "attributeChangedCallback", and an argument list containing oldAttr’s local name, oldAttr’s value, newAttr’s value, and oldAttr’s namespace.
4. 次を渡して， %要素 上の`属性o変更-時の手続き$を走らす ⇒ ( %旧-属性o の`局所~名$a, %旧-属性o の`値$a, %新-属性o の`値$a, %旧-属性o の`~ns$a ) ◎ Run the attribute change steps with element, oldAttr’s local name, oldAttr’s value, newAttr’s value, and oldAttr’s namespace.
5. %要素 の`属性o~list$内の %旧-属性o を %新-属性o に`置換する$ ◎ Replace oldAttr by newAttr in element’s attribute list.
6. %旧-属性o が`属する要素$ ~SET ~NULL ◎ Set oldAttr’s element to null.
7. %新-属性o が`属する要素$ ~SET %要素 ◎ Set newAttr’s element to element.

`要素$ %要素 の `属性oを名前により取得する@ ときは、所与の ( %有修飾~名 ) に対し，次を走らす： ◎ To get an attribute by name given a qualifiedName and element element, run these steps:

1. ~IF［ %要素 は`~HTML~ns$に属する ］~AND［ %要素 の`~node文書$は`~HTML文書$である ］ ⇒ %有修飾~名 ~LET `~ASCII小文字~化する$( %有修飾~名 ) ◎ If element is in the HTML namespace and its node document is an HTML document, then set qualifiedName to qualifiedName in ASCII lowercase.
2. ~RET %要素 の`属性o~list$ 内の次を満たす`属性o$のうち，`最初のもの？$ ⇒ `有修飾~名$a ~EQ %有修飾~名 ◎ Return the first attribute in element’s attribute list whose qualified name is qualifiedName, and null otherwise.

`要素$ %要素 の `属性oを~nsと局所~名により取得する@ ときは、所与の ( %~ns, %局所~名 ) に対し、次を走らす： ◎ To get an attribute by namespace and local name given a namespace, localName, and element element, run these steps:

1. ~RET %要素 の`属性o~list$ 内の 次を満たす`属性o$のうち，`最初のもの？$ ⇒ ［ `~ns$a ~EQ %~ns ］~AND［ `局所~名$a ~EQ %局所~名 ］ ◎ Return the attribute in element’s attribute list whose namespace is namespace and local name is localName, if any, and null otherwise.

`要素$ %要素 の `属性o値を取得する@ ときは、所与の ( %局所~名, %~ns （省略時は ~NULL ） ) に対し，次を走らす： ◎ To get an attribute value given an element element, localName, and optionally a namespace (null unless stated otherwise), run these steps:

1. %属性o ~LET %要素 の`属性oを~nsと局所~名により取得する$( %局所~名, %~ns ) ◎ Let attr be the result of getting an attribute given namespace, localName, and element.
2. ~RET ［ %属性o ~EQ ~NULL ならば空~文字列 ／ ~ELSE_ %属性o の`値$a ］ ◎ If attr is null, then return the empty string. ◎ Return attr’s value.

`要素$ %要素 の `属性oを設定する@ するときは、所与の ( `属性o$ %属性o ) に対し，次を走らす： ◎ To set an attribute given an attr and element, run these steps:

1. ~IF［ %属性o が`属する要素$ ~NIN { ~NULL, %要素 } ］ ⇒ ~THROW `InUseAttributeError$E ◎ If attr’s element is neither null nor element, throw an "InUseAttributeError" DOMException.
2. %旧-属性o ~LET %要素 の`属性oを~nsと局所~名により取得する$( %属性o の`~ns$a, %属性o の`局所~名$a ) ◎ Let oldAttr be the result of getting an attribute given attr’s namespace, attr’s local name, and element.
3. ~IF［ %旧-属性o ~EQ %属性o ］ ⇒ ~RET %属性o ◎ If oldAttr is attr, return attr.
4. ~IF［ %旧-属性o ~NEQ ~NULL ］ ⇒ %要素 の`属性oを置換する$( %旧-属性o, %属性o ) ◎ If oldAttr is non-null, replace it by attr in element.
5. ~ELSE ⇒ %要素 に`属性oを付加する$( %属性o ) ◎ Otherwise, append attr to element.
6. ~RET %旧-属性o ◎ Return oldAttr.

`要素$ %要素 の `属性o値を設定する@ ときは、所与の ( %局所~名, %値, %接頭辞 （省略時は ~NULL ）, %~ns （省略時は ~NULL ） ) に対し，次を走らす： ◎ To set an attribute value for an element element using a localName and value, and an optional prefix, and namespace, run these steps:

1. %属性o ~LET %要素 の`属性oを~nsと局所~名により取得する$( %~ns, %局所~名 ) ◎ If prefix is not given, set it to null. ◎ If namespace is not given, set it to null. ◎ Let attribute be the result of getting an attribute given namespace, localName, and element.
2. ~IF［ %属性o ~NEQ ~NULL ］ ⇒＃ %要素 の`属性oを変更する$( %属性o, %値 )； ~RET ◎ ↓
3. %要素 に`属性oを付加する$( 次のように設定された 新たな`属性o$ ) ⇒＃ `~ns$a ~SET %~ns, `~ns接頭辞$a ~SET %接頭辞, `局所~名$a ~SET %局所~名, `値$a ~SET %値, `~node文書$ ~SET %要素 の`~node文書$ ◎ If attribute is null, create an attribute whose namespace is namespace, namespace prefix is prefix, local name is localName, value is value, and node document is element’s node document, then append this attribute to element, and then return. ◎ Change attribute from element to value.

`要素$ %要素 の `属性oを名前により除去する@ ときは、所与の ( %有修飾~名 ) に対し，次を走らす： ◎ To remove an attribute by name given a qualifiedName and element element, run these steps:

1. %属性o ~LET %要素 の`属性oを名前により取得する$( %有修飾~名 ) ◎ Let attr be the result of getting an attribute given qualifiedName and element.
2. ~IF［ %属性o ~NEQ ~NULL ］ ⇒ %要素 から`属性oを除去する$( %属性o ) ◎ If attr is non-null, remove it from element.
3. ~RET %属性o ◎ Return attr.

`要素$ %要素 の `属性oを~nsと局所~名により除去する@ ときは、所与の ( %~ns, %局所~名 ) に対し，次を走らす： ◎ To remove an attribute by namespace and local name given a namespace, localName, and element element, run these steps:

1. %属性o ~LET %要素 の`属性oを~nsと局所~名により取得する$( %~ns, %局所~名 ) ◎ Let attr be the result of getting an attribute given namespace, localName, and element.
2. ~IF［ %属性o ~NEQ ~NULL ］ ⇒ %要素 から`属性oを除去する$( %属性o ) ◎ If attr is non-null, remove it from element.
3. ~RET %属性o ◎ Return attr.

`要素$には、一意な識別子である `~ID@ が結付けられ得る。 ◎ An element can have an associated unique identifier (ID)

注記： 歴史的に，`要素$は複数の識別子を持ち得ていた。 例えば~HTML `id^A `属性o$nmと DTD を利用して。 この仕様では `~ID$を~DOMの概念とし，`要素$につき `id^A `属性o$nmで与えられる 1 個に限るとする。 ◎ Historically elements could have multiple identifiers e.g., by using the HTML id attribute and a DTD. This specification makes ID a concept of the DOM and allows for only one per element, given by an id attribute.

`要素$の`~ID$の更新~時に利用する，`属性o変更-時の手続き$は、次で与えられる： ◎ Use these attribute change steps to update an element’s ID:

1. ~IF［ %局所~名 ~EQ `id^l ］~AND［ %~ns ~EQ ~NULL ］~AND［ %値 ~IN { ~NULL, 空~文字列 } ］ ⇒ %要素 の`~ID$を未設定にする ◎ If localName is id, namespace is null, and value is null or the empty string, then unset element’s ID.
2. ~ELIF［ %局所~名 ~EQ `id^l ］~AND［ %~ns ~EQ ~NULL ］ ⇒ %要素 の`~ID$ ~SET %値 ◎ Otherwise, if localName is id, namespace is null, then set element’s ID to value.

注記： この仕様は、どの`要素$に対しても，その［ ^class, ^id, ^slot ］`属性o$nmに対する要件を定義しているが、これらの属性oを利用をするかどうかは，適合性の要件にしていない。 ◎ While this specification defines requirements for class, id, and slot attributes on any element, it makes no claims as to whether using them is conforming or not.

`~node$ %N の `親~要素@ とは、［ %N の`親$が`要素$であるならば それ ／ ~ELSE_ ~NULL ］である。 ◎ A node’s parent of type Element is known as a parent element. If the node has a parent of a different type, its parent element is null.

%namespace = %element . $namespaceURI

`~ns$を返す。 ◎ Returns the namespace.

%prefix = %element . $prefix

`~ns接頭辞$を返す。 ◎ Returns the namespace prefix.

%localName = %element . $localName

`局所~名$を返す。 ◎ Returns the local name.

%qualifiedName = %element . $tagName

`~HTML大文字~化~有修飾~名$を返す。 ◎ Returns the HTML-uppercased qualified name.

@namespaceURI

取得子は、此れの`~ns$を返すモノトスル。 ◎ The namespaceURI attribute’s getter must return the context object’s namespace.

@prefix

取得子は、此れの`~ns接頭辞$を返すモノトスル。 ◎ The prefix attribute’s getter must return the context object’s namespace prefix.

@localName

取得子は、此れの`局所~名$を返すモノトスル。 ◎ The localName attribute’s getter must return the context object’s local name.

@tagName

取得子は、此れの`~HTML大文字~化~有修飾~名$を返すモノトスル。 ◎ The tagName attribute’s getter must return the context object’s HTML-uppercased qualified name.

%element . $id [ = %value ]

%element の `id^A 属性oの値を返す。 設定して変更できる。 ◎ Returns the value of element’s id content attribute. Can be set to change it.

%element . $className [ = %value ]

%element の `class^A 属性oの値を返す。 設定して変更できる。 ◎ Returns the value of element’s class content attribute. Can be set to change it.

%element . $classList

%element の `class^A 属性oを，空白~区切り~tokenの集合として — $DOMTokenList ~objを通して — 操作できるようにする。 ◎ Allows for manipulation of element’s class content attribute as a set of whitespace-separated tokens through a DOMTokenList object.

%element . $slot [ = %value ]

%element の `slot^A 属性oを返す。 設定して変更できる。 ◎ Returns the value of element’s slot content attribute. Can be set to change it.

`要素$ %要素 上の一部の~IDL属性は、所与の %名前 の`属性o$を `反映する@ ように定義される。 すなわち、次に従うような取得子, 設定子を持つモノトスル： ◎ IDL attributes that are defined to reflect a content attribute of a given name, must have a getter and setter that follow these steps:

取得子

~RET %要素 の`属性o値を取得する$( %名前 ) ◎ Return the result of running get an attribute value given context object and name.

設定子

%要素 の`属性o値を設定する$( %名前, 所与の値 ) ◎ Set an attribute value for the context object using name and the given value.

@id

`id^l 属性oを`反映する$モノトスル。 ◎ The id attribute must reflect the "id" content attribute.

@className

`class^l 属性oを`反映する$モノトスル。 ◎ The className attribute must reflect the "class" content attribute.

@classList

取得子は、次のようにされた $DOMTokenList を返すモノトスル ⇒＃ `要素$tL ~SET 此れ, `属性oの局所~名$tL ~SET ^class ◎ ↓

この属性が返す $DOMTokenList ~objの`~token集合$tLは、`要素$の `~classes@ とも称される。 ◎ The classList attribute’s getter must return a DOMTokenList object whose associated element is the context object and whose associated attribute’s local name is class. The token set of this particular DOMTokenList object are also known as the element’s classes.

【 [`SameObject$] が指定されているので、各~要素とこの~objの各~instanceは，一対一に対応する。 】

@slot

`slot^l 属性oを`反映する$モノトスル。 ◎ The slot attribute must reflect the "slot" content attribute.

注記： ［ ^id, ^class, ^slot ］`属性o$nmは、要素の~nsにかかわらず どの要素~上にも現れ得るので、実質的に，（すべての~nsより）上位の大域~属性になる。 ◎ id, class, and slot are effectively superglobal attributes as they can appear on any element, regardless of that element’s namespace.

%element . $hasAttributes()

%element は属性oを 1 つでも［ 有するならば ~T ／ 有さないならば ~F ］を返す。 ◎ Returns true if element has attributes, and false otherwise.

%element . $getAttributeNames()

%element のすべての`属性o$の`有修飾~名$aを返す — 重複を包含し得る。 ◎ Returns the qualified names of all element’s attributes. Can contain duplicates.

%element . $getAttribute(qualifiedName )

%element は次を満たす`属性o$を［ 有するならば それらのうち最初のもの／ 有さないならば ~NULL ］を返す ⇒ `有修飾~名$a ~EQ %qualifiedName ◎ Returns element’s first attribute whose qualified name is qualifiedName, and null if there is no such attribute otherwise.

%element . $getAttributeNS(namespace , localName )

%element は次を満たす`属性o$を［ 有するならば それらのうち最初のもの／ 有さないならば ~NULL ］を返す ⇒ ［ `~ns$a ~EQ %namespace ］~AND［ `局所~名$a ~EQ %localName ］ ◎ Returns element’s attribute whose namespace is namespace and local name is localName, and null if there is no such attribute otherwise.

%element . $setAttribute(qualifiedName , value )

%element は次を満たす`属性o$を有するならば［ それらのうち最初のもの ］の`値$aを %value に設定する ⇒ `有修飾~名$a ~EQ %qualifiedName ◎ Sets the value of element’s first attribute whose qualified name is qualifiedName to value.

%element . $setAttributeNS(namespace , localName , value )

%element は次を満たす`属性o$を有するならば［ それらのうち最初のもの ］の`値$aを %value に設定する ⇒ ［ `~ns$a ~EQ %namespace ］~AND［ `局所~名$a ~EQ %localName ］ ◎ Sets the value of element’s attribute whose namespace is namespace and local name is localName to value.

%element . $removeAttribute(qualifiedName )

%element は次を満たす`属性o$を有するならば［ それらのうち最初のもの ］を %element から除去する ⇒ `有修飾~名$a ~EQ %qualifiedName ◎ Removes element’s first attribute whose qualified name is qualifiedName.

%element . $removeAttributeNS(namespace , localName )

%element は次を満たす`属性o$を有するならば［ それらのうち最初のもの ］を %element から除去する ⇒ ［ `~ns$a ~EQ %namespace ］~AND［ `局所~名$a ~EQ %localName ］ ◎ Removes element’s attribute whose namespace is namespace and local name is localName.

%element . $toggleAttribute(qualifiedName [, force])

%force に応じて：

• 省略されているならば、 %qualifiedName の有無を “切り替える” — すなわち，それがすでに在れば除去し，無ければ追加する。
• ~T ならば、 %qualifiedName を追加する。
• ~F ならば、 %qualifiedName を除去する。

その結果、 %qualifiedName が残っていれば ~T を, 無くなっていれば ~F を返す。

◎ If force is not given, "toggles" qualifiedName, removing it if it is present and adding it if it is not present. If force is true, adds qualifiedName. If force is false, removes qualifiedName. ◎ Returns true if qualifiedName is now present, and false otherwise.

%element . $hasAttribute(qualifiedName )

%element は次を満たす`属性o$を［ 有するならば ~T ／ 有さないならば ~F ］を返す ⇒ `有修飾~名$a ~EQ %qualifiedName ◎ Returns true if element has an attribute whose qualified name is qualifiedName, and false otherwise.

%element . $hasAttributeNS(namespace , localName )

%element は次を満たす`属性o$を［ 有するならば ~T ／ 有さないならば ~F ］を返す ⇒ ［ `~ns$a ~EQ %namespace ］~AND［ `局所~名$a ~EQ %localName ］ ◎ Returns true if element has an attribute whose namespace is namespace and local name is localName.

@hasAttributes()

被呼出時には、［ 此れの`属性o~list$は`空$ならば ~F ／ ~ELSE_ ~T ］を返すモノトスル。 ◎ The hasAttributes() method, when invoked, must return false if context object’s attribute list is empty, and true otherwise.

@attributes

取得子は、此れに結付けられている $NamedNodeMap を返すモノトスル。 ◎ The attributes attribute’s getter must return the associated NamedNodeMap.

@getAttributeNames()

被呼出時には、此れの`属性o~list$ %~list は［ `空$でないならば［ %~list 内の各 `属性o$の`有修飾~名$a ］からなる同じ順序の`~list$ ／ ~ELSE_ 新たな`~list$ ］を返すモノトスル。 ◎ The getAttributeNames() method, when invoked, must return the qualified names of the attributes in context object’s attribute list, in order, and a new list otherwise.

注記： 一意になることは保障されない。 ◎ These are not guaranteed to be unique.

@getAttribute(qualifiedName)

被呼出時には、次を走らすモノトスル： ◎ The getAttribute(qualifiedName) method, when invoked, must run these steps:

1. %属性o ~LET 此れの`属性oを名前により取得する$( %qualifiedName ) ◎ Let attr be the result of getting an attribute given qualifiedName and the context object.
2. ~RET ［ %属性o ~EQ ~NULL ならば ~NULL ／ ~ELSE_ %属性o の`値$a ］ ◎ If attr is null, return null. ◎ Return attr’s value.

@getAttributeNS(namespace, localName)

被呼出時には、次を走らすモノトスル： ◎ The getAttributeNS(namespace, localName) method, when invoked, must these steps:

1. %属性o ~LET 此れの`属性oを~nsと局所~名により取得する$( %namespace, %localName ) ◎ Let attr be the result of getting an attribute given namespace, localName, and the context object.
2. ~IF［ %属性o ~EQ ~NULL ］ ⇒ ~RET ~NULL ◎ If attr is null, return null.
3. ~RET %属性o の`値$a ◎ Return attr’s value.

@setAttribute(qualifiedName, value)

被呼出時には、次を走らすモノトスル： ◎ The setAttribute(qualifiedName, value) method, when invoked, must run these steps:

1. ~IF［ %qualifiedName は~XMLの `Name$prod 生成規則に合致しない ］ ⇒ ~THROW `InvalidCharacterError$E ◎ If qualifiedName does not match the Name production in XML, then throw an "InvalidCharacterError" DOMException.
2. ~IF［ 此れは`~HTML~ns$に属する ］~AND［ 此れの`~node文書$は`~HTML文書$である ］ ⇒ %qualifiedName ~SET `~ASCII小文字~化する$( %qualifiedName ) ◎ If the context object is in the HTML namespace and its node document is an HTML document, then set qualifiedName to qualifiedName in ASCII lowercase.
3. %属性o ~LET 此れの`属性o~list$内の［ `有修飾~名$a ~EQ %qualifiedName ］なる`属性o$のうち，`最初のもの？$ ◎ Let attribute be the first attribute in the context object’s attribute list whose qualified name is qualifiedName, and null otherwise.
4. ~IF［ %属性o ~EQ ~NULL ］ ⇒ 此れに`属性oを付加する$( 次のように設定された 新たな`属性o$ ) ⇒＃ `局所~名$a ~SET %qualifiedName, `値$a ~SET %value, `~node文書$ ~SET 此れの`~node文書$ ◎ If attribute is null, create an attribute whose local name is qualifiedName, value is value, and node document is context object’s node document, then append this attribute to context object, and then return.
5. ~ELSE ⇒ 此れの`属性oを変更する$( %属性o, %value ) ◎ Change attribute from context object to value.

@setAttributeNS(namespace, qualifiedName, value)

被呼出時には、次を走らすモノトスル： ◎ The setAttributeNS(namespace, qualifiedName, value) method, when invoked, must run these steps:

1. 此れの`属性o値を設定する$( %局所~名, %value, %接頭辞, %~ns ) ◎ Set an attribute value for the context object using localName, value, and also prefix and namespace.

@removeAttribute(qualifiedName)

被呼出時には、次を走らすモノトスル ⇒ 此れの`属性oを名前により除去する$( %qualifiedName ) ◎ The removeAttribute(qualifiedName) method, when invoked, must remove an attribute given qualifiedName and the context object, and then return undefined.

@removeAttributeNS(namespace, localName)

被呼出時には、次を走らすモノトスル ⇒ 此れの`属性oを~nsと局所~名により除去する$( %namespace, %localName ) ◎ The removeAttributeNS(namespace, localName) method, when invoked, must remove an attribute given namespace, localName, and context object, and then return undefined.

@hasAttribute(qualifiedName)

被呼出時には、次を走らすモノトスル： ◎ The hasAttribute(qualifiedName) method, when invoked, must run these steps:

1. ~RET ［ 此れは次を満たす`属性o$を`有する$ならば ~T ／ ~ELSE_ ~F ］ ⇒ `有修飾~名$a ~EQ %qualifiedName ◎ Return true if the context object has an attribute whose qualified name is qualifiedName, and false otherwise.

@toggleAttribute(qualifiedName, force)

被呼出時には、次を走らすモノトスル： ◎ The toggleAttribute(qualifiedName, force) method, when invoked, must run these steps:

1. %結果 ~LET ［ 次が満たされるならば ~T ／ ~ELSE_ ~F ］ ⇒ ［ %force ~EQ ~T ］~OR［［ %force は与えられてない ］~AND［ %属性o ~EQ ~NULL ］］ ◎ ↓
2. ~IF［ %結果 ~EQ ~T ］~AND［ %属性o ~EQ ~NULL ］ ⇒ 此れに`属性oを付加する$( 次のように設定された 新たな`属性o$ ) ⇒＃ `局所~名$a ~SET %qualifiedName, `値$a ~SET 空~文字列, `~node文書$ ~SET 此れの`~node文書$ ◎ If attribute is null, then: • If force is not given or is true, create an attribute whose local name is qualifiedName, value is the empty string, and node document is the context object’s node document, then append this attribute to the context object, and then return true. • Return false.
3. ~ELIF［ %結果 ~EQ ~F ］~AND［ %属性o ~NEQ ~NULL ］ ⇒＃ 此れの`属性oを名前により除去する$( %qualifiedName )； ◎ Otherwise, if force is not given or is false, remove an attribute given qualifiedName and the context object, and then return false.
4. ~RET %結果 ◎ Return true.

@hasAttributeNS(namespace, localName)

被呼出時には、次を走らすモノトスル： ◎ The hasAttributeNS(namespace, localName) method, when invoked, must run these steps:

1. ~RET ［ 此れは次を満たす`属性o$を`有する$ならば ~T ／ ~ELSE_ ~F ］ ⇒ ［ `~ns$a ~EQ %namespace ］~AND［ `局所~名$a ~EQ %localName ］ ◎ Return true if the context object has an attribute whose namespace is namespace and local name is localName, and false otherwise.

@getAttributeNode(qualifiedName)

被呼出時には、次を走らすモノトスル ⇒ ~RET 此れの`属性oを名前により取得する$( %qualifiedName ) ◎ The getAttributeNode(qualifiedName) method, when invoked, must return the result of getting an attribute given qualifiedName and context object.

@getAttributeNodeNS(namespace, localName)

被呼出時には、次を走らすモノトスル ⇒ ~RET 此れの`属性oを~nsと局所~名により取得する$( %namespace, %localName ) ◎ The getAttributeNodeNS(namespace, localName) method, when invoked, must return the result of getting an attribute given namespace, localName, and the context object.

@setAttributeNode(attr)

@setAttributeNodeNS(attr)

これらのいずれも，被呼出時には、次を走らすモノトスル ⇒ ~RET 此れの`属性oを設定する$( %attr ) ◎ The setAttributeNode(attr) and setAttributeNodeNS(attr) methods, when invoked, must return the result of setting an attribute given attr and the context object.

@removeAttributeNode(attr)

被呼出時には、次を走らすモノトスル： ◎ The removeAttributeNode(attr) method, when invoked, must run these steps:

1. ~IF［ %attr ~NIN 此れの`属性o~list$ ］ ⇒ ~THROW `NotFoundError$E ◎ If context object’s attribute list does not contain attr, then throw a "NotFoundError" DOMException.
2. 此れから`属性oを除去する$( %attr ) ◎ Remove attr from context object.
3. ~RET %attr ◎ Return attr.

%shadow = %element . $attachShadow(init)

%element 用に`~shadow根$を作成した上で，それを返す。 ◎ Creates a shadow root for element and returns it.

%shadow = %element . $shadowRoot

%element の`~shadow根$elm %~shadow は非~NULL，かつ %~shadow の［ `~mode$sR ~EQ `open^l ］ならば %~shadow を返す。 他の場合は ~NULL を返す。 ◎ Returns element’s shadow root, if any, and if shadow root’s mode is "open", and null otherwise.

@attachShadow(init)

被呼出時には、次を走らすモノトスル： ◎ The attachShadow(init) method, when invoked, must run these steps:

1. ~IF［ 此れの`~ns$ ~NEQ `~HTML~ns$ ］ ⇒ ~THROW `NotSupportedError$E ◎ If context object’s namespace is not the HTML namespace, then throw a "NotSupportedError" DOMException.

2. ~IF［ 此れの`局所~名$は 次のいずれにも該当しない ］ ⇒ ~THROW `NotSupportedError$E：

   • `妥当な~custom要素~名$
   • `article^l, `aside^l, `blockquote^l, `body^l, `div^l, `footer^l, `h1^l, `h2^l, `h3^l, `h4^l, `h5^l, `h6^l, `header^l, `nav^l, `nav^l, `p^l, `section^l, `span^l
   ◎ If context object’s local name is not a valid custom element name, "article", "aside", "blockquote", "body", "div", "footer", "h1", "h2", "h3", "h4", "h5", "h6", "header", "main" "nav", "p", "section", or "span", then throw a "NotSupportedError" DOMException.
3. ~IF［ 此れは`~shadow~host$である ］ ⇒ ~THROW `InvalidStateError$E ◎ If context object is a shadow host, then throw an "InvalidStateError" DOMException.
4. %~shadow ~LET 次のようにされた，新たな`~shadow根$ ⇒＃ `~node文書$ ~SET 此れの`~node文書$, `~host$ ~SET 此れ, `~mode$sR ~SET %init の $ShadowRootInit.mode ◎ Let shadow be a new shadow root whose node document is context object’s node document, host is context object, and mode is init’s mode.
5. 此れの`~shadow根$elm ~SET %~shadow ◎ Set context object’s shadow root to shadow.
6. ~RET %~shadow ◎ Return shadow.

@shadowRoot

取得子は、次を走らすモノトスル： ◎ The shadowRoot attribute’s getter must run these steps:

1. %~shadow ~LET 此れの `~shadow根$elm ◎ Let shadow be context object’s shadow root.
2. ~IF［ %~shadow ~EQ ~NULL ］~OR［ %~shadow の`~mode$sR ~EQ `closed^l ］ ⇒ ~RET ~NULL ◎ If shadow is null or its mode is "closed", then return null.
3. ~RET %~shadow ◎ Return shadow.

%element . $closest(selectors)

%element の`広義先祖$であって, %selectors に合致するような`要素$が［ 在れば，それらのうち %element に最も近いもの ／ 無ければ ~NULL ］を返す。 ◎ Returns the first (starting at element) inclusive ancestor that matches selectors, and null otherwise.

%element . $matches(selectors)

%element の`根$に対し %selectors を照合した結果，［ %element が得られるならば ~T ／ ~ELSE_ ~F ］を返す。 ◎ Returns true if matching selectors against element’s root yields element, and false otherwise.

@closest(selectors)

被呼出時には、次を走らすモノトスル： ◎ The closest(selectors) method, when invoked, must run these steps:

1. %選択子 ~LET `選択子として構文解析する$( %selectors ) `SELECTORS4$r ◎ Let s be the result of parse a selector from selectors. [SELECTORS4]
2. ~IF［ %選択子 ~EQ `失敗^i ］ ⇒ ~THROW `SyntaxError$E ◎ If s is failure, throw a "SyntaxError" DOMException.
3. %要素 ~LET 此れ ◎ ↓

4. ~WHILE［ %要素 は`要素$である ］：

   1. ~IF［ `要素に対し選択子を照合する$( %要素, %選択子, 此れのみからなる`~scope-ps要素$の集合 ) ~EQ `成功^i ］ ⇒ ~RET %要素
   2. %要素 ~SET %要素 の`親$
   `SELECTORS4$r ◎ Let elements be context object’s inclusive ancestors that are elements, in reverse tree order. ◎ For each element in elements, if match a selector against an element, using s, element, and :scope element context object, returns success, return element. [SELECTORS4]
5. ~RET ~NULL ◎ Return null.

@matches(selectors)

@webkitMatchesSelector(selectors)

これらのいずれも，被呼出時には、次を走らすモノトスル： ◎ The matches(selectors) and webkitMatchesSelector(selectors) methods, when invoked, must run these steps:

1. %選択子 ~LET `選択子として構文解析する$( %selectors ) `SELECTORS4$r ◎ Let s be the result of parse a selector from selectors. [SELECTORS4]
2. ~IF［ %選択子 ~EQ `失敗^i ］ ⇒ ~THROW `SyntaxError$E ◎ If s is failure, throw a "SyntaxError" DOMException.
3. ~RET ［ 次が満たされるならば ~T ／ ~ELSE_ ~F ］ ⇒ `要素に対し選択子を照合する$( 此れ†, %選択子, 此れのみからなる`~scope-ps要素$の集合 ) ~EQ `成功^i `SELECTORS4$r ◎ Return true if the result of match a selector against an element, using s, element, and :scope element context object, returns success, and false otherwise. [SELECTORS4]

【† 原文は 2 個目の“此れ” の代わりに~~未定義の変数 “%element” が記されているが、誤記と見られる。 】

@getElementsByTagName(qualifiedName)

被呼出時には、此れに対する， %qualifiedName を`有修飾~名に持つ要素の~list$を返すモノトスル。 ◎ The getElementsByTagName(qualifiedName) method, when invoked, must return the list of elements with qualified name qualifiedName for context object.

@getElementsByTagNameNS(namespace, localName)

被呼出時には、此れに対する， ( %namespace, %localName ) を `( ~ns, 局所~名 ) に持つ要素の~list$を返すモノトスル。 ◎ The getElementsByTagNameNS(namespace, localName) method, when invoked, must return the list of elements with namespace namespace and local name localName for context object.

@getElementsByClassName(classNames)

被呼出時には、此れに対する， %classNames を`~classesに含む要素の~list$を返すモノトスル。 ◎ The getElementsByClassName(classNames) method, when invoked, must return the list of elements with class names classNames for context object.

`要素$ %要素 の `隣に~nodeを挿入する@ ときは、所与の ( 文字列 %where, `~node$ %~node ) に対し， `~ASCII小文字~化する$( %where ) の結果に応じて： ◎ To insert adjacent, given an element element, string where, and a node node, run the steps associated with the first ASCII case-insensitive match for where:

`beforebegin^l

1. ~IF［ %要素 の`親$ ~EQ ~NULL ］ ⇒ ~RET ~NULL ◎ If element’s parent is null, return null.
2. ~RET %要素 の`親$の中で`~nodeを子の前に前挿入する$( %~node, %要素 ) ◎ Return the result of pre-inserting node into element’s parent before element.

`afterbegin^l

1. ~RET %要素 の中で`~nodeを子の前に前挿入する$( %~node, %要素 の`最初の子？$ ) ◎ Return the result of pre-inserting node into element before element’s first child.

`beforeend^l

1. ~RET %要素 の中で`~nodeを子の前に前挿入する$( %~node, ~NULL ) ◎ Return the result of pre-inserting node into element before null.

`afterend^l

1. ~IF［ %要素 の`親$ ~EQ ~NULL ］ ⇒ ~RET ~NULL ◎ If element’s parent is null, return null.
2. ~RET %要素 の`親$の中で`~nodeを子の前に前挿入する$( %~node, %要素 の`次-同胞？$ ) ◎ Return the result of pre-inserting node into element’s parent before element’s next sibling.

その他

1. ~THROW `SyntaxError$E ◎ Throw a "SyntaxError" DOMException.

@insertAdjacentElement(where, element)

被呼出時には、次を走らすモノトスル： ◎ The insertAdjacentElement(where, element) method, when invoked, must＼

1. ~RET %element の`隣に~nodeを挿入する$( %where, 此れ ) ◎ return the result of running insert adjacent, given context object, where, and element.

@insertAdjacentText(where, data)

被呼出時には、次を走らすモノトスル： ◎ The insertAdjacentText(where, data) method, when invoked, must run these steps:

1. %text ~LET `新たな~Text~node$( %data, 此れの`~node文書$ ) ◎ Let text be a new Text node whose data is data and node document is context object’s node document.
2. 此れの`隣に~nodeを挿入する$( %where, %text ) ◎ Run insert adjacent, given context object, where, and text.

注記： この~methは何も返さない — それを設計しようとする前からすでに存在していたので。 ◎ This method returns nothing because it existed before we had a chance to design it.

【 参考： `insertAdjacentHTML()$m `DOM-Parsing$r という同類の便利~methもある。 】

4.10. ^@CharacterData ~ifc

注記： $CharacterData は抽象~ifcであり，`~node$として存在するものではない。 それは［ $Text, $ProcessingInstruction, $Comment ］`~node$から利用される。 ◎ CharacterData is an abstract interface and does not exist as node. It is used by Text, ProcessingInstruction, and Comment nodes.

この~ifcを継承する~ifcを実装する`~node$を総称して， `文字~data~node@ という（すなわち， $Text （ $CDATASection も含む）, $ProcessingInstruction, $Comment ）。

【 この用語は、簡潔に記述するために，この訳に導入した非公式な用語である。 （機能上は異なるものだが）多くの処理で，これらは同等に扱われるので。 】

`文字~data~node$ %node の `~dataを置換する@ ときは、所与の ( %offset, %count, %data ) に対し，次を走らす： ◎ To replace data of node node with offset offset, count count, and data data, run these steps:

1. %長さ ~LET %node の`長さ$ ◎ Let length be node’s length.
2. ~IF［ %offset ~GT %長さ ］ ⇒ ~THROW `IndexSizeError$E ◎ If offset is greater than length, then throw an "IndexSizeError" DOMException.
3. ~IF［ %offset ~PLUS %count ~GT %長さ ］ ⇒ %count ~SET %長さ ~MINUS %offset ◎ If offset plus count is greater than length, then set count to length minus offset.
4. %node 用に種別 `characterData^l の`変異~記録を~queueする$( ~NULL, ~NULL, %node の`~data$, « », « », ~NULL, ~NULL ) ◎ Queue a mutation record of "characterData" for node with null, null, node’s data, « », « », null, and null.
5. %挿入点 ~LET %node の`~data$の中の， %offset 個目の`符号単位$の直後を指す位置（ %offset ~EQ 0 は先頭を指す） ◎ ↓
6. %挿入点 から末尾側に在る %count 個の`符号単位$を除去する ◎ ↓
7. %挿入点 に %data を挿入する ◎ Insert data into node’s data after offset code units. ◎ Let delete offset be offset + data’s length. ◎ Starting from delete offset code units, remove count code units from node’s data.
8. %差分 ~LET %data の`長さ$jStr ~MINUS %count ◎ ↓

9. ~EACH( `~live範囲o$ %範囲o ) に対し：

   1. ~IF［ %範囲o の`始端~node$ ~EQ %node ］：

      1. ~IF［ %offset ~LT %範囲o の`始端~offset$ ~LTE %offset ~PLUS %count ］ ⇒ %範囲o の`始端~offset$ ~SET %offset
      2. ~IF［ %範囲o の`始端~offset$ ~GT %offset ~PLUS %count ］ ⇒ %範囲o の`始端~offset$ ~INCBY %差分

   2. ~IF［ %範囲o の`終端~node$ ~EQ %node ］：

      1. ~IF［ %offset ~LT %範囲o の`終端~offset$ ~LTE %offset ~PLUS %count ］ ⇒ %範囲o の`終端~offset$ ~SET %offset

         【 %範囲o の終端がちょうど置換される~~範囲の末尾を指している場合も，終端は置換した~~範囲の先頭に “寄せられる” ことになる。 】

      2. ~IF［ %範囲o の`終端~offset$ ~GT %offset ~PLUS %count ］ ⇒ %範囲o の`終端~offset$ ~INCBY %差分
   ◎ For each live range whose start node is node and start offset is greater than offset but less than or equal to offset plus count, set its start offset to offset. ◎ For each live range whose end node is node and end offset is greater than offset but less than or equal to offset plus count, set its end offset to offset. ◎ For each live range whose start node is node and start offset is greater than offset plus count, increase its start offset by data’s length and decrease it by count. ◎ For each live range whose end node is node and end offset is greater than offset plus count, increase its end offset by data’s length and decrease it by count.
10. ~IF［ %node は $Text ~nodeである ］~AND［ %node の`親$ ~NEQ ~NULL ］ ⇒ %node の`親$用の`子~text内容~変更-時の手続き$を走らす ◎ If node is a Text node and its parent is not null, run the child text content change steps for node’s parent.

`文字~data~node$ %node から `~dataの部分文字列@ を得るときは、所与の ( %offset, %count ) に対し，次を走らす： ◎ To substring data with node node, offset offset, and count count, run these steps:

1. ~IF［ %offset ~PLUS %count ~GT %長さ ］ ⇒ %count ~LET %長さ ~MINUS %offset ◎ If offset plus count is greater than length, return a string whose value is the code units from the offsetth code unit to the end of node’s data, and then return.
2. ~RET %node の`~data$の［ %offset 個目の`符号単位$の直後（ %offset ~EQ 0 なら先頭）から， %count 個の`符号単位$ ］並びからなる文字列 ◎ Return a string whose value is the code units from the offsetth code unit to the offset+countth code unit in node’s data.

@data

取得子は、此れの`~data$を返すモノトスル。 ◎ The data attribute’s getter must return context object’s data.＼

設定子は、次を走らすモノトスル ⇒ 此れの`~dataを置換する$( 0, 此れの`長さ$, 所与の値 ) ◎ Its setter must replace data with node context object, offset 0, count context object’s length, and data new value.

@length

取得子は、此れの`長さ$を返すモノトスル。 ◎ The length attribute’s getter must return context object’s length.

@substringData(offset, count)

被呼出時には、此れの`~dataの部分文字列$( %offset, %count ) を返すモノトスル ◎ The substringData(offset, count) method, when invoked, must return the result of running substring data with node context object, offset offset, and count count.

@appendData(data)

被呼出時には、次を走らすモノトスル ⇒ 此れの`~dataを置換する$( 此れの`長さ$, 0, %data ) ◎ The appendData(data) method, when invoked, must replace data with node context object, offset context object’s length, count 0, and data data.

@insertData(offset, data)

被呼出時には、次を走らすモノトスル ⇒ 此れの`~dataを置換する$( %offset, 0, %data ) ◎ The insertData(offset, data) method, when invoked, must replace data with node context object, offset offset, count 0, and data data.

@deleteData(offset, count)

被呼出時には、次を走らすモノトスル ⇒ 此れの`~dataを置換する$( %offset, %count, 空~文字列 ) ◎ The deleteData(offset, count) method, when invoked, must replace data with node context object, offset offset, count count, and data the empty string.

@replaceData(offset, count, data)

被呼出時には、次を走らすモノトスル ⇒ 此れの`~dataを置換する$( %offset, %count, %data ) ◎ The replaceData(offset, count, data) method, when invoked, must replace data with node context object, offset offset, count count, and data data.

4.11. ^@Text ~ifc

%text = new $Text([data = ""])

`~data$が %data にされた，新たな $Text `~node$を返す。 ◎ Returns a new Text node whose data is data.

%text . $splitText(offset)

所与の %offset の地点で`~data$を分割し，残りの部分を $Text `~node$として返す。 ◎ Splits data at the given offset and returns the remainder as Text node.

%text . $wholeText

隣接するすべての`同胞$ $Text `~node$の`~data$を連結した結果を返す。 ◎ Returns the combined data of all direct Text node siblings.

`新たな~Text~node@( %文字列, %文書 ) という表記は、次のように設定された 新たな $Text `~node$を意味する ⇒ ( `~data$, `~node文書$ ) ~SET ( %文字列, %文書 )

【 この表記は、簡潔に記述するため，この訳に導入したものである。 】

`狭義の~Text~node@ とは、 $CDATASection `~node$でない $Text `~node$である。 ◎ An exclusive Text node is a Text node that is not a CDATASection node.

~node %~node を含む `連続的な~Text~node列@ とは、条件［ $Text `~node$である ］を満たす， %~node を含む`連続的な同胞~列$である。 ◎ The contiguous Text nodes of a node node are node, node’s previous sibling Text node, if any, and its contiguous Text nodes, and node’s next sibling Text node, if any, and its contiguous Text nodes, avoiding any duplicates.

~node %~node を含む `連続的な狭義の~Text~node列@ とは、条件［ `狭義の~Text~node$である ］を満たす， %~node を含む`連続的な同胞~列$である。 ◎ The contiguous exclusive Text nodes of a node node are node, node’s previous sibling exclusive Text node, if any, and its contiguous exclusive Text nodes, and node’s next sibling exclusive Text node, if any, and its contiguous exclusive Text nodes, avoiding any duplicates.

【 この訳では、次の手続きを導入して，原文による “連続的な…” の（再帰的な）定義を、等価な（かつ平坦化された平易な）定義に変形している。 】

`~node$ %~node の `子~text内容@ は、次を`連結-$した結果である ⇒ `木~順序$による，［ %~node の`子$のうち $Text ~nodeであるもの ］すべての`~data$ ◎ The child text content of a node node is the concatenation of the data of all the Text node children of node, in tree order.

`適用-可能な仕様$は、`~node$用に `子~text内容~変更-時の手続き@ を定義してもヨイ。 ◎ This and other specifications may define child text content change steps for nodes.

@Text(data)

この構築子の被呼出時には、`新たな~Text~node$( %data, `現在の大域~obj$に`結付けられている文書$ ) を返すモノトスル ◎ The Text(data) constructor, when invoked, must return a new Text node whose data is data and node document is current global object’s associated Document.

`~Text~nodeを分割する@ ときは、所与の ( $Text `~node$ %node, ~offset %offset ) に対し，次を走らす： ◎ To split a Text node node with offset offset, run these steps:

1. %count ~LET %長さ ~MINUS %offset ◎ Let count be length minus offset.
2. %新-~data ~LET 此れの`~dataの部分文字列$( %offset, %count ) ◎ Let new data be the result of substringing data with node node, offset offset, and count count.
3. %新-~node ~LET `新たな~Text~node$( %新-~data, %node の`~node文書$ ) ◎ Let new node be a new Text node, with the same node document as node. Set new node’s data to new data.
4. %親 ~LET %node の`親$ ◎ Let parent be node’s parent.

5. ~IF［ %親 ~NEQ ~NULL ］： ◎ If parent is not null, then:

   1. %親 の中で`~nodeを子の前に挿入する$( %新-~node, %node の`次-同胞？$ ) ◎ Insert new node into parent before node’s next sibling.

   2. ~EACH( `~live範囲o$ %範囲o ) に対し： ◎ ↓

      1. ~IF［ %範囲o の`始端~node$ ~EQ %node ］~AND［ %範囲o の`始端~offset$ ~GT %offset ］ ⇒＃ %範囲o の`始端~node$ ~SET %新-~node； %範囲o の`始端~offset$ ~DECBY %offset ◎ For each live range whose start node is node and start offset is greater than offset, set its start node to new node and decrease its start offset by offset.
      2. ~IF［ %範囲o の`終端~node$ ~EQ %node ］~AND［ %範囲o の`終端~offset$ ~GT %offset ］ ⇒＃ %範囲o の`終端~node$ ~SET %新-~node； %範囲o の`終端~offset$ ~DECBY %offset ◎ For each live range whose end node is node and end offset is greater than offset, set its end node to new node and decrease its end offset by offset.
      3. ~IF［ %範囲o の`始端~node$ ~EQ %親 ］~AND［ %範囲o の`始端~offset$ ~EQ %node の`指数$ ~PLUS 1 ］ ⇒ %範囲o の`始端~offset$ ~INCBY 1 ◎ For each live range whose start node is parent and start offset is equal to the index of node plus 1, increase its start offset by 1.
      4. ~IF［ %範囲o の`終端~node$ ~EQ %親 ］~AND［ %範囲o の`終端~offset$ ~EQ %node の`指数$ ~PLUS 1 ］ ⇒ %範囲o の`終端~offset$ ~INCBY 1 ◎ For each live range whose end node is parent and end offset is equal to the index of node plus 1, increase its end offset by 1.
6. %node の`~dataを置換する$( %offset, %count, 空~文字列 ) ◎ Replace data with node node, offset offset, count count, and data the empty string.
7. ~RET %新-~node ◎ Return new node.

@splitText(offset)

被呼出時には、次を走らすモノトスル ⇒ ~RET `~Text~nodeを分割する$( 此れ, %offset ) ◎ The splitText(offset) method, when invoked, must split context object with offset offset.

@wholeText

取得子は、次を`連結-$した結果を返すモノトスル ⇒ `木~順序$による，此れを含む`連続的な~Text~node列$を成すすべての~nodeの`~data$。 ◎ The wholeText attribute’s getter must return the concatenation of the data of the contiguous Text nodes of the context object, in tree order.

4.12. ^@CDATASection ~ifc

4.13. ^@ProcessingInstruction ~ifc

@target

取得子は、此れの`~target$pIを返すモノトスル。 ◎ The target attribute must return the target.

4.14. ^@Comment ~ifc

%comment = new $Comment([data = ""])

`~data$が %data にされた，新たな $Comment `~node$を返す。 ◎ Returns a new Comment node whose data is data.

@Comment(data)

この構築子の被呼出時には、次のように設定された 新たな $Comment `~node$を返すモノトスル ⇒＃ `~data$ ~SET %data, `~node文書$ ~SET `現在の大域~obj$に`結付けられている文書$ ◎ The Comment(data) constructor, when invoked, must return a new Comment node whose data is data and node document is current global object’s associated Document.

5.1. “DOM Ranges” 序論

［ $StaticRange ／ $Range ］~obj （ `範囲o$ ）は`~node木$の中の連続する内容を表現する。 各 `範囲o$ は、`境界点$と呼ばれる［ ( `始端$, `終端$ ) が成す`~tuple$ ］を持つ。 各 `境界点$は、 ( `~node$bp, `~offset$bp ) が成す`~tuple$である。 言い換えれば、`範囲o$は`~node木$の中の 2 つの`境界点$に挟まれる `中身@rg を表現する。 ◎ StaticRange and Range objects (ranges) represent a sequence of content within a node tree. Each range has a start and an end which are boundary points. A boundary point is a tuple consisting of a node and an offset. So in other words, a range represents a piece of content within a node tree between two boundary points.

`範囲o$は、編集における 内容の選択や複製に よく利用される。 例えば 次の`~node木$が与えられたとき： ◎ Ranges are frequently used in editing for selecting and copying content.

1. `要素$: `p^e
   1. `要素$: `img^e, ^src=`insanity-wolf^l ^alt=`Little-endian BOM; decode as big-endian!^l
   2. $Text:  CSS 2.1 syndata is 
   3. `要素$: `em^e
      1. $Text: awesome
   4. $Text: !

次の様にして， `syndata is awes^l の並びを表現する`範囲o$が得られる（変数［ %p ／ %em ］には［ `p^e ／ `em^e ］`要素$が割当されているとする）： ◎ In the node tree above, a range can be used to represent the sequence “syndata is awes”. Assuming p is assigned to the p element, and em to the em element, this would be done as follows:

var %range = new Range(),
    %text1 = %p.childNodes[1],
    %text2 = %em.firstChild
%range.setStart(%text1, 9) /* 
先頭の空白も数に入れる
◎
do not forget the leading space
 */
%range.setEnd(%text2, 4)
/* 
%range を文字列化-した結果は、今や先に示した文字列になる
◎
range now stringifies to the aforementioned quote
 */

注記： `範囲o$は、上の`~node木$の ^src や ^alt などの`属性o$は表現できない。 `範囲o$は`~node$用に限り有用になる。 ◎ Attributes such as src and alt in the node tree above cannot be represented by a range. Ranges are only useful for nodes.

$StaticRange ~objと違って、 $Range ~objは，`~node木$に対する変異に影響される。 なので、`~live範囲o$とも称される。 その種の変異によりそれらが無効化されることはなく，可能なら内容の同じ部分を表現するようにされる。 `~live範囲o$は、`~node木$に対する変異 — 自身が表現する`中身$rgの一部が変異したときなど — に伴い，必要に応じて自身も改変され得る。 ◎ Range objects, unlike StaticRange objects, are affected by mutations to the node tree. Therefore they are also known as live ranges. Such mutations will not invalidate them and will try to ensure that it still represents the same piece of content. Necessarily, a live range might itself be modified as part of the mutation to the node tree when, e.g., part of the content it represents is mutated.

詳細は、次に挙げる各種~algo／~methを見よ ⇒＃ `~nodeを子の前に挿入する$, `子を除去する$ $Node.normalize(), `~dataを置換する$, `~Text~nodeを分割する$ ◎ See the insert and remove algorithms, the normalize() method, and the replace data and split algorithms for the hairy details.

【 例えば，範囲oの境界点が ある~nodeの “内部” を指していて, その~nodeが木から除去された場合、その境界点は “~nodeが抜けた穴” を指すようにされる（始端と終端が別々の木の中を指さないようにされる）。 始端と終端の両者が同じ~nodeの内部を指していたとしても、除去された~nodeの内部を指すことはなく，それらは同じ “穴” を指す様に畳まれることになる。 】

5.2. 境界点

`境界点@ とは、［ `~node@bp （`~node$）, `~offset@bp （非負~整数） ］が成す`~tuple$である。 ◎ A boundary point is a tuple consisting of a node (a node) and an offset (a non-negative integer).

【 以下では，所与の［ `~node$ %node, `~offset$bp %offset ］で初期化された`境界点$を、 “境界点( %node, %offset )” の様に表記する。 】

注記： 正しい`境界点$の`~offset$bpは、 0 以上, `境界点$の`~node$bpの`長さ$以下になる。 ◎ A correct boundary point’s offset will be between 0 and the boundary point’s node’s length, inclusive.

`境界点$ %A の［ `境界点$ %B に `相対的な位置bp@ ］が， %B ［ `より前@i ／ `に等しい@i ／ `より後@i ］のいずれかになるかは、次に従って決定される： ◎ The position of a boundary point (nodeA, offsetA) relative to a boundary point (nodeB, offsetB) is before, equal, or after, as returned by these steps:

【 この~algoは、 2 つの境界点に対し，上に示した様な模式図における位置関係（左側が “より前” ）を算出する。 】

1. ( %nodeA, %offsetA, %nodeB, %offsetB ) ~LET ( %A の`~node$bp, %A の`~offset$bp, %B の`~node$bp, %B の`~offset$bp ) ◎ ↑
2. ~Assert： %nodeA の`根$ ~EQ %nodeB の`根$ ◎ Assert: nodeA and nodeB have the same root.
3. ~IF［ %nodeA ~EQ %nodeB ］ ⇒ ~RET ［ %offsetA ~LT %offsetB ならば `より前$i ／ %offsetA ~EQ %offsetB ならば `に等しい$i ／ %offsetA ~GT %offsetB ならば `より後$i ］ ◎ If nodeA is nodeB, then return equal if offsetA is offsetB, before if offsetA is less than offsetB, and after if offsetA is greater than offsetB.
4. ~IF［ %nodeA は %nodeB に`後続-$する ］ ⇒ ~RET %B は %A ［ `より前$i ならば `より後$i ／ `より後$i ならば `より前$i ］ ◎ If nodeA is following nodeB, then if the position of (nodeB, offsetB) relative to (nodeA, offsetA) is before, return after, and if it is after, return before.

5. ~IF［ %nodeA は %nodeB の`先祖$である ］： ◎ If nodeA is an ancestor of nodeB:

   1. %子 ~LET %nodeB ◎ Let child be nodeB.
   2. ~WHILE［ %子 の`親$ ~NEQ %nodeA ］ ⇒ %子 ~SET %子 の`親$ ◎ While child is not a child of nodeA, set child to its parent.
   3. ~IF［ %子 の`指数$ ~LT %offsetA ］ ⇒ ~RET `より後$i ◎ If child’s index is less than offsetA, then return after.
6. ~RET `より前$i ◎ Return before.

5.3. ^@AbstractRange ~ifc

$AbstractRange ~ifcを実装する~objは単に `範囲o@ とも称される。 ◎ Objects implementing the AbstractRange interface are known as ranges.

【 一般語の “~~範囲” と区別し易くするため、この訳では， “°” を付けて “範囲o” と記すことにする（ “DOM range”, “~~範囲~obj” などの呼称もあるが）。 】

各 `範囲o$には、 2 つの`境界点$ `始端@, `終端@ が結付けられる。 ◎ A range has two associated boundary points — a start and end.

便宜のため、`範囲o$の： ◎ For convenience,＼

• ( `始端~node@, `始端~offset@ ) は、順に，`始端$の ( `~node$bp, `~offset$bp ) を指すとする。 ◎ a range’s start node is its start’s node, its start offset is its start’s offset,＼
• ( `終端~node@, `終端~offset@ ) は、順に，`終端$の ( `~node$bp, `~offset$bp ) を指すとする。 ◎ its end node is its end’s node, and its end offset is its end’s offset.

所与の`範囲o$は、次を満たすとき `畳まれて@ いるとされる ⇒ ［ `始端~node$ ~EQ `終端~node$ ］~AND［ `始端~offset$ ~EQ `終端~offset$ ］ ◎ A range is collapsed if its start node is its end node and its start offset is its end offset.

%node = %range . $startContainer

%range の`始端~node$を返す。 ◎ Returns range’s start node.

%offset = %range . $startOffset

%range の`始端~offset$を返す。 ◎ Returns range’s start offset.

%node = %range . $endContainer

%range の`終端~node$を返す。 ◎ Returns range’s end node.

%offset = %range . $endOffset

%range の`終端~offset$を返す。 ◎ Returns range’s end offset.

%collapsed = %range . $collapsed

%range は`畳まれて$いるならば ~T を, 他の場合は~F を返す。 ◎ Returns true if range is collapsed, and false otherwise.

@startContainer

取得子は、此れの`始端~node$を返すモノトスル。 ◎ The startContainer attribute’s getter must return the context object’s start node.

@startOffset

取得子は、此れの`始端~offset$を返すモノトスル。 ◎ The startOffset attribute’s getter must return the context object’s start offset.

@endContainer

取得子は、此れの`終端~node$を返すモノトスル。 ◎ The endContainer attribute’s getter must return the context object’s end node.

@endOffset

取得子は、此れの`終端~offset$を返すモノトスル。 ◎ The endOffset attribute’s getter must return the context object’s end offset.

@collapsed

取得子は、［ 此れは次を満たすならば ~T ／ ~ELSE_ ~F ］を返すモノトスル ⇒ `畳まれて$いる ◎ The collapsed attribute’s getter must return true if the context object is collapsed, and false otherwise.

5.4. ^@StaticRange ~ifc

将来~versionの ^StaticRange ~ifcは、例外を投出しない構築子を供することになる。 ◎ A future version of the StaticRange interface will provide a non-throwing constructor.

5.5. ^@Range ~ifc

$Range ~ifcを実装する~objは単に `~live範囲o@ とも称される。 ◎ Objects implementing the Range interface are known as live ranges.

注記： `木$を改変する~algo（特に， `~nodeを子の前に挿入する$, `子を除去する$, `~dataを置換する$, `~Text~nodeを分割する$ ）は、その`木$に結付けられている一連の`~live範囲o$も改変する。 ◎ Algorithms that modify a tree (in particular the insert, remove, replace data, and split algorithms) modify live ranges associated with that tree.

`~live範囲o$の `根@rg とは、その`始端~node$の`根$である。 ◎ The root of a live range is the root of its start node.

【 `終端~node$の`根$と同じになる（常にそうなるように拘束される）。 各 `~live範囲o$は、その作成-時からずっと，同じある`~node木$に結付けられ続ける — 言い換えれば、`根$rgは変化しない。 （仕様には明示的にそう述べられてはいないが、各種~algoの挙動から，そう結論できる。 一般の`範囲o$についても同じことが言えるかどうかは、はっきりしない。） 】

次をいずれも満たす`~node$ %node は、`~live範囲o$ %範囲o に `包含され@ ているとされる： ◎ A node node is contained in a live range range if＼

• %node の`根$ ~EQ %範囲o の`根$rg ◎ node’s root is range’s root, and ＼
• `境界点$( %node, 0 ) は %範囲o の`始端$`より後$i ◎ (node, 0) is after range’s start, and＼
• `境界点$( %node, %node の`長さ$ ) は %範囲o の`終端$`より前$i ◎ (node, node’s length) is before range’s end.

次のいずれかを満たす`~node$ %node は、`~live範囲o$ %範囲o に `部分的に包含され@ ているとされる： ◎ A node is partially contained in a live range if＼

• ［ %node は %範囲o の`始端~node$の`広義先祖$である ］~AND［ %node は %範囲o の`終端~node$の`広義先祖$でない ］ ◎ it’s an inclusive ancestor of the live range’s start node but not its end node, or＼
• ［ %node は %範囲o の`始端~node$の`広義先祖$でない ］~AND［ %node は %範囲o の`終端~node$の`広義先祖$である ］ ◎ vice versa.

%range = new $Range()

新たな`~live範囲o$を返す。 ◎ Returns a new live range.

@Range()

この構築子の被呼出時には、次を走らすモノトスル：

1. %文書 ~LET `現在の大域~obj$に`結付けられている文書$
2. ~RET 次のように設定された 新たな $Range ⇒＃ `始端$ ~SET `境界点$( %文書, 0 ) , `終端$ ~SET `境界点$( %文書, 0 )

◎ The Range() constructor, when invoked, must return a new live range with (current global object’s associated Document, 0) as its start and end.

%container = %range . $commonAncestorContainer

%range の［ `始端~node$, `終端~node$ ］両者の`広義先祖$であるような，最も末端の~nodeを返す。 【原文の “ancestor” （先祖）は~~厳密な記述ではない。】 ◎ Returns the node, furthest away from the document, that is an ancestor of both range’s start node and end node.

@commonAncestorContainer

取得子は、此れの ( `始端~node$, `終端~node$ ) の`共通の広義先祖$を返すモノトスル。 ◎ The commonAncestorContainer attribute’s getter must run these steps: • Let container be start node. • While container is not an inclusive ancestor of end node, let container be container’s parent. • Return container.

【 次のブロックは、原文には存在しない，この訳による補完。 ブロックにて挙げる各種~methは、範囲oの片方または両方の境界点を新たな地点に変更する。 片方の境界点（以下， %P ）のみを変更する~methについては、整合性を保つため，もう片方の境界点（以下， %Q ）も必要に応じて~~正される： すなわち， %Q が［ %P と異なる木の中に在る, または［ %P `より前$i（始端が変更された場合） ／ %P `より後$i（終端が変更された場合） ］に位置する ］ようになった場合、 %P と同じ地点にされる（ 範囲oは畳まれる）。 】

%range . $setStart(node, offset)

%range . $setEnd(node, offset)

それぞれ，始端／終端を `境界点$( %node, %offset ) と同じ位置にする。

%node が`~doctype$である場合， `InvalidNodeTypeError$E 例外が投出される。 他の場合， %offset が %node の`長さ$を超えている場合， `IndexSizeError$E 例外が投出される。

%range . $setStartBefore(node)

%range . $setStartAfter(node)

それぞれ，始端を %node の外縁の［ 始端（下図の `S^c ）／終端（下図の `E^c ） ］に位置させる。

%node の`親$が~NULL の場合， `InvalidNodeTypeError$E 例外が投出される。

%range . $setEndBefore(node)

%range . $setEndAfter(node)

それぞれ，終端を %node の外縁の［ 始端（下図の `S^c ）／終端（下図の `E^c ） ］に位置させる。

%node の`親$が~NULL の場合， `InvalidNodeTypeError$E 例外が投出される。

（説明用の図式 — %node 引数が，図の~COLOR_Yが表す~nodeに対応しているとする。） `[|(|.|)|[|(|.|)|S[y|s[|(|.|)|]|(|.|.|.|)|[|]|e]|E(|.|.|)|]|]^bpex

%range . $collapse(toStart)

範囲oを畳む — すなわち、 %toStart が ~T の場合は 終端を始端と同じ地点に位置させ，他の場合は 始端を終端と同じ地点に位置させる。

%range . $selectNode(node)

%node を選択する — すなわち、始端と終端を %node の外縁の両端（上図の `S^c, `E^c ）に位置させる。

%node の`親$が~NULL の場合， `InvalidNodeTypeError$E 例外が投出される。

%range . $selectNodeContents(node)

%node の内容を選択する — すなわち、始端と終端を %node の内縁の両端（上図の `s^c, `e^c ）に位置させる。

%node が`~doctype$である場合， `InvalidNodeTypeError$E 例外が投出される。

%range . $compareBoundaryPoints(how, sourceRange)

%range の始端または終端（ %how により指示される）の位置bpが， %sourceRange の始端または終端（ %how により指示される）［ `より前$i, `に等しい$i, `より後$i ］のいずれになるかに応じて、［ −1, 0, 1 ］を返す。

`~live範囲o$ %範囲o の `境界点を設定する@ ときは、所与の ( %端 ~IN { `始端^i, `終端^i }, `~node$ %node, 非負~整数 %offset ) に対し，次を走らす： ◎ To set the start or end of a range to a boundary point (node, offset), run these steps:

1. ~IF［ %node は`~doctype$である ］ ⇒ ~THROW `InvalidNodeTypeError$E ◎ If node is a doctype, then throw an "InvalidNodeTypeError" DOMException.
2. ~IF［ %offset ~GT %node の`長さ$ ］ ⇒ ~THROW `IndexSizeError$E ◎ If offset is greater than node’s length, then throw an "IndexSizeError" DOMException.
3. %境界点 ~LET `境界点$( %node, %offset ) ◎ Let bp be the boundary point (node, offset).

4. ~IF［ %端 ~EQ `始端^i ］： ◎ If these steps were invoked as "set the start"

   1. ~IF［ %境界点 は %範囲o の`終端$`より後$i ］~OR［ %範囲o の`根$rg ~NEQ %node の`根$ ］ ⇒ %範囲o の`終端$ ~SET %境界点 ◎ If bp is after the range’s end, or if range’s root is not equal to node’s root, set range’s end to bp.
   2. %範囲o の`始端$ ~SET %境界点 ◎ Set range’s start to bp.

5. ~ELSE（ %端 ~EQ `終端^i ） ◎ If these steps were invoked as "set the end"

   1. ~IF［ %境界点 は %範囲o の`始端$`より前$i ］~OR［ %範囲o の`根$rg ~NEQ %node の`根$ ］ ⇒ %範囲o の`始端$ ~SET %境界点 ◎ If bp is before the range’s start, or if range’s root is not equal to node’s root, set range’s start to bp.
   2. %範囲o の`終端$ ~SET %境界点 ◎ Set range’s end to bp.

@setStart(node, offset)

被呼出時には、次を走らすモノトスル ⇒ 此れの`境界点を設定する$( `始端^i, %node, %offset ) ◎ The setStart(node, offset) method, when invoked, must set the start of context object to boundary point (node, offset).

@setEnd(node, offset)

被呼出時には、次を走らすモノトスル ⇒ 此れの`境界点を設定する$( `終端^i, %node, %offset ) ◎ The setEnd(node, offset) method, when invoked, must set the end of context object to boundary point (node, offset).

@setStartBefore(node)

被呼出時には、次を走らすモノトスル： ◎ The setStartBefore(node) method, when invoked, must run these steps:

1. %親 ~LET %node の`親$ ◎ Let parent be node’s parent.
2. ~IF［ %親 ~EQ ~NULL ］ ⇒ ~THROW `InvalidNodeTypeError$E ◎ If parent is null, then throw an "InvalidNodeTypeError" DOMException.
3. 此れの`境界点を設定する$( `始端^i, %親, %node の`指数$ ) ◎ Set the start of the context object to boundary point (parent, node’s index).

@setStartAfter(node)

被呼出時には、次を走らすモノトスル： ◎ The setStartAfter(node) method, when invoked, must run these steps:

1. 此れの`境界点を設定する$( `始端^i, %親, %node の`指数$ ~PLUS 1 ) ◎ Set the start of the context object to boundary point (parent, node’s index plus 1).

@setEndBefore(node)

被呼出時には、次を走らすモノトスル： ◎ The setEndBefore(node), when invoked, method must run these steps:

1. 此れの`境界点を設定する$( `終端^i, %親, %node の`指数$ ) ◎ Set the end of the context object to boundary point (parent, node’s index).

@setEndAfter(node)

被呼出時には、次を走らすモノトスル： ◎ The setEndAfter(node) method, when invoked, must run these steps:

1. 此れの`境界点を設定する$( `終端^i, %親, %node の`指数$ ~PLUS 1 ) ◎ Set the end of the context object to boundary point (parent, node’s index plus 1).

@collapse(toStart)

被呼出時には、次を走らすモノトスル： ◎ The collapse(toStart) method, when invoked, must＼

1. ~IF［ %toStart ~EQ ~T ］ ⇒ 此れの`終端$ ~SET `境界点$( 此れの`始端~node$, 此れの`始端~offset$ ) ◎ if toStart is true, set end to start, and＼
2. ~ELSE ⇒ 此れの`始端$ ~SET `境界点$( 此れの`終端~node$, 此れの`終端~offset$ ) ◎ set start to end otherwise.

`~node$ %node を，`範囲o$ %範囲o の `中身として選択-@rg するときは、次を走らす： ◎ To select a node node within a range range, run these steps:

1. %index ~LET %node の`指数$ ◎ Let index be node’s index.
2. %範囲o の`始端$ ~SET `境界点$( %親, %index ) ◎ Set range’s start to boundary point (parent, index).
3. %範囲o の`終端$ ~SET `境界点$( %親, %index ~PLUS 1 ) ◎ Set range’s end to boundary point (parent, index plus 1).

@selectNode(node)

被呼出時には、 %node を，此れの`中身として選択-$rgするモノトスル。 ◎ The selectNode(node) method, when invoked, must select node within context object.

@selectNodeContents(node)

被呼出時には、次を走らすモノトスル： ◎ The selectNodeContents(node) method, when invoked, must run these steps:

1. ~IF［ %node は`~doctype$である ］ ⇒ ~THROW `InvalidNodeTypeError$E ◎ If node is a doctype, throw an "InvalidNodeTypeError" DOMException.
2. %長さ ~LET %node の`長さ$ ◎ Let length be the length of node.
3. 此れの`始端$ ~SET `境界点$( %node, 0 ) ◎ Set start to the boundary point (node, 0).
4. 此れの`終端$ ~SET `境界点$( %node, %長さ ) ◎ Set end to the boundary point (node, length).

@compareBoundaryPoints(how, sourceRange)

被呼出時には、次を走らすモノトスル： ◎ The compareBoundaryPoints(how, sourceRange) method, when invoked, must run these steps:

1. ~IF［ %how ~NIN { $START_TO_START, $START_TO_END, $END_TO_END, $END_TO_START } ］ ⇒ ~THROW `NotSupportedError$E ◎ If how is not one of • START_TO_START • START_TO_END • END_TO_END • END_TO_START ◎ then throw a "NotSupportedError" DOMException.
2. ~IF［ 此れの`根$rg ~NEQ %sourceRange の`根$rg ］ ⇒ ~THROW `WrongDocumentError$E ◎ If context object’s root is not the same as sourceRange’s root, then throw a "WrongDocumentError" DOMException.

3. ( %基準点, %この点 ) ~LET %how に応じて，次で与えられる 2 個の`境界点$： ◎ If how is:

   $START_TO_START:

   ( %sourceRange の`始端$, 此れの`始端$ ) ◎ Let this point be the context object’s start. Let other point be sourceRange’s start.

   $START_TO_END:

   ( %sourceRange の`始端$, 此れの`終端$ ) ◎ Let this point be the context object’s end. Let other point be sourceRange’s start.

   $END_TO_END:

   ( %sourceRange の`終端$, 此れの`終端$ ) ◎ Let this point be the context object’s end. Let other point be sourceRange’s end.

   $END_TO_START:

   ( %sourceRange の`終端$, 此れの`始端$ ) ◎ Let this point be the context object’s start. Let other point be sourceRange’s end.

4. ~RET ［ %この点 は %基準点 ［ `より前$i ならば ~MINUS 1 ／ `に等しい$i ならば 0 ／ `より後$i ならば 1 ］ ◎ If the position of this point relative to other point is ◎ before • Return −1. ◎ equal • Return 0. ◎ after • Return 1.

【 次のブロックは、原文には存在しない，この訳による補完。 ブロックにて挙げる各種~methは、主に，範囲oの`中身$rgを操作する。 】

%range . $deleteContents()

`~live範囲o$の`中身$rgを削除した上で、範囲oの`境界点$を畳む。

`deleteContents()^c の実行例。 図の記号［ `s^c, `e^c ］が順に範囲の［ 始端, 終端 ］を表すとするとき、図左の~~状態から図右の~~状態になる。 包含されている~node（図の ~COLOR_X ）, および 始端／終端~nodeの文字~dataのうち 範囲oに入る部分の文字（図の `+^c ）が除去される。 部分的に包含されている~node（図の ~COLOR_Y ）は除去されない。 この例では、始端 `s^c が指す`文字~data~node$は，~dataは空になるが~node自体は残される。 図右の `S^c, `E^c が元の始端, 終端に対応する位置であるが、実行後の始端と終端は，図右の `X^c （共通の広義先祖の直下）を指すようにされることに注意（範囲oは畳まれる）。 始端~nodeが終端~nodeの`広義先祖$であった場合、始端の位置は変化しない。 始端~nodeが終端~node の`広義子孫$であった場合、全体の終端（右端）から相対的な終端の位置は変化しない。

`[|[|]|[y|(y|s+|)|]|[x|(|.|)|]|[y|(x|.|)|[y|(y|+|+|e.|)|[|]|]|(|.|)|]|] → [|[|]|[y|(y|S)|]|X[y|[y|(y|E.|)|[|]|]|(|.|)|]|]^bpex

%range . $extractContents()

`~live範囲o$の`中身$rgを~cloneした結果を返すと同時に，中身は削除する（ “カット” ）。 機能上は $cloneContents() と $deleteContents() の組み合わせと等価になる。

%range . $cloneContents()

`~live範囲o$の`中身を~clone$rgした結果を返す。 返される`中身$rgは、新たな`文書片$で包装される。

^cloneContents() の実行例。 図左の記号［ `s^c, `e^c ］が順に範囲の［ 始端, 終端 ］を表すとするとき、その間に挟まれた部分の~cloneが図右に示すように得られる（ `S^c, `E^c が元の始端と終端に対応する位置）。 図の~COLOR_Yの 2 個の~nodeが，範囲に`部分的に包含され$ている子。 入れ物にあたる それらの`共通の広義先祖$は、~cloneにおいては`文書片$（~COLOR_X）に置換される。 始端 `s^c が属する`文字~data~node$は~dataが空にされるが、~node自体は［ その親から共通の広義先祖の子まで ］の先祖も含めて~cloneされる。

`[|[|]|[y|(|.|s)|(|.|)|]|(|.|)|[y|(|.|)|[|(|.|.|e.|)|[|]|]|(|.|)|]|] → [x|[y|(|S)|(|.|)|]|(|.|)|[y|(|.|)|[|(|.|.|E)|]|]|]^bpex

%range . $insertNode(node)

`~live範囲o$の`中身$rgの先頭に %node を挿入する（`中身に挿入-$rgする）。

%range . $surroundContents(newParent)

`~live範囲o$の`中身$rgを %newParent ~nodeで包装する。 それに伴い、範囲oの始端, 終端は， %newParent の（外縁の）両端を指すようにされる。 包装するに先立って、 %newParent の元々の子はすべて除去され， %newParent 自身も元々の親から除去される。

^surroundContents(%newParent) の実行例。 記号 `s^c は始端, `e^c は終端を表すとき、それらに挟まれた区間が %newParent で包装される（図の~COLOR_Y）。 `部分的に包含され$るものは `Text^c 以外に許容されないので、始端と終端は `Text^c の層を~~無視すれば同じ親の直下に位置する必要がある（さもなければ例外が投出される）。 図の様に境界点が `Text^c ~node内に位置する場合、その~nodeはそこで分割される。

`[|(|.|)|s[x|(|.|)|]|[x|(|.|.|)|[|]|]|(|.|e.|)|] → [|(|.|)|s[y|[x|(|.|)|]|[x|(|.|.|)|[|]|]|(|.|)|]|e(|.|)|]^bpex

@deleteContents()

被呼出時には、次を走らすモノトスル： ◎ The deleteContents() method, when invoked, must run these steps:

1. ~IF［ 此れは`畳まれて$いる ］ ⇒ ~RET ◎ If the context object is collapsed, then return.
2. ( %元の始端~node, %元の始端~offset, %元の終端~node, %元の終端~offset ) ~LET 順に，此れの ( `始端~node$, `始端~offset$, `終端~node$, `終端~offset$ ) ◎ Let original start node, original start offset, original end node, and original end offset be the context object’s start node, start offset, end node, and end offset, respectively.

3. ~IF［ %元の始端~node ~EQ %元の終端~node ］~AND［ %元の始端~node は`文字~data~node$である ］： ◎ If original start node and original end node are the same, and they are a Text, ProcessingInstruction, or Comment node,＼

   1. %元の始端~node の`~dataを置換する$( %元の始端~offset, %元の終端~offset ~MINUS %元の始端~offset, 空~文字列 ) ◎ replace data with node original start node, offset original start offset, count original end offset minus original start offset, and data the empty string,＼
   2. ~RET ◎ and then return.
4. %除去対象 ~LET ［ 此れに`包含され$ている`~node$のうち，`親$も此れに`包含され$ているものは除いたもの ］からなる，`木~順序$の~list ◎ Let nodes to remove be a list of all the nodes that are contained in the context object, in tree order, omitting any node whose parent is also contained in the context object.
5. ~IF［ %元の始端~node は %元の終端~node の`広義先祖$である ］ ⇒＃ %新-~node ~LET %元の始端~node； %新-~offset ~LET %元の始端~offset ◎ If original start node is an inclusive ancestor of original end node, set new node to original start node and new offset to original start offset.

6. ~ELSE：

   1. %新-~node ~LET ( %元の始端~node, %元の終端~node ) の`共通の広義先祖$
   2. %新-~offset ~LET ［ %新-~node の`子$のうち, %元の始端~node の`広義先祖$である`~node$ † ］の`指数$ ~PLUS 1

   【 見通しを良くするため、ここの訳は，原文を等価な記述に変形している。 前~段の条件の否定が成立することから † に該当する~nodeは必ず存在し， %新-~node に`部分的に包含され$ている子のうち 最初のものになる。 】

   ◎ Otherwise: • Let reference node equal original start node. • While reference node’s parent is not null and is not an inclusive ancestor of original end node, set reference node to its parent. • Set new node to the parent of reference node, and new offset to one plus the index of reference node. • If reference node’s parent were null, it would be the root of the context object, so would be an inclusive ancestor of original end node, and we could not reach this point.
7. ~IF［ %元の始端~node は`文字~data~node$である ］ ⇒ %元の始端~node の`~dataを置換する$( %元の始端~offset, %元の始端~node の`長さ$ ~MINUS %元の始端~offset, 空~文字列 ) ◎ If original start node is a Text, ProcessingInstruction, or Comment node, replace data with node original start node, offset original start offset, count original start node’s length minus original start offset, data the empty string.
8. %除去対象 内の ~EACH( %node ) に対し，`木~順序$で ⇒ %node の`親$から`子を除去する$( %node ) ◎ For each node in nodes to remove, in tree order, remove node from its parent.
9. ~IF［ %元の終端~node は`文字~data~node$である ］ ⇒ %元の終端~node の`~dataを置換する$( 0, %元の終端~offset, 空~文字列 ) ◎ If original end node is a Text, ProcessingInstruction, or Comment node, replace data with node original end node, offset 0, count original end offset and data the empty string.
10. 此れの`始端$ ~SET `境界点$( %新-~node, %新-~offset )；
    此れの`終端$ ~SET `境界点$( %新-~node, %新-~offset ) ◎ Set start and end to (new node, new offset).

`~live範囲o$ %範囲o の `中身を抽出-@rg するときは、次を走らす： ◎ To extract a live range range, run these steps:

1. %断片 ~LET 次のように設定された 新たな`文書片$`~node$ ⇒ `~node文書$ ~SET %範囲o の`始端~node$の`~node文書$ ◎ Let fragment be a new DocumentFragment node whose node document is range’s start node’s node document.
2. ~IF［ %範囲o は`畳まれて$いる ］ ⇒ ~RET %断片 ◎ If range is collapsed, then return fragment.
3. ( %元の始端~node, %元の始端~offset, %元の終端~node, %元の終端~offset ) ~LET 順に， %範囲o の ( `始端~node$, `始端~offset$, `終端~node$, `終端~offset$ ) ◎ Let original start node, original start offset, original end node, and original end offset be range’s start node, start offset, end node, and end offset, respectively.

4. ~IF［ %元の始端~node ~EQ %元の終端~node ］~AND［ %元の始端~node は`文字~data~node$である ］： ◎ If original start node is original end node, and they are a Text, ProcessingInstruction, or Comment node:

   1. %clone ~LET `~nodeを~cloneする$( %元の始端~node ) ◎ Let clone be a clone of original start node.
   2. %clone の`~data$ ~SET %元の始端~node の`~dataの部分文字列$( %元の始端~offset, ( %元の終端~offset ~MINUS %元の始端~offset ) ) ◎ Set the data of clone to the result of substringing data with node original start node, offset original start offset, and count original end offset minus original start offset.
   3. %断片 に`~nodeを付加する$( %clone ) ◎ Append clone to fragment.
   4. %元の始端~node の`~dataを置換する$( %元の始端~offset, %元の終端~offset ~MINUS %元の始端~offset, 空~文字列 ) ◎ Replace data with node original start node, offset original start offset, count original end offset minus original start offset, and data the empty string.
   5. ~RET %断片 ◎ Return fragment.
5. %共通の広義先祖 ~LET ( %元の始端~node, %元の終端~node ) の`共通の広義先祖$ ◎ Let common ancestor be original start node. ◎ While common ancestor is not an inclusive ancestor of original end node, set common ancestor to its own parent.
6. %部分的に包含されている最初の子 ~LET ~NULL ◎ Let first partially contained child be null.
7. ~IF［ %元の始端~node は %元の終端~node の`広義先祖$でない ］ ⇒ %部分的に包含されている最初の子 ~SET %範囲o に`部分的に包含され$ている［ %共通の広義先祖 の`子$ ］のうち，最初のもの ◎ If original start node is not an inclusive ancestor of original end node, set first partially contained child to the first child of common ancestor that is partially contained in range.
8. %部分的に包含されている最後の子 ~LET ~NULL ◎ Let last partially contained child be null.

9. ~IF［ %元の終端~node は %元の始端~node の`広義先祖$でない ］ ⇒ %部分的に包含されている最後の子 ~SET %範囲o に`部分的に包含され$ている［ %共通の広義先祖 の`子$ ］のうち，最後のもの ◎ If original end node is not an inclusive ancestor of original start node, set last partially contained child to the last child of common ancestor that is partially contained in range.

   注記： これらの変数~代入は実際に常に~~意味を成す。 例えば， %元の始端~node が %元の終端~node の`広義先祖$でない場合、［ %元の始端~node ~EQ %共通の広義先祖 ］にはなり得ないので［ %元の始端~node の広義先祖であって %共通の広義先祖 の子孫でもあるもの ］が 1 つ以上あり，それらは %範囲o に`部分的に包含され$、それらのうち %共通の広義先祖 の子であるものが該当するものになる。 逆の場合も同様になる。 また、 2 つの子がいずれも定義されたなら，それらは決して等しくならないことにも注意。 ◎ These variable assignments do actually always make sense. For instance, if original start node is not an inclusive ancestor of original end node, original start node is itself partially contained in range, and so are all its ancestors up until a child of common ancestor. common ancestor cannot be original start node, because it has to be an inclusive ancestor of original end node. The other case is similar. Also, notice that the two children will never be equal if both are defined.

10. %包含されている子たち ~LET %共通の広義先祖 の`子$のうち， %範囲o に`包含され$ているものすべてからなる `木~順序$による~list ◎ Let contained children be a list of all children of common ancestor that are contained in range, in tree order.

11. ~IF［ %包含されている子たち 内に`~doctype$が在る ］ ⇒ ~THROW `HierarchyRequestError$E ◎ If any member of contained children is a doctype, then throw a "HierarchyRequestError" DOMException.

    注記： `~doctype$が`部分的に包含され$ることは決してないので、部分的に包含される~nodeを気にする必要はない。 それは 範囲o の境界点 【始端~node／終端~node】 にはなり得ず, 何かの先祖にもなり得ない。 ◎ We do not have to worry about the first or last partially contained node, because a doctype can never be partially contained. It cannot be a boundary point of a range, and it cannot be the ancestor of anything.

12. ~ELSE ⇒＃ %新-~node ~LET %共通の広義先祖； %新-~offset ~LET %部分的に包含されている最初の子 の`指数$ ~PLUS 1

    【 ここの訳は、原文の記述と同じ結果を得るものに簡略化している。 】

    ◎ Otherwise: • Let reference node equal original start node. • While reference node’s parent is not null and is not an inclusive ancestor of original end node, set reference node to its parent. • Set new node to the parent of reference node, and new offset to one plus reference node’s index. • If reference node’s parent is null, it would be the root of range, so would be an inclusive ancestor of original end node, and we could not reach this point.

13. ~IF［ %部分的に包含されている最初の子 は`文字~data~node$である ］： ◎ If first partially contained child is a Text, ProcessingInstruction, or Comment node:

    この事例では， %部分的に包含されている最初の子 は %元の始端~node である。 ◎ In this case, first partially contained child is original start node.

    1. %clone の`~data$ ~SET %元の始端~node の`~dataの部分文字列$( %元の始端~offset, ( %元の始端~node の`長さ$ ~MINUS %元の始端~offset ) ) ◎ Set the data of clone to the result of substringing data with node original start node, offset original start offset, and count original start node’s length minus original start offset.
    2. %元の始端~node の`~dataを置換する$( %元の始端~offset, %元の始端~node の`長さ$ ~MINUS %元の始端~offset, 空~文字列 ) ◎ Replace data with node original start node, offset original start offset, count original start node’s length minus original start offset, and data the empty string.

14. ~ELIF［ %部分的に包含されている最初の子 ~NEQ ~NULL ］： ◎ Otherwise, if first partially contained child is not null:

    1. %clone ~LET `~nodeを~cloneする$( %部分的に包含されている最初の子 ) ◎ Let clone be a clone of first partially contained child.
    2. %下位~範囲o ~LET 次のように設定された 新たな`~live範囲o$ ⇒＃ `始端$ ~SET `境界点$( %元の始端~node, %元の始端~offset ), `終端$ ~SET `境界点$( %部分的に包含されている最初の子, %部分的に包含されている最初の子 の`長さ$ ) ◎ Let subrange be a new live range whose start is (original start node, original start offset) and whose end is (first partially contained child, first partially contained child’s length).
    3. %下位~断片 ~LET %下位~範囲o の`中身を抽出-$rgした結果 ◎ Let subfragment be the result of extracting subrange.
    4. %clone に`~nodeを付加する$( %下位~断片 ) ◎ Append subfragment to clone.
15. %包含されている子たち 内の ~EACH( %包含されている子 ) に対し ⇒ %断片 に`~nodeを付加する$( %包含されている子 ) ◎ For each contained child in contained children, append contained child to fragment.

16. ~IF［ %部分的に包含されている最後の子 は`文字~data~node$である ］： ◎ If last partially contained child is a Text, ProcessingInstruction, or Comment node:

    注記： この事例では， %部分的に包含されている最後の子 は %元の始端~node である。 ◎ In this case, last partially contained child is original end node.

    1. %clone ~LET `~nodeを~cloneする$( %元の終端~node ) ◎ Let clone be a clone of original end node.
    2. %clone の`~data$ ~SET %元の終端~node の`~dataの部分文字列$( 0, %元の終端~offset ) ◎ Set the data of clone to the result of substringing data with node original end node, offset 0, and count original end offset.
    3. %元の終端~node の`~dataを置換する$( 0, %元の終端~offset, 空~文字列 ) ◎ Replace data with node original end node, offset 0, count original end offset, and data the empty string.

17. ~ELIF［ %部分的に包含されている最後の子 ~NEQ ~NULL ］： ◎ Otherwise, if last partially contained child is not null:

    1. %clone ~LET `~nodeを~cloneする$( %部分的に包含されている最後の子 ) ◎ Let clone be a clone of last partially contained child.
    2. %下位~範囲o ~LET 次のように設定された 新たな`~live範囲o$ ⇒＃ `始端$ ~SET `境界点$( %部分的に包含されている最後の子, 0 ), `終端$ ~SET `境界点$( %元の終端~node, %元の終端~offset ) ◎ Let subrange be a new live range whose start is (last partially contained child, 0) and whose end is (original end node, original end offset).
18. %範囲o の`始端$ ~SET `境界点$( %新-~node, %新-~offset )；
    %範囲o の`終端$ ~SET `境界点$( %新-~node, %新-~offset ) ◎ Set range’s start and end to (new node, new offset).

@extractContents()

被呼出時には、此れの`中身を抽出-$rgした結果を返すモノトスル。 ◎ The extractContents() method, when invoked, must return the result of extracting the context object.

`~live範囲o$ %範囲o の`中身を~clone@rg するときは、次を走らす： ◎ To clone the contents of a live range range, run these steps:

3. 1. %下位~断片 ~LET %下位~範囲o の`中身を~clone$rgした結果 ◎ Let subfragment be the result of cloning the contents of subrange.

4. %包含されている子たち 内の ~EACH( %包含されている子 ) に対し： ◎ For each contained child in contained children:

   1. %clone ~LET `~nodeを~cloneする$( %包含されている子, ε, `子も~cloneする^i ) ◎ Let clone be a clone of contained child with the clone children flag set.

@cloneContents()

被呼出時には、此れの`中身を~clone$rgした結果を返すモノトスル。 ◎ The cloneContents() method, when invoked, must return the result of cloning the contents of the context object.

`~node$ %node を`~live範囲o$ %範囲o の `中身に挿入-@rg するときは，次を走らす： ◎ To insert a node node into a live range range, run these steps:

【 `始端$の直後に %node を挿入する。 それに伴い、終端は，末尾側からの相対位置が変化しないように適宜ずらされる（すなわち、挿入-後の 始端／終端 の，先頭／末尾 からの相対位置は不変）。 始端が`文字~data~node$の内部を指している場合、その~nodeは始端の所で 2 つに分割される。 】

1. ( %始端~node, %始端~offset ) ~LET %範囲o の ( `始端~node$, `始端~offset$ ) ◎ ↓

2. ~IF［ %始端~node は次のいずれかを満たす ］ ⇒ ~THROW `HierarchyRequestError$E ：

   • $ProcessingInstruction ~nodeである
   • $Comment ~nodeである
   • ［ $Text `~node$である ］~AND［ `親$ ~EQ ~NULL ］
   • %始端~node ~EQ %node
   ◎ If range’s start node is a ProcessingInstruction or Comment node, is a Text node whose parent is null, or is node, then throw a "HierarchyRequestError" DOMException.
3. %基準~node ~LET ~NULL ◎ Let referenceNode be null.
4. ~IF［ %始端~node は $Text `~node$である ］ ⇒ %基準~node ~SET %始端~node ◎ If range’s start node is a Text node, set referenceNode to that Text node.
5. ~ELIF［ %始端~node の`子$に［ `指数$ ~EQ %始端~offset ］なるものが在る ］ ⇒ %基準~node ~SET それ ◎ Otherwise, set referenceNode to the child of start node whose index is start offset, and null if there is no such child.
6. %親 ~LET ［ %基準~node ~NEQ ~NULL ならば その`親$ ／ ~ELSE_ %始端~node ］ ◎ Let parent be range’s start node if referenceNode is null, and referenceNode’s parent otherwise.
7. %node を %親 の中で %基準~node の前に`挿入できるかどうか検証する$ ◎ Ensure pre-insertion validity of node into parent before referenceNode.

8. ~IF［ %始端~node は $Text `~node$である ］ ⇒ %基準~node ~SET `~Text~nodeを分割する$( %始端~node, %始端~offset )

   【 %始端~offset が 0 でも分割されることになる。 】

   ◎ If range’s start node is a Text node, set referenceNode to the result of splitting it with offset range’s start offset.
9. ~IF［ %node ~EQ %基準~node ］ ⇒ %基準~node ~SET %node の`次-同胞？$ ◎ If node is referenceNode, set referenceNode to its next sibling.
10. ~IF［ %node の`親$ ~NEQ ~NULL ］ ⇒ %node の`親$から`子を除去する$( %node ) ◎ If node’s parent is not null, remove node from its parent.
11. %新-~offset ~LET ［ %基準~node ~NEQ ~NULL ならば その`指数$ ／ ~ELSE_ %親 の`長さ$ ］ ◎ Let newOffset be parent’s length if referenceNode is null, and referenceNode’s index otherwise.
12. %新-~offset ~INCBY ［ %node は`文書片$であるならば その`長さ$ ／ ~ELSE_ 1 ］ ◎ Increase newOffset by node’s length if node is a DocumentFragment node, and one otherwise.
13. %親 の中で`~nodeを子の前に前挿入する$( %node, %基準~node ) ◎ Pre-insert node into parent before referenceNode.

14. ~IF［ %範囲o は`畳まれて$いる ］ ⇒ %範囲o の`終端$ ~SET `境界点$( %親, %新-~offset )

    【 畳まれていない場合の終端の位置は，`~nodeを子の前に前挿入する$（手続きの中で`~nodeを子の前に挿入する$）段階で適宜ずらされる。 】

    ◎ If range is collapsed, then set range’s end to (parent, newOffset).

@insertNode(node)

被呼出時には、 %node を此れの`中身に挿入-$rgするモノトスル。 ◎ The insertNode(node) method, when invoked, must insert node into the context object.

@surroundContents(newParent)

被呼出時には、次を走らすモノトスル： ◎ The surroundContents(newParent) method, when invoked, must run these steps:

1. ~IF［ ある非 $Text `~node$が此れに`部分的に包含され$ている ］ ⇒ ~THROW `InvalidStateError$E ◎ If a non-Text node is partially contained in the context object, then throw an "InvalidStateError" DOMException.

2. ~IF［ %newParent は $Document, $DocumentType, $DocumentFragment `~node$ のいずれかである ］ ⇒ ~THROW `InvalidNodeTypeError$E ◎ If newParent is a Document, DocumentType, or DocumentFragment node, then throw an "InvalidNodeTypeError" DOMException.

   注記： 歴史上の理由から、`文字~data~node$に対しては、この段では検査されず，後の段にて副作用とともに例外が投出される結果になる。 ◎ For historical reasons Text, ProcessingInstruction, and Comment nodes are not checked here and end up throwing later on as a side effect.

3. %断片 ~LET 此れの`中身を抽出-$rgした結果 ◎ Let fragment be the result of extracting the context object.
4. ~IF［ %newParent は`子$を持つ ］ ⇒ %newParent の`全~内容を~nodeで置換する$( ~NULL ) ◎ If newParent has children, then replace all with null within newParent.
5. %newParent を此れの`中身に挿入-$rgする ◎ Insert newParent into the context object.
6. %newParent に`~nodeを付加する$( %断片 ) ◎ Append fragment to newParent.
7. %newParent を，此れの`中身として選択-$rgする ◎ Select newParent within the context object.

@cloneRange()

被呼出時には、次のように設定された 新たな`~live範囲o$を返すモノトスル ⇒＃ `始端$ ~SET 此れの`始端$の複製, `終端$ ~SET 此れの`終端$の複製 ◎ The cloneRange() method, when invoked, must return a new live range with the same start and end as the context object.

@detach()

被呼出時には、何もしないモノトスル。 ◎ The detach() method, when invoked, must do nothing.＼

注記： この機能性（ ^Range ~objの不能化）は、取除かれた。 互換性のため存続はするが。 ◎ Its functionality (disabling a Range object) was removed, but the method itself is preserved for compatibility.

%position = %range . $isPointInRange(node, offset)

`境界点$( %node, %offset ) が %range 内に入る†かどうかを返す。

%position = %range . $comparePoint(node, offset)

`境界点$( %node, %offset ) が %range より前に位置する場合は ~MINUS 1 を, %range 内に入る†場合は 0 を, %range より後に位置する場合は 1 を 返す。 ◎ Returns −1 if the point is before the range, 0 if the point is in the range, and 1 if the point is after the range.

【† 境界点が %range のいずれかの境界点に一致する場合も，“入る” と見なされる。 】

%intersects = %range . $intersectsNode(node)

%range が %node と交わるかどうかを返す。 ◎ Returns whether range intersects node.

【 %node が %range に隣接している場合（ %range の終端（始端）が %node の 外縁の 始端（終端）を指す境界点に一致する場合）は、“交わらない”。 例えば下図で `s^c, `e^c が %range の境界点を表すとするとき，図の~COLOR_Yが表す %node は交わらない。 】

`[|[y|(|.|)|]|s[|(|.|.|)|e[y|(|.|.|)|]|]|]^bpex

【 一般に、 %node は %範囲o に (1) `包含され$ているとき, または (2) %範囲o の始端~node／終端~nodeいずれかの`広義先祖$であるとき、 “交わる”。 】

$stringifier

範囲oを文字列化した結果は、範囲oにより “選択-” されているすべての~textになる。

【 上のブロックに挙げた ^isPointInRange(), ^stringifier は、原文には存在しない，この訳による補完。 】

@isPointInRange(node, offset)

被呼出時には、次を走らすモノトスル： ◎ The isPointInRange(node, offset) method, when invoked, must run these steps:

1. ~IF［ %node の`根$ ~NEQ 此れの`根$rg ］ ⇒ ~RET ~F ◎ If node’s root is different from the context object’s root, return false.
2. ~IF［ `境界点$( %node, %offset ) は［［ 此れの`始端$`より前$i ］~OR［ 此れの`終端$`より後$i ］］］ ⇒ ~RET ~F ◎ If (node, offset) is before start or after end, return false.
3. ~RET ~T ◎ Return true.

@comparePoint(node, offset)

被呼出時には、次を走らすモノトスル： ◎ The comparePoint(node, offset) method, when invoked, must run these steps:

1. ~IF［ %node の`根$ ~NEQ 此れの`根$rg ］ ⇒ ~THROW `WrongDocumentError$E ◎ If node’s root is different from the context object’s root, then throw a "WrongDocumentError" DOMException.
2. ~IF［ `境界点$( %node, %offset ) は 此れの`始端$`より前$i ］ ⇒ ~RET ~MINUS 1 ◎ If (node, offset) is before start, return −1.
3. ~IF［ `境界点$( %node, %offset ) は 此れの`終端$`より後$i ］ ⇒ ~RET 1 ◎ If (node, offset) is after end, return 1.
4. ~RET 0 ◎ Return 0.

@intersectsNode(node)

被呼出時には、次を走らすモノトスル： ◎ The intersectsNode(node) method, when invoked, must run these steps:

1. ~IF［ %親 ~EQ ~NULL ］ ⇒ ~RET ~T ◎ If parent is null, return true.
2. %offset ~LET %node の`指数$ ◎ Let offset be node’s index.
3. ~IF［ `境界点$( %親, %offset ) は 此れの`終端$`より前$i ］~AND［ `境界点$( %親, %offset ~PLUS 1 ) は 此れの`始端$`より後$i ］ ⇒ ~RET ~T ◎ If (parent, offset) is before end and (parent, offset plus 1) is after start, return true.
4. ~RET ~F ◎ Return false.

@stringifier

文字列化の挙動は、次を走らすモノトスル： ◎ The stringification behavior must run these steps:

1. %s ~LET 空~文字列 ◎ Let s be the empty string.
2. ( %始端~node, %始端~offset, %終端~node, %終端~offset ) ~LET 此れの ( `始端~node$, `始端~offset$, `終端~node$, `終端~offset$ ) ◎ ↓

3. ~IF［ %始端~node は $Text `~node$である ］：

   1. ~IF［ %始端~node ~EQ %終端~node ］ ⇒ ~RET %始端~node の`~data$の［ %始端~offset から %終端~offset までの部分文字列 ］
   2. %s に次を付加する ⇒ %始端~node の`~data$の［ %始端~offset から末尾までの部分文字列 ］
   ◎ If the context object’s start node is the context object’s end node and it is a Text node, then return the substring of that Text node’s data beginning at the context object’s start offset and ending at the context object’s end offset. ◎ If the context object’s start node is a Text node, then append the substring of that node’s data from the context object’s start offset until the end to s.
4. %s に次を`連結-$した結果を付加する ⇒ `木~順序$による，此れに`包含され$ているすべての $Text `~node$の`~data$ ◎ Append the concatenation of the data of all Text nodes that are contained in the context object, in tree order, to s.
5. ~IF［ %終端~node は $Text `~node$である ］ ⇒ %s に次を付加する ⇒ %終端~node の`~data$の［ 先頭から %終端~offset までの部分文字列 ］ ◎ If the context object’s end node is a Text node, then append the substring of that node’s data from its start until the context object’s end offset to s.
6. ~RET %s ◎ Return s.

注記： ^Range ~ifcに対する拡張として、他の仕様にて `createContextualFragment()$m, `getClientRects()$m, `getBoundingClientRect()$m ~methが定義されている。 `DOM-Parsing$r `CSSOM-VIEW$r ◎ The createContextualFragment(), getClientRects(), and getBoundingClientRect() methods are defined in other specifications. [DOM-Parsing] [CSSOM-VIEW]

6.1. ^@NodeIterator ~ifc

注記： $NodeIterator ~objは、 $Document ~obj上の $Document.createNodeIterator() ~methを利用して作成できる。 ◎ NodeIterator objects can be created using the createNodeIterator() method on Document objects.

注記： 前に言及したように、 $NodeIterator ~objには［ `作動中~flag$tV, `根$tV, `~whatToShow$tV, `~filter~callback$tV ］も結付けられる。 ◎ As mentioned earlier, NodeIterator objects have an associated active flag, root, whatToShow, and filter as well.

`前除去-時の手続き@ は、所与の ( $NodeIterator %反復子, `~node$ %除去される~node ) に対し，次に従う： ◎ The NodeIterator pre-removing steps given a nodeIterator and toBeRemovedNode, are as follows:

1. ~IF［ %除去される~node は %反復子 の`起点$tVの`広義先祖$でない ］~OR［ %除去される~node ~EQ %反復子 の`根$tV ］ ⇒ ~RET ◎ If toBeRemovedNode is not an inclusive ancestor of nodeIterator’s reference, or toBeRemovedNode is nodeIterator’s root, then return.

2. ~IF［ %反復子 の`起点の直前？$tV ~EQ ~T ］： ◎ If nodeIterator’s pointer before reference is true, then:

   1. %次- ~LET 次をすべて満たす`~node$のうち，`最初のもの？$：

      • %除去される~node に`後続-$する
      • %反復子 の`根$tVの`広義子孫$である
      • %除去される~node の`広義子孫$でない
      ◎ Let next be toBeRemovedNode’s first following node that is an inclusive descendant of nodeIterator’s root and is not an inclusive descendant of toBeRemovedNode, and null if there is no such node.
   2. ~IF［ %次- ~NEQ ~NULL ］ ⇒＃ %反復子 の`起点$tV ~SET %次-； ~RET ◎ If next is non-null, then set nodeIterator’s reference to next and return.
   3. %反復子 の`起点の直前？$tV ~SET ~F ◎ Otherwise, set nodeIterator’s pointer before reference to false. ◎ Steps are not terminated here.
3. %前-同胞 ~LET %除去される~node の`前-同胞？$ ◎ ↓
4. %反復子 の`起点$tV ~SET %前-同胞 に応じて ⇒＃ ~NULL ならば %除去される~node の`親$ ／ ~ELSE_ %前-同胞 の`広義子孫$のうち `最後のもの？$ ◎ Set nodeIterator’s reference to toBeRemovedNode’s parent, if toBeRemovedNode’s previous sibling is null, and to the inclusive descendant of toBeRemovedNode’s previous sibling that appears last in tree order otherwise.

@root

取得子は、此れの`根$tVを返すモノトスル。 ◎ The root attribute’s getter, when invoked, must return the context object’s root.

@referenceNode

取得子は、此れの`起点$tVを返すモノトスル。 ◎ The referenceNode attribute’s getter, when invoked, must return the context object’s reference. to.

@pointerBeforeReferenceNode

取得子は、此れの`起点の直前？$tVを返すモノトスル。 ◎ The pointerBeforeReferenceNode attribute’s getter, when invoked, must return the context object’s pointer before reference.

@whatToShow

取得子は、此れの`~whatToShow$tVを返すモノトスル。 ◎ The whatToShow attribute’s getter, when invoked, must return the context object’s whatToShow.

@filter

取得子は、此れの`~filter~callback$tVを返すモノトスル。 ◎ The filter attribute’s getter, when invoked, must return the context object’s filter.

`反復子で走査する@ ときは、所与の ( $NodeIterator ~obj %反復子, %方向 ~IN { `順^i, `逆^i } ) に対し，次を走らす： ◎ To traverse, given a NodeIterator object iterator and a direction direction, run these steps:

1. %node ~LET %反復子 の`起点$tV ◎ Let node be iterator’s reference.
2. %直前？ ~LET %反復子 の`起点の直前？$tV ◎ Let beforeNode be iterator’s pointer before reference.
3. %collection ~LET %反復子 の`反復子~collection$ ◎ ↓

4. ~WHILE 無条件： ◎ While true:

   1. ~IF［ %方向 ~EQ `順^i ］： ◎ Branch on direction: ◎ next

      1. ~IF［ %直前？ ~EQ ~F ］： ◎ If beforeNode is false, then＼

         1. %node ~SET %collection の中で %node に`後続-$する`~node$のうち，`最初のもの？$ ◎ set node to the first node following node in iterator’s iterator collection.＼
         2. ~IF［ %node ~EQ ~NULL ］ ⇒ ~RET ~NULL ◎ If there is no such node, then return null.
      2. ~ELSE ⇒ %直前？ ~SET ~F ◎ If beforeNode is true, then set it to false.

   2. ~ELSE（ %方向 ~EQ `逆^i ）： ◎ previous

      1. ~IF［ %直前？ ~EQ ~T ］： ◎ If beforeNode is true, then＼

         1. %node ~SET %collection の中で %node に`先行-$する`~node$のうち，`最後のもの？$ ◎ set node to the first node preceding node in iterator’s iterator collection.＼
         2. ~IF［ %node ~EQ ~NULL ］ ⇒ ~RET ~NULL ◎ If there is no such node, then return null.
      2. ~ELSE ⇒ %直前？ ~SET ~T ◎ If beforeNode is false, then set it to true.
   3. ~IF［ `走査器の中で~nodeを~filterにかける$( %反復子, %node ) ~EQ $NodeFilter.FILTER_ACCEPT ］ ⇒ ~BREAK ◎ Let result be the result of filtering node within iterator. ◎ If result is FILTER_ACCEPT, then break.
5. %反復子 の`起点$tV ~SET %node ◎ Set iterator’s reference to node.
6. %反復子 の`起点の直前？$tV ~SET %直前？ ◎ Set iterator’s pointer before reference to beforeNode.
7. ~RET %node ◎ Return node.

【 走査の方向が前回と逆向きに切り替わった場合、探索は，前回の走査による “現在の” ~node（ `起点$tV ）から開始されることに注意（その次-／前-~nodeからではなく）。 探索の結果，`~filter$cLに合致する~nodeが見出されなかった場合、`起点$tVは変更されない。 見出された場合、 `起点$tV は，新たに見出された~nodeにされ， `起点の直前？$tV （ “現在の” 走査-方向）は，渡された %方向 を反映するようにされる（ ~F が `順^i 方向に対応する）。 】

@nextNode()

被呼出時には、次の結果を返すモノトスル ⇒ `反復子で走査する$( 此れ, `順^i ) ◎ The nextNode() method, when invoked, must return the result of traversing with the context object and next.

@previousNode()

被呼出時には、次の結果を返すモノトスル ⇒ `反復子で走査する$( 此れ, `逆^i ) ◎ The previousNode() method, when invoked, must return the result of traversing with the context object and previous.

@detach()

被呼出時には、何もしないモノトスル。 ◎ The detach() method, when invoked, must do nothing.＼

注記： この機能性（ ^NodeIterator ~objの不能化）は、取除かれた。 互換性のため存続はするが。 ◎ Its functionality (disabling a NodeIterator object) was removed, but the method itself is preserved for compatibility.

6.2. ^@TreeWalker ~ifc

注記： $TreeWalker ~objは、 $Document ~obj上の $Document.createTreeWalker() ~methを利用して作成できる。 ◎ TreeWalker objects can be created using the createTreeWalker() method on Document objects.

各 $TreeWalker ~objには、 `現-~node@tV （ `~node$ ）が結付けられる。 ◎ Each TreeWalker object has an associated current (a node).

注記： 前に言及したように、 $TreeWalker ~objには［ `根$tV, `~whatToShow$tV, `~filter~callback$tV ］も結付けられる。 ◎ As mentioned earlier TreeWalker objects have an associated root, whatToShow, and filter as well.

@root

取得子は、此れの`根$tVを返すモノトスル。 ◎ The root attribute’s getter, when invoked, must return the context object’s root.

@whatToShow

取得子は、此れの `~whatToShow$tV を返すモノトスル。 ◎ The whatToShow attribute’s getter, when invoked, must return the context object’s whatToShow.

@filter

取得子は、此れの`~filter~callback$tVを返すモノトスル。 ◎ The filter attribute’s getter, when invoked, must return the context object’s filter.

@currentNode

取得子は、此れの`現-~node$tVを返すモノトスル。 ◎ The currentNode attribute’s getter, when invoked, must return the context object’s current.

設定子は、次を走らすモノトスル ⇒ 此れの`現-~node$tV ~SET 所与の値 ◎ The currentNode attribute’s setter, when invoked, must set the context object’s current to the given value.

@parentNode()

被呼出時には、次を走らすモノトスル： ◎ The parentNode() method, when invoked, must run these steps:

1. %node ~LET 此れの`現-~node$tV ◎ Let node be the context object’s current.

2. ~WHILE［ %node ~NEQ ~NULL ］~AND［ %node ~NEQ 此れの`根$tV ］： ◎ While node is non-null and is not the context object’s root:

   1. %node ~SET %node の`親$ ◎ Set node to node’s parent.
   2. ~IF［ %node ~NEQ ~NULL ］~AND［ `走査器の中で~nodeを~filterにかける$( 此れ, %node ) ~EQ $NodeFilter.FILTER_ACCEPT ］ ⇒＃ 此れの`現-~node$tV ~SET %node； ~RET %node ◎ If node is non-null and filtering node within the context object returns FILTER_ACCEPT, then set the context object’s current to node and return node.
3. ~RET ~NULL ◎ Return null.

`子たちを走査する@ ときは、所与の ( %walker, %向き ~IN { `最初から^i, `最後から^i } ) に対し，次を走らす： ◎ To traverse children, given a walker and type, run these steps:

1. %node ~LET %walker の`現-~node$tV ◎ Let node be walker’s current.
2. %node ~SET %向き に応じて ⇒＃ `最初から^i ならば %node の`最初の子？$ ／ `最後から^i ならば %node の`最後の子？$ ◎ Set node to node’s first child if type is first, and node’s last child if type is last.

3. ~WHILE［ %node ~NEQ ~NULL ］： ◎ While node is non-null:

   1. %結果 ~LET `走査器の中で~nodeを~filterにかける$( %walker, %node ) ◎ Let result be the result of filtering node within walker.
   2. ~IF［ %結果 ~EQ $NodeFilter.FILTER_ACCEPT ］ ⇒＃ %walker の`現-~node$tV ~SET %node； ~RET %node ◎ If result is FILTER_ACCEPT, then set walker’s current to node and return node.

   3. ~IF［ %結果 ~EQ $NodeFilter.FILTER_SKIP ］： ◎ If result is FILTER_SKIP, then:

      1. %子 ~LET %向き に応じて ⇒＃ `最初から^i ならば %node の`最初の子？$ ／ `最後から^i ならば %node の`最後の子？$ ◎ Let child be node’s first child if type is first, and node’s last child if type is last.
      2. ~IF［ %子 ~NEQ ~NULL ］ ⇒＃ %node ~SET %子； ~CONTINUE ◎ If child is non-null, then set node to child and continue.

   4. ~WHILE［ %node ~NEQ ~NULL ］： ◎ While node is non-null:

      1. %同胞 ~LET %向き に応じて ⇒＃ `最初から^i ならば %node の`次-同胞？$ ／ `最後から^i ならば %node の`前-同胞？$ ◎ Let sibling be node’s next sibling if type is first, and node’s previous sibling if type is last.
      2. ~IF［ %同胞 ~NEQ ~NULL ］ ⇒＃ %node ~SET %同胞； ~BREAK ◎ If sibling is non-null, then set node to sibling and break.
      3. %親 ~LET %node の`親$ ◎ Let parent be node’s parent.
      4. ~IF［ %親 ~IN { ~NULL, %walker の`根$tV, %walker の`現-~node$tV } ］ ⇒ ~RET ~NULL ◎ If parent is null, walker’s root, or walker’s current, then return null.
      5. %node ~SET %親 ◎ Set node to parent.

@firstChild()

被呼出時には、次を走らすモノトスル ⇒ ~RET `子たちを走査する$( 此れ, `最初から^i ) ◎ The firstChild() method, when invoked, must traverse children with the context object and first.

@lastChild()

被呼出時には、次を走らすモノトスル ⇒ ~RET `子たちを走査する$( 此れ, `最後から^i ) ◎ The lastChild() method, when invoked, must traverse children with the context object and last.

`同胞たちを走査する@ ときは、所与の ( %walker, %向き ~IN { `順^i, `逆^i } ) に対し，次を走らす： ◎ To traverse siblings, given a walker and type, run these steps:

1. ~IF［ %node ~EQ %walker の`根$tV ］ ⇒ ~RET ~NULL ◎ If node is root, then return null.
2. 1. %同胞 ~LET %向き に応じて ⇒＃ `順^i ならば %node の`次-同胞？$ ／ `逆^i ならば %node の`前-同胞？$ ◎ Let sibling be node’s next sibling if type is next, and node’s previous sibling if type is previous.

   2. ~WHILE［ %同胞 ~NEQ ~NULL ］： ◎ While sibling is non-null:

      1. %node ~SET %同胞 ◎ Set node to sibling.
      2. %同胞 ~SET %向き に応じて ⇒＃ `順^i ならば %node の`最初の子？$ ／ `逆^i ならば %node の`最後の子？$ ◎ Set sibling to node’s first child if type is next, and node’s last child if type is previous.
      3. ~IF［ %結果 ~EQ $NodeFilter.FILTER_REJECT ］~OR［ %同胞 ~EQ ~NULL ］ ⇒ %同胞 ~SET %向き に応じて ⇒＃ `順^i ならば %node の`次-同胞？$ ／ `逆^i ならば %node の`前-同胞？$ ◎ If result is FILTER_REJECT or sibling is null, then set sibling to node’s next sibling if type is next, and node’s previous sibling if type is previous.
   3. %node ~SET %node の`親$ ◎ Set node to node’s parent.
   4. ~IF［ %node ~IN { ~NULL, %walker の`根$tV } ］ ⇒ ~RET ~NULL ◎ If node is null or walker’s root, then return null.
   5. ~IF［ `走査器の中で~nodeを~filterにかける$( 此れ, %node ) ~EQ $NodeFilter.FILTER_ACCEPT ］ ⇒ ~RET ~NULL ◎ If the return value of filtering node within walker is FILTER_ACCEPT, then return null.

@nextSibling()

被呼出時には、次を走らすモノトスル ⇒ ~RET `同胞たちを走査する$( 此れ, `順^i ) ◎ The nextSibling() method, when invoked, must traverse siblings with the context object and next.

@previousSibling()

被呼出時には、次を走らすモノトスル ⇒ ~RET `同胞たちを走査する$( 此れ, `逆^i ) ◎ The previousSibling() method, when invoked, must traverse siblings with the context object and previous.

@previousNode()

被呼出時には、次を走らすモノトスル： ◎ The previousNode() method, when invoked, must run these steps:

1. ~WHILE［ %node ~NEQ 此れの`根$tV ］： ◎ While node is not the context object’s root:

   1. %同胞 ~LET %node の`前-同胞？$ ◎ Let sibling be node’s previous sibling.

   2. ~WHILE［ %同胞 ~NEQ ~NULL ］： ◎ While sibling is non-null:

      1. %node ~SET %同胞 ◎ Set node to sibling.
      2. %結果 ~LET `走査器の中で~nodeを~filterにかける$( 此れ, %node ) ◎ Let result be the result of filtering node within the context object.

      3. ~WHILE［ %結果 ~NEQ $NodeFilter.FILTER_REJECT ］~AND［ %node は`子$を持つ ］： ◎ While result is not FILTER_REJECT and node has a child:

         1. %node ~SET %node の`最後の子？$ ◎ Set node to node’s last child.
         2. %結果 ~SET `走査器の中で~nodeを~filterにかける$( 此れ, %node ) ◎ Set result to the result of filtering node within the context object.
      4. ~IF［ %結果 ~EQ $NodeFilter.FILTER_ACCEPT ］ ⇒＃ 此れの`現-~node$tV ~SET %node； ~RET %node ◎ If result is FILTER_ACCEPT, then set the context object’s current to node and return node.
      5. %同胞 ~SET %node の`前-同胞？$ ◎ Set sibling to node’s previous sibling.
   3. ~IF［ %node ~EQ 此れの`根$tV ］~OR［ %node の`親$ ~EQ ~NULL ］ ⇒ ~RET ~NULL ◎ If node is the context object’s root or node’s parent is null, then return null.
   4. %node ~SET %node の`親$ ◎ Set node to node’s parent.
   5. ~IF［ `走査器の中で~nodeを~filterにかける$( 此れ, %node ) ~EQ $NodeFilter.FILTER_ACCEPT ］ ⇒＃ 此れの`現-~node$tV ~SET %node； ~RET %node ◎ If the return value of filtering node within the context object is FILTER_ACCEPT, then set the context object’s current to node and return node.

@nextNode()

被呼出時には、次を走らすモノトスル： ◎ The nextNode() method, when invoked, must run these steps:

1. %結果 ~LET $NodeFilter.FILTER_ACCEPT ◎ Let result be FILTER_ACCEPT.
2. 1. 1. %node ~SET %node の`最初の子？$ ◎ Set node to its first child.
   2. %同胞 ~LET ~NULL ◎ Let sibling be null.
   3. %temporary ~LET %node ◎ Let temporary be node.

   4. ~WHILE［ %temporary ~NEQ ~NULL ］： ◎ While temporary is non-null:

      1. ~IF［ %temporary ~EQ 此れの`根$tV ］ ⇒ ~RET ~NULL ◎ If temporary is the context object’s root, then return null.
      2. %同胞 ~SET %temporary の`次-同胞？$ ◎ Set sibling to temporary’s next sibling.
      3. ~IF［ %同胞 ~NEQ ~NULL ］ ⇒ ~BREAK ◎ If sibling is non-null, then break.
      4. %temporary ~SET %temporary の`親$ ◎ Set temporary to temporary’s parent.
   5. 【次の段を行う前に “ %node ~SET %同胞 ” が必要では？】

6.3. ^@NodeFilter ~ifc

注記： $NodeFilter ~objは、［ $NodeIterator ／ $TreeWalker ］用の`~filter~callback$tVとして利用できる。 また、それら用の`~whatToShow$tVとして~bitmask定数を供する。 $NodeFilter ~objは、概して，~JS関数として実装される。 ◎ NodeFilter objects can be used as filter for NodeIterator and TreeWalker objects and also provide constants for their whatToShow bitmask. A NodeFilter object is typically implemented as a JavaScript function.

`~filter~callback$tVの返値には、次の定数を利用できる（括弧内は数-値） 【各~項目の説明は、訳者による補足】： ◎ These constants can be used as filter return value:

@FILTER_ACCEPT (1)

~nodeは~filterを “通過する”。

@FILTER_REJECT (2)

$NodeIterator に利用されている下では、 $FILTER_SKIP と同じ結果になる。

$TreeWalker に利用されている下では、~nodeはその子孫も含めて “濾過される”。

@FILTER_SKIP (3)

~node自身は “濾過される” が、その子孫は，依然として~filterの対象になり得る。

`~whatToShow$tV用には、次の定数を利用できる（括弧内は数-値）： ◎ These constants can be used for whatToShow:

• @SHOW_ALL (4294967295 ~EQ 0xFFFFFFFF)
• @SHOW_ELEMENT (1)
• @SHOW_ATTRIBUTE (2)
• @SHOW_TEXT (4)
• @SHOW_CDATA_SECTION (8)
• @SHOW_PROCESSING_INSTRUCTION (64 ~EQ 0x40)
• @SHOW_COMMENT (128 ~EQ 0x80)
• @SHOW_DOCUMENT (256 ~EQ 0x100)
• @SHOW_DOCUMENT_TYPE (512 ~EQ 0x200)
• @SHOW_DOCUMENT_FRAGMENT (1024 ~EQ 0x400)

7.1. ^@DOMTokenList ~ifc

`適用-可能な仕様$は、個々の`局所~名$aに対し，それが `~supportする~token集合@tL を $DOMTokenList 用に定義してもヨイ — これは、一連の~tokenからなる集合であり，特に指定されない限り ε （未定義）とする。 ◎ Specifications may define supported tokens for a DOMTokenList's associated attribute’s local name.

$DOMTokenList ~obj %O 上で `~tokenを検証する@ ときは、所与の ( %~token ) に対し，次を走らす： ◎ A DOMTokenList object’s validation steps for a given token are:

• %~token集合 ~LET %O の`属性oの局所~名$tLが`~supportする~token集合$tL ◎ ↓
• ~IF［ %~token集合 ~EQ ε ］ ⇒ ~THROW `TypeError$E ◎ If the associated attribute’s local name does not define supported tokens, throw a TypeError.
• ~RET ［ 次が満たされるならば ~T ／ ~ELSE_ ~F ］ ⇒ `~ASCII小文字~化する$( %~token ) ~IN %~token集合 ◎ Let lowercase token be a copy of token, in ASCII lowercase. ◎ If lowercase token is present in supported tokens, return true. ◎ Return false.

所与の $DOMTokenList ~obj %O 対し， ( %要素, %名前 ) は ( %O の`要素$tL, %O の`属性oの局所~名$tL ) とするとき： ◎ ↓

• %O の `更新~手続き@tL は、次を走らす： ◎ A DOMTokenList object’s update steps are:

  1. ~IF［ %要素 の`属性o~list$は空である ］~AND［ %O の`~token集合$tLは空である ］ ⇒ ~RET ◎ If the associated element does not have an associated attribute and token set is empty, then return.
  2. %要素 の`属性o値を設定する$( %名前, ［ %O の`~token集合$tLを`有順序~集合 直列化器$にかけた結果 ］ ) ◎ Set an attribute value for the associated element using associated attribute’s local name and the result of running the ordered set serializer for token set.
• %O の `直列化-手続き@tL は、次の結果を返す ⇒ %要素 の`属性o値を取得する$( %名前 ) ◎ A DOMTokenList object’s serialize steps are to return the result of running get an attribute value given the associated element and the associated attribute’s local name.

• %要素 上の`属性o変更-時の手続き$は、次で与えられる： ◎ A DOMTokenList object has these attribute change steps for its associated element:

  1. ~IF［ %局所~名 ~EQ %名前 ］~AND［ %~ns ~EQ ~NULL ］：

     1. ~IF［ %値 ~EQ ~NULL ］ ⇒ %O の`~token集合$tLを`空にする$
     2. ~ELSE ⇒ %O の`~token集合$tL ~SET %値 を`有順序~集合 構文解析器$にかけた結果
     ◎ If localName is associated attribute’s local name, namespace is null, and value is null, then empty token set. ◎ Otherwise, if localName is associated attribute’s local name, namespace is null, then set token set to value, parsed.

• %O の作成-時には、次を走らす： ◎ When a DOMTokenList object is created, then:

  1. %値 ~LET %要素 の`属性o値を取得する$( %名前 ) ◎ Let element be associated element. ◎ Let localName be associated attribute’s local name. ◎ Let value be the result of getting an attribute value given element and localName.
  2. 次を渡して， %要素 上の`属性o変更-時の手続き$を走らす ⇒ ( %名前, %値, %値, ~NULL ) ◎ Run the attribute change steps for element, localName, value, value, and null.

%tokenlist . $length

~tokenの個数を返す。 ◎ Returns the number of tokens.

%tokenlist . $item(index)

%tokenlist[%index]

%index 番の~tokenを返す。 ◎ Returns the token with index index.

%tokenlist . $contains(token)

%token が在れば~T を, 無ければ~F を返す。 ◎ Returns true if token is present, and false otherwise.

%tokenlist . $add(tokens…)

渡された引数のうち，まだ無いものを追加する。 ◎ Adds all arguments passed, except those already present.

下記に該当する場合、例外が投出される。 ◎ Throws a "SyntaxError" DOMException if one of the arguments is the empty string. ◎ Throws an "InvalidCharacterError" DOMException if one of the arguments contains any ASCII whitespace.

%tokenlist . $remove(tokens…)

渡された引数のそれぞれを（もし在れば）除去する。 ◎ Removes arguments passed, if they are present.

◎ Throws a "SyntaxError" DOMException if one of the arguments is the empty string. ◎ Throws an "InvalidCharacterError" DOMException if one of the arguments contains any ASCII whitespace.

%tokenlist . $toggle(token [, force])

%force に応じて：

• 省略されているならば、 %token の有無を “切り替える”。 すなわち、 %token がすでに在れば除去し，無ければ追加する。
• ~T ならば、 %token を追加する（ $add() と同じ）。
• ~F ならば、 %token を除去する（ $remove() と同じ）。

その結果、 %token が残っていれば ~T を, 無くなっていれば ~F を返す。

◎ If force is not given, "toggles" token, removing it if it’s present and adding it if it’s not present. If force is true, adds token (same as add()). If force is false, removes token (same as remove()). ◎ Returns true if token is now present, and false otherwise.

◎ Throws a "SyntaxError" DOMException if token is empty. ◎ Throws an "InvalidCharacterError" DOMException if token contains any spaces.

%tokenlist . $replace(token, newToken)

%token を %newToken に置換する。 ◎ Replaces token with newToken.

%token が %newToken に置換されたなら ~T, 置換されなかったなら ~F を返す。 ◎ Returns true if token was replaced with newToken, and false otherwise.

◎ Throws a "SyntaxError" DOMException if one of the arguments is the empty string. ◎ Throws an "InvalidCharacterError" DOMException if one of the arguments contains any ASCII whitespace.

（例外）

上の各種~methに所与の文字列~引数のいずれかが，次に該当する場合、対応する例外が投出される：

• 空~文字列の場合： `SyntaxError$E
• `~ASCII空白$を含む場合： `InvalidCharacterError$E

◎ ↑

%tokenlist . $supports(token)

`属性oの局所~名$tLが`~supportする~token集合$tLに %token が含まれて［ いれば ~T ／ いなければ ~F ］を返す。 ◎ Returns true if token is in the associated attribute’s supported tokens. Returns false otherwise.

`~supportする~token集合$tLが定義されていない場合、 `TypeError$E が投出される。 ◎ Throws a TypeError if the associated attribute has no supported tokens defined.

%tokenlist . $value

結付けられている`~token集合$tLを文字列として返す。 ◎ Returns the associated set as string.

設定して結付けられている属性を変更できる。 ◎ Can be set, to change the associated attribute.

@length

取得子は、［ 此れの`~token集合$tLの`~size$ ］を返すモノトスル。 ◎ The length attribute' getter must return context object’s token set’s size.

$DOMTokenList ~obj %O が`~supportする~prop~index$は、 0 以上［ %O の`~token集合$tLの`~size$ ］未満とする。 ◎ The object’s supported property indices are the numbers in the range zero to object’s token set’s size minus one, unless token set is empty, in which case there are no supported property indices.

@item(index)

被呼出時には、次を走らすモノトスル： ◎ The item(index) method, when invoked, must run these steps:

1. ~IF［ %index ~NIN { 此れが`~supportする~prop~index$ } ］ ⇒ ~RET ~NULL ◎ If index is equal to or greater than context object’s token set’s size, then return null.
2. ~RET 此れの`~token集合$tL[ %index ] ◎ Return context object’s token set[index].

@contains(token)

被呼出時には、［ 次が満たされるならば ~T ／ ~ELSE_ ~F ］を返すモノトスル ⇒ %token ~IN 此れの`~token集合$tL ◎ The contains(token) method, when invoked, must return true if context object’s token set[token] exists, and false otherwise.

@add(tokens…)

被呼出時には、次を走らすモノトスル： ◎ The add(tokens…) method, when invoked, must run these steps:

1. %tokens 内の ~EACH( %token ) に対し，与えられた順に ⇒ `~tokenを検査する$( %token ) ◎ For each token in tokens: • If token is the empty string, then throw a "SyntaxError" DOMException. • If token contains any ASCII whitespace, then throw an "InvalidCharacterError" DOMException.
2. %tokens 内の ~EACH( %token ) に対し ⇒ 此れの`~token集合$tLに %token を`付加する$set ◎ For each token in tokens, append token to context object’s token set.
3. 此れの`更新~手続き$tLを走らす ◎ Run the update steps.

@remove(tokens…)

被呼出時には、次を走らすモノトスル： ◎ The remove(tokens…) method, when invoked, must run these steps:

1. %tokens 内の各 %token に対し ⇒ 此れの`~token集合$tLから %token を`除去する$ ◎ For each token in tokens, remove token from context object’s token set.

@toggle(token, force)

被呼出時には、次を走らすモノトスル： ◎ The toggle(token, force) method, when invoked, must run these steps:

1. `~tokenを検査する$( %token ) ◎ If token is the empty string, then throw a "SyntaxError" DOMException. ◎ If token contains any ASCII whitespace, then throw an "InvalidCharacterError" DOMException.

2. ~IF［ %token ~IN 此れの`~token集合$tL ］： ◎ If context object’s token set[token] exists, then:

   1. ~IF［ %force は与えられてない ］~OR［ %force ~EQ ~F ］：

      1. 此れの`~token集合$tLから %token を`除去する$
      2. 此れの`更新~手続き$tLを走らす
      3. ~RET ~F
      ◎ If force is either not given or is false, then remove token from context object’s token set, run the update steps and return false.
   2. ~RET ~T ◎ Return true.

3. ~IF［ %force は与えられてない ］~OR［ %force ~EQ ~T ］：

   1. 此れの`~token集合$tLに %token を`付加する$set
   2. 此れの`更新~手続き$tLを走らす
   3. ~RET ~T
   ◎ Otherwise, if force not given or is true, append token to context object’s token set, run the update steps, and return true.
4. ~RET ~F ◎ Return false.

注記： ~web互換性のため、 $toggle() に対しては，`更新~手続き$tLを常に走らすとは限らない。 ◎ The update steps are not always run for toggle() for web compatibility.

@replace(token, newToken)

被呼出時には、次を走らすモノトスル： ◎ The replace(token, newToken) method, when invoked, must run these steps:

1. ~IF［ %token ~EQ 空~文字列 ］~OR［ %newToken ~EQ 空~文字列 ］ ⇒ ~THROW `SyntaxError$E ◎ If either token or newToken is the empty string, then throw a "SyntaxError" DOMException.
2. ~IF［ %token は`~ASCII空白$を含んでいる ］~OR［ %newToken は`~ASCII空白$を含んでいる ］ ⇒ ~THROW `InvalidCharacterError$E ◎ If either token or newToken contains any ASCII whitespace, then throw an "InvalidCharacterError" DOMException.
3. ~IF［ %token ~NIN 此れの`~token集合$tL ］ ⇒ ~RET ~F ◎ If context object’s token set does not contain token, then return false.
4. 此れの`~token集合$tL内で %token を %newToken に`置換する$setする ◎ Replace token in context object’s token set with newToken.
5. ~RET ~T ◎ Return true.

注記： ~web互換性のため、 $replace() に対しては，`更新~手続き$tLを常に走らすとは限らない。 ◎ The update steps are not always run for replace() for web compatibility.

【 最初と二番目の段は、 %token, %newToken の順に`~tokenを検査する$のとは，挙動が異なる。 】

@supports(token)

被呼出時には、次の結果を返すモノトスル ⇒ 此れ上で`~tokenを検証する$( %token ) ◎ The supports(token) method, when invoked, must run these steps: • Let result be the return value of validation steps called with token. • Return result.

@value

取得子は、此れの`直列化-手続き$tLを走らせた結果を返すモノトスル。 ◎ The value attribute must return the result of running context object’s serialize steps.

設定子は、次を走らすモノトスル ⇒ 此れの`要素$tLの`属性o値を設定する$( 此れの`属性oの局所~名$tL, 所与の値 ) ◎ Setting the value attribute must set an attribute value for the associated element using associated attribute’s local name and the given value.

8.1. DOM Events （~event）

以下は `DOM Level 3 Events^cite の［ "DOM Event Architecture", "Basic Event Interfaces", "Mutation Events", "Mutation Name Event Types" ］各~章に述べられた特色機能に加えられた変更点である。 他の章は `UI Events^cite 仕様 `UIEVENTS$r に移行されるものと期待されている。 ◎ These are the changes made to the features described in the "DOM Event Architecture", "Basic Event Interfaces", "Mutation Events", and "Mutation Name Event Types" chapters of DOM Level 3 Events. The other chapters are defined by the UI Events specification. [UIEVENTS]

• @MutationEvent, @MutationNameEvent は除去された。 ◎ Removes MutationEvent and MutationNameEvent.
• 発火-（ `fire^en ）は今や配送-（ `dispatch^en ）の同義語ではなく，~eventの初期化も含む。 ◎ Fire is no longer synonymous with dispatch, but includes initializing an event.
• `伝播停止$f（`伝播即停止$f）と`取消d$fは、配送-後ではなく， $Event.initEvent() を呼出した時に~OFF にされる。 ◎ The propagation and canceled flags are unset when invoking initEvent() rather than after dispatch.
• $Event の $Event.timeStamp 属性は、 $DOMTimeStamp 型ではなく， $DOMHighResTimeStamp 型にされた。 ◎ Event's timeStamp attribute is a DOMHighResTimeStamp rather than a DOMTimeStamp.

8.2. DOM Core

以下は `DOM Level 3 Core^cite で述べられた特色機能に加えられた変更点である。 ◎ These are the changes made to the features described in DOM Level 3 Core.

$DOMString, $DOMException, $DOMTimeStamp は、今や Web IDL にて定義される。 ◎ DOMString, DOMException, and DOMTimeStamp are now defined in Web IDL.

$DOMStringList は、今や~HTMLにて定義される。 ◎ DOMStringList is now defined in HTML.

@hasAttributes(), @attributes は、 $Node から $Element へ移動された。 ◎ hasAttributes() and attributes moved from Node to Element.

@namespaceURI, @prefix, @localName は、 $Node から $Element, $Attr へ移動された。 ◎ namespaceURI, prefix, and localName moved from Node to Element and Attr.

この節に挙げる，残りの~ifcと~ifc~memberは、~web~platformを単純~化するために取除かれた。 この仕様に適合する実装は、それらを~supportしないことになる。 ◎ The remainder of interfaces and interface members listed in this section were removed to simplify the web platform. Implementations conforming to this specification will not support them.

~ifc： ◎ Interfaces:

• @DOMConfiguration
• @DOMError
• @DOMErrorHandler
• @DOMImplementationList
• @DOMImplementationSource
• @DOMLocator
• @DOMObject
• @DOMUserData
• @Entity
• @EntityReference
• @NameList
• @Notation
• @TypeInfo
• @UserDataHandler

~ifc~member： ◎ Interface members:

$@Node

• @isSupported
• @getFeature()
• @getUserData()
• @setUserData()

$@Document

• @createEntityReference()
• @xmlEncoding
• @xmlStandalone
• @xmlVersion
• @strictErrorChecking
• @domConfig
• @normalizeDocument()
• @renameNode()

$@DOMImplementation

• @getFeature()

$@Attr

• @schemaTypeInfo
• @isId

$@Element

• @schemaTypeInfo
• @setIdAttribute()
• @setIdAttributeNS()
• @setIdAttributeNode()

$@DocumentType

• @entities
• @notations
• @internalSubset

$@Text

• @isElementContentWhitespace
• @replaceWholeText()

8.3. DOM Ranges （範囲o）

以下は `DOM Level 2 Traversal and Range^cite. の "Document Object Model Range" 章にて述べられている特色機能に加えられた変更点である。 ◎ These are the changes made to the features described in the "Document Object Model Range" chapter of DOM Level 2 Traversal and Range.

• @RangeException は取除かれた。 ◎ RangeException has been removed.
• $detach は今や何もしない。 ◎ detach() is now a no-op.

8.4. DOM Traversal （走査）

以下は `DOM Level 2 Traversal and Range^cite の "Document Object Model Traversal" 章にて述べられている 特色機能に加えられた変更点である。 ◎ These are the changes made to the features described in the "Document Object Model Traversal" chapter of DOM Level 2 Traversal and Range.

• $@Document の $createNodeIterator(), $createTreeWalker() は、今や省略可の引数をとり，最早~DOMには決して取り込まれない実体参照を与える 4 個目の引数は除かれた。 ◎ createNodeIterator() and createTreeWalker() now have optional arguments and lack a fourth argument which is no longer relevant given entity references never made it into the DOM.
• 前述の理由により， @NodeIterator.expandEntityReferences 属性は $NodeIterator および $TreeWalker ~ifcから除去された。 ◎ The expandEntityReferences attribute has been removed from the NodeIterator and TreeWalker interfaces for the aforementioned reason.
• ~UAのふるまいに揃えるため、 $nextNode() と $previousNode() は今や $NodeFilter から呼出されたときに例外を投出し得る。 ◎ nextNode() and previousNode() now throw when invoked from a NodeFilter to align with user agents.
• $detach は今や何もしない。 ◎ detach() is now a no-op.