DOM

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

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

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

1.1. ~tree

`~tree@ とは、有限かつ階層的な~tree構造である。 `~tree順序@ は、深優先前順走査に基づく。 ◎ 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>~tree順序に</e></e>なる</e></e>

`~tree$に `関与して@ いる各~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の`親$の`根$である。 `~tree$の`根$は、その`~tree$に`関与して$いる~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 は同じ`~tree$に関与する ］~AND［ `~tree順序$において %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 は同じ`~tree$に関与する ］~AND［ `~tree順序$において %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. 有順序~集合

1.3. 選択子

1.4. ~ns

2.1. “DOM Events” 序論

~web~platformを全体を通して、`~event$は — 何かが生じたことを通達するために — ~objに向けて`配送-$される — ~network活動や利用者とのヤリトリなど。 これらの~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$が`~tree$に`関与して$いる~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$が`~tree順序$で呼出される。 ◎ 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$が，今度は`~tree順序$の逆順に呼出される。 ◎ 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$であり、初期~時は空とする。 それを成す各 `構造体$は次のものからなる：

`呼出n~target@evP

$EventTarget ~obj。

`呼出n~targetは~shadow~tree内？@evP

真偽値。

`~shadow調整-済み~target@evP

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

`関係d~target@evP

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

`~touch~target~list@evP

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

`閉な~treeの根？@evP

真偽値。

`~slotは閉な~tree内？@evP

真偽値。

◎ An event has an associated path. A path is a list of structs. Each struct consists of an invocation target (an EventTarget object), an invocation-target-in-shadow-tree (a boolean), a shadow-adjusted 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 の`経路$内に在る各 `呼出n~target$evP ~obj（それ上で~listenerが呼出される~obj）からなる~listを返す — ただし、［ `~shadow根$の`~mode$sR ~EQ `closed^l ］なる`~shadow~tree$内の`~node$であって， %event の $currentTarget からは到達できないものは、返り値から除かれる。 ◎ Returns the invocation target 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()

`~tree$ 内に`配送-$されているとき、この~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$ ］には到達しなくなり、`~tree$ 内に`配送-$されたときには， %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$の`先祖$へ`~tree順序$の逆順にも遡る場合は ~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~tree$へつながるように，構成される。 】

%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下位tree~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 ] の`閉な~treeの根？$evP ~EQ ~T ］ ⇒ %現-~targetの~hidden下位tree~level ~INCBY 1 ◎ If path[index]'s root-of-closed-tree is true, then increase currentTargetHiddenSubtreeLevel by 1.
   2. ~IF［ %経路[ %~index ] の`呼出n~target$evP ~EQ %現-~target ］ ⇒＃ %現-~target~index ~SET %~index； ~BREAK ◎ If path[index]'s invocation target is currentTarget, then set currentTargetIndex to index and break.
   3. ~IF［ %経路[ %~index ] の`~slotは閉な~tree内？$evP ~EQ ~T ］ ⇒ %現-~targetの~hidden下位tree~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 ~LET %現-~targetの~hidden下位tree~level ◎ ↓
11. %最大-~hidden~level ~LET %現-~targetの~hidden下位tree~level ◎ Let currentHiddenLevel and maxHiddenLevel be currentTargetHiddenSubtreeLevel.
12. %~index ~SET %現-~target~index ~MINUS 1 ◎ Set index to currentTargetIndex − 1.

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

    1. ~IF［ %経路[ %~index ] の`閉な~treeの根？$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 ] の`呼出n~target$evPを`前付加する$ ◎ If currentHiddenLevel is less than or equal to maxHiddenLevel, then prepend path[index]'s invocation target to composedPath.

    3. ~IF［ %経路[ %~index ] の`~slotは閉な~tree内？$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.
14. %現-~hidden~level ~SET %現-~targetの~hidden下位tree~level ◎ ↓
15. %最大-~hidden~level ~SET %現-~targetの~hidden下位tree~level ◎ Set currentHiddenLevel and maxHiddenLevel to currentTargetHiddenSubtreeLevel.
16. %~index ~SET %現-~target~index ~PLUS 1 ◎ Set index to currentTargetIndex + 1.

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

    1. ~IF［ %経路[ %~index ] の`~slotは閉な~tree内？$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 ] の`呼出n~target$evPを`付加する$ ◎ If currentHiddenLevel is less than or equal to maxHiddenLevel, then append path[index]'s invocation target to composedPath.

    3. ~IF［ %経路[ %~index ] の`閉な~treeの根？$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.
18. ~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$が`~tree$に`関与して$いる~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$が`~tree$に`関与して$いる~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が結付けられる — いずれも真偽値をとり，初期~時は ~F をとるとする ⇒＃ `伝播停止@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 ~T ◎ The stopPropagation() method, when invoked, must set the context object’s stop propagation flag.

@cancelBubble

取得子は、此れの`伝播停止$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 ~T ◎ 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 ( ~T, ~T ) ◎ 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.

@returnValue

取得子は、此れの`取消d$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を返すモノトスル ◎ 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を返すモノトスル ◎ 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.

@initEvent(type, bubbles, cancelable)

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

1. ~IF［ 此れの`配送-$f ~EQ ~T ］ ⇒ ~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^jv ／ $Event ~obj ］であり、他が言明されない限り， `undefined^jv とする。 ◎ 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~tree$内に配送される~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で利用される。 【！initCustomEvent is dead】 ◎ 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 ~T ］ ⇒ ~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.

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.

@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 も，~tree構造には関与しない。 ◎ 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.

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

@removeEventListener(type, callback, options)

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

1. ~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 ~T ］~OR［ %event の`初期化-済み$f ~EQ ~F ］ ⇒ ~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$の影響iは、その `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の挙動における処理能に劇的に影響iし得る結果、~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の配送-法

2.10. ~eventの発火-法

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を ~T にした上で、結付けられている活動が中止されることになるよう，観測器たちにも通達することになる。 ◎ 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

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

`中止する~algoたち@aB

何個かの~algoからなる`有順序~集合$。 他が指定されない限り，空とする。 これらの~algoは、［ `中止-済み~flag$aB ~SET ~T ］にされたとき，実行されることになる。 ◎ 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を追加する$” を利用する他の仕様を見ないとはっきりしない。 】

@aborted

取得子は、此れの`中止-済み~flag$aBを返すモノトスル ◎ The aborted attribute’s getter, when invoked, must return true if the context object’s aborted flag is set, and false otherwise.

@onabort

`onabort@c `~event~handler$用の`~event~handler~IDL属性$ — その`~event~handler~event型$は `abort@et とする。 ◎ The onabort attribute is an event handler IDL attribute for the onabort event handler, whose event handler event type is abort.

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

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に応じて：

  • すでに ~T の場合： 即時に却下すること。 ◎ Reject immediately if the AbortSignal's aborted flag is already set, otherwise:
  • 他の場合： $AbortSignal ~objの変化を観測するときは、`中止する~algoたち$aBによる仕組みを，他の観測器と衝突し得ない方式で利用すること。 ◎ 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~tree$として表現される。 `~tree$を成す`~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$たちが成す`~tree$が出来上がる。 【！You /can/ explain that! harharhar】 ◎ 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~tree

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

$Document

`~tree順序$において，次からなる： ◎ 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 であるとは、［ その`長さ$ ~EQ 0 ］を意味する。 【この訳では、この用語は利用しない — ほぼ利用されておらず，単に “長さ ~EQ 0” と記せば済むので。】 ◎ A node is considered empty if its length is zero.

4.3. 変異~観測器

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

注記： `一時~登録-済み観測器$は、所与の`~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 を継承しているが、定義により，~treeには`関与-$しないことに注意。 （ “^Attr `~node$” という語も何箇所かに現れていて紛らわしいが。） 】

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

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

%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内容$ ◎ The descendant text content of the context object.

$Attr

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

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

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

$Document

$DocumentType

~NULL ◎ Null.

$textContent

設定子は、次を走らすモノトスル： ◎ 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

   此れの`全~内容を文字列に置換する$( 所与の値 ) ◎ String replace all with the given value 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:

   【 ~tree順序で。 加えて，~~厳密に言えば、このループの中で~treeから除去される ^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 ) に対し，順に ⇒ `~nodeを除去する$( %text ) ◎ Remove node’s contiguous exclusive Text nodes (excluding itself), in tree order.

%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用に，そのような手続きが（例えば，複数の仕様にて）複数~定義された場合、それらを走らす順序も有意になり得るが，言及されていないので想定されていない（または有意にならない）と見受けられる。 他の “〜時の手続き” （例： `挿入-時の手続き$）も同様。 】

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

@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 は同じ`~tree$に属さない。 ◎ 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~treeどうしの順序も循環しないように一貫するべきであろう。】 ◎ 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$は`~tree$には`関与-$しないが、この~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).

@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を挿入でき，~treeの一部を成すことになる — より一般には、文書~言語の内容~modelでは許容されなくても，`~node~tree$の拘束に反しない限り挿入できる。 ~treeを改変する他の~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.

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

@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 (~U003A) を含むならば それを挟んだ ( 前, 後 ) の部分 ／ 他の場合は ( ~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【！localName】 が `Name$prod 生成規則に合致しない場合、 `InvalidCharacterError$E 例外が投出される。 ◎ If localName does not match the Name production an "InvalidCharacterError" DOMException will be thrown.

次のいずれかに該当する場合， `NamespaceError$E 例外が投出される ⇒＃ %qualifiedName【！localName】 は `QName$prod 生成規則に合致しない ／ %namespace ~EQ 空~文字列 ~AND %接頭辞 ~NEQ ~NULL ／ %namespace ~NEQ `~XML~ns$ ~AND %接頭辞 ~EQ `xml^l ／ %namespace ~NEQ `~XMLNS~ns$ ~AND %qualifiedName ~EQ `xmlns^l ／ %namespace ~NEQ `~XMLNS~ns$ ~AND %接頭辞 ~EQ `xmlns^l ／ %namespace ~EQ `~XMLNS~ns$ ~AND %qualifiedName ~NEQ `xmlns^l ／ %namespace ~EQ `~XMLNS~ns$ ~AND %接頭辞 ~NEQ `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)

被呼出時には、次の結果を返すモノトスル ⇒ `内部 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.

@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. ~IF［ %node は`文書片$である ］~AND［ %node の`~host$ ~NEQ ~NULL ］ ⇒ ~RET ◎ If node is a DocumentFragment node whose host is non-null, then return.
4. 此れに`~nodeを受入する$( %node ) ◎ Adopt node into the context object.
5. ~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 空~文字列, $Event.timeStamp ~SET `現在の高分解能~時刻$, $Event.isTrusted ~SET ~F ◎ Initialize event’s type attribute to the empty string. ◎ Initialize event’s timeStamp attribute to a DOMHighResTimeStamp representing the high resolution time from the time origin to now. ◎ Initialize event’s isTrusted attribute to false.
7. %~event の`初期化-済み$f ~SET ~F ◎ Unset event’s initialized flag.
8. ~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に影響iする。 ◎ 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 ~F ］~AND［ %根 ~EQ ［［［ %~event の`経路$ ］内の最初の構造体 ］の`呼出n~target$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 invocation target, 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.

@onslotchange

`onslotchange@c `~event~handler$用の`~event~handler~IDL属性$ — その`~event~handler~event型$は `slotchange$et とする。 ◎ The onslotchange attribute is an event handler IDL attribute for the onslotchange event handler, whose event handler event type is slotchange.

`~node~tree$ %~tree における `~shadowも含む~tree順序@ は、 `~shadowも含む深優先前順走査@ による順序であり，次に従う ⇒ %~tree に対する深優先前順走査 【すなわち，通常の~tree順序】 に従いつつ， %~tree において［ `~shadow~host$である`要素$ %要素 ］に遭遇した各所では，［［ %要素 の`~shadow根$elmを根とする`~node~tree$ ］における，`~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 からは `閉な~shadowで隠されて@ いるとは、 %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 からは`閉な~shadowで隠されて$いる ］ ◎ A’s root is a shadow root whose mode is "closed" or A’s root’s host is closed-shadow-hidden from B.

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~tree$を~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.

各`要素$は、 `属性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~list$内に`属性o$ %属性o が在ることを， %要素 は %属性o を `有する@ （ `has^en ）ともいう。 ◎ An element has an attribute A if its attribute list contains A.

【 この場合、［ %属性o が`属する要素$ ~EQ %要素 ］も満たすことになる — 複数の`要素$が同じ`属性o$を`有する$ことはない（~algo内で同期的に遂行される ある瞬間を除いて）。 】【 “有する” という句は、他の仕様（主に~HTML）で利用されている。 しかしながら，この訳では、この用語を（この仕様~内では）利用せず，一律に`属性o~list$（適用-可能な所では`属する要素$）を通して述べることにする。 】

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

`要素$には、一意な識別子である `~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^A ／ `class^A ／ `slot^A ］`属性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.

@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^A ／ `class^A ／ `slot^A ］`属性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~list$は［ 空でないならば ~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~list$内の`属性o$のうち次を満たす`最初のもの？$を返す ⇒ `有修飾~名$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~list$内の`属性o$のうち次を満たす`最初のもの？$を返す ⇒ ［ `~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~list$内に次を満たす`属性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~list$内に次を満たす`属性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~list$内に次を満たす`属性o$が在るならば［ それらのうち最初のもの ］を %element から除去する ⇒ `有修飾~名$a ~EQ %qualifiedName ◎ Removes element’s first attribute whose qualified name is qualifiedName.

%element . $removeAttributeNS(namespace , localName )

%element の`属性o~list$内に次を満たす`属性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~list$内に次を満たす`属性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~list$内に次を満たす`属性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$内に在る`属性o$のうち，次を満たす`最初のもの？$ ⇒ `有修飾~名$a ~EQ %qualifiedName ◎ 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 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 ) 【！ ＊and then return undefined.】 ◎ 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 ) 【！＊and then return undefined.】 ◎ 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~list$内に次を満たす`属性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~list$内に次を満たす`属性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.
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［ 此れの`局所~名$は 次のいずれにも該当しない ］…：

   • `妥当な~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, `main^l, `nav^l, `p^l, `section^l, `span^l

   …ならば ⇒ ~THROW `NotSupportedError$E

   ◎ 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［ 此れの`局所~名$は`妥当な~custom要素~名$である ］~OR［ 此れの`~is0値$ ~NEQ ~NULL ］： ◎ If context object’s local name is a valid custom element name, or context object’s is value is not null, then:

   1. %定義 ~LET `~custom要素~定義を検索する$( 此れの`~node文書$, 此れの`~ns$, 此れの`局所~名$, 此れの`~is0値$ ) ◎ Let definition be the result of looking up a custom element definition given context object’s node document, its namespace, its local name, and its is value.
   2. ~IF［ %定義 ~NEQ ~NULL ］~AND［ %定義 の`~shadowを不能化する$cD ~EQ ~T ］ ⇒ ~THROW `NotSupportedError$E ◎ If definition is not null and definition’s disable shadow is true, then throw a "NotSupportedError" DOMException.
4. ~IF［ 此れは`~shadow~host$である ］ ⇒ ~THROW `NotSupportedError$E ◎ If context object is a shadow host, then throw an "NotSupportedError" DOMException.
5. %~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.
6. %~shadow の`~focusを委譲する$sR ~SET %init の $ShadowRootInit.delegatesFocus ◎ Set shadow’s delegates focus to init’s delegatesFocus.
7. 此れの`~shadow根$elm ~SET %~shadow ◎ Set context object’s shadow root to shadow.
8. ~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.

@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を実装する`~node$を総称して， `文字~data~node@ という（すなわち， $Text （ $CDATASection も含む）, $ProcessingInstruction, $Comment ）。

【 この用語は、簡潔に記述するために，この訳に導入した非公式な用語である。 （機能上は異なるものだが）多くの処理で，これらは同等に扱われるので。 】

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

【 この訳では、次の手続きを導入して，原文による “連続的な…” の（再帰的な）定義を、等価な（かつ平坦~化された平易な）定義に変形している。 】

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

@splitText(offset)

被呼出時には、次を走らすモノトスル ⇒ ~RET `~Text~nodeを分割する$( 此れ, %offset ) ◎ The splitText(offset) method, when invoked, must split context object with offset offset.

@wholeText

取得子は、次を`連結-$した結果を返すモノトスル ⇒ `~tree順序$による，此れを含む`連続的な~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~tree$の中の連続する内容を表現する。 各 `範囲o$ は、`境界点$と呼ばれる［ ( `始端$, `終端$ ) が成す`~tuple$ ］を持つ。 各 `境界点$は、 ( `~node$bp, `~offset$bp ) が成す`~tuple$である。 言い換えれば、`範囲o$は`~node~tree$の中の 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~tree$が与えられたとき： ◎ 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~tree$の ^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~tree$に対する変異に影響される。 なので、`~live範囲o$とも称される。 その種の変異によりそれらが無効~化されることはなく，可能なら内容の同じ部分を表現するようにされる。 `~live範囲o$は、`~node~tree$に対する変異 — 自身が表現する`中身$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を除去する$ $Node.normalize(), `~dataを置換する$, `~Text~nodeを分割する$ ◎ See the insert and remove algorithms, the normalize() method, and the replace data and split algorithms for details.

【 例えば，範囲oの境界点が ある~nodeの “内部” を指していて, その~nodeが~treeから除去された場合、その境界点は “~nodeが抜けた穴” を指すようにされる（始端と終端が別々の~treeの中を指さないようにされる）。 始端と終端の両者が同じ~nodeの内部を指していたとしても、除去された~nodeの内部を指すことはなく，それらは同じ “穴” を指す様に畳まれることになる。 】

`~node~tree$の変異に呼応して，`~live範囲o$を更新することは、高価になり得る。 `~node~tree$が変化するたびに、影響されるすべての $Range ~objは更新される必要がある。 ~appが`~live範囲o$に関心がなくなろうが、変異が生じたときには，それらを最新に保つ~costを支払うことになる。 ◎ Updating live ranges in response to node tree mutations can be expensive. For every node tree change, all affected Range objects need to be updated. Even if the application is uninterested in some live ranges, it still has to pay the cost of keeping them up-to-date when a mutation occurs.

$StaticRange ~objは、`~node~tree$が変異しても更新されない，軽量な`範囲o$であり、したがって， `~live範囲o$と同じ保守~costの~subjectにならない。 ◎ A StaticRange object is a lightweight range that does not update when the node tree mutates. It is therefore not subject to the same maintenance cost as live ranges.

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.

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$は、次を満たすとき `畳まれて@ いるとされる 【！等bp】 ⇒ ［ `始端~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

%staticRange = new $StaticRange(init)

`~node~tree$が変異しても更新しない，新たな`範囲o$を返す。 ◎ Returns a new range object that does not update when the node tree mutates.

@StaticRange(init)

この構築子の被呼出時には、次を走らすモノトスル： ◎ The StaticRange(init) constructor, when invoked, must run these steps:

1. ~IF［ %init の［ $startContainer, $endContainer ］いずれかは［ $DocumentType ／ $Attr ］`~node$である ］ ⇒ ~THROW `InvalidNodeTypeError$E ◎ If init’s startContainer or endContainer is a DocumentType or Attr node, then throw an "InvalidNodeTypeError" DOMException.
2. ~RET 次のように設定された 新たな $StaticRange ~obj ⇒＃ `始端$ ~SET `境界点$( %init の $startContainer, %init の $startOffset ), `終端$ ~SET `境界点$( %init の $endContainer, %init の $endOffset ) ◎ Let staticRange be a new StaticRange object. ◎ Set staticRange’s start to (init’s startContainer, init’s startOffset) and end to (init’s endContainer, init’s endOffset). ◎ Return staticRange.

5.5. ^@Range ~ifc

$Range ~ifcを実装する~objは単に `~live範囲o@ とも称される。 ◎ Objects implementing the Range interface are known as live ranges.

注記： `~tree$を改変する~algo（特に， `~nodeを子の前に挿入する$, `~nodeを除去する$, `~dataを置換する$, `~Text~nodeを分割する$ ）は、その`~tree$に結付けられている一連の`~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~tree$に結付けられ続ける — 言い換えれば、`根$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 次のように設定された 新たな`~live範囲o$ ⇒＃ `始端$ ~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 と異なる~treeの中に在る, または［ %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^mk ）／終端（下図の `E^mk ） ］に位置させる。

%node の`親$が~NULL の場合， `InvalidNodeTypeError$E 例外が投出される。

%range . $setEndBefore(node)

%range . $setEndAfter(node)

それぞれ，終端を %node の外縁の［ 始端（下図の `S^mk ）／終端（下図の `E^mk ） ］に位置させる。

%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^mk, `E^mk ）に位置させる。

%node の`親$が~NULL の場合， `InvalidNodeTypeError$E 例外が投出される。

%range . $selectNodeContents(node)

%node の内容を選択する — すなわち、始端と終端を %node の内縁の両端（上図の `s^mk, `e^mk ）に位置させる。

%node が`~doctype$である場合， `InvalidNodeTypeError$E 例外が投出される。

%range . $compareBoundaryPoints(how, sourceRange)

%range の始端または終端（ %how により指示される）の位置bpが， %sourceRange の始端または終端（ %how により指示される）［ `より前$i, `に等しい$i, `より後$i ］のいずれになるかに応じて、［ −1, 0, 1 ］を返す。

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

@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^mk, `e^mk ］が順に範囲の［ 始端, 終端 ］を表すとするとき、図左の~~状態から図右の~~状態になる。 包含されている~node（図の ~COLOR_X ）, および 始端／終端~nodeの文字~dataのうち 範囲oに入る部分の文字（図の `+^c ）が除去される。 部分的に包含されている~node（図の ~COLOR_Y ）は除去されない。 この例では、始端 `s^mk が指す`文字~data~node$は，~dataは空になるが~node自体は残される。 図右の `S^mk, `E^mk が元の始端, 終端に対応する位置であるが、実行後の始端と終端は，図右の `X^mk （共通の広義先祖の直下）を指すようにされることに注意（範囲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^mk, `e^mk ］が順に範囲の［ 始端, 終端 ］を表すとするとき、その間に挟まれた部分の~cloneが図右に示すように得られる（ `S^mk, `E^mk が元の始端と終端に対応する位置）。 図の~COLOR_Yの 2 個の~nodeが，範囲に`部分的に包含され$ている子。 入れ物にあたる それらの`共通の広義先祖$は、~cloneにおいては`文書片$（~COLOR_X）に置換される。 始端 `s^mk が属する`文字~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^mk は始端, `e^mk は終端を表すとき、それらに挟まれた区間が %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$のうち，`親$も此れに`包含され$ているものは除いたもの ］からなる，`~tree順序$の~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 ) に対し，`~tree順序$で ⇒ `~nodeを除去する$( %node ) ◎ For each node in nodes to remove, in tree order, remove node.
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).

@extractContents()

被呼出時には、此れの`中身を抽出-$rgした結果を返すモノトスル。 ◎ The extractContents() method, when invoked, must return the result of extracting the context object.

@cloneContents()

被呼出時には、此れの`中身を~clone$rgした結果を返すモノトスル。 ◎ The cloneContents() method, when invoked, must return the result of cloning the contents of the context object.

@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^mk, `e^mk が %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 【！すなわち node は根】 ］ ⇒ ~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 【！selectNode の結果】 ］ ⇒ ~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 に次を`連結-$した結果を付加する ⇒ `~tree順序$による，此れに`包含され$ているすべての $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.

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

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

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

@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 ］ ⇒＃ %node ~SET %同胞； ~BREAK ◎ If sibling is non-null, then set node to sibling and break.
      4. %temporary ~SET %temporary の`親$ ◎ Set temporary to temporary’s parent.

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.

%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. ^@XPathResult ~ifc

8.2. ^@XPathExpression ~ifc

8.3. ^XPathEvaluatorBase ~mixin

8.4. ^@XPathEvaluator ~ifc

注記： 歴史的な理由から、 $XPathEvaluator を構築することも， $Document 上で同じ~methに~accessすることもできる。 ◎ For historical reasons you can both construct XPathEvaluator and access the same methods on Document.

9.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() を呼出した時に ~F にされる。 ◎ 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.

9.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()

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

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