HTML — やりとり可能な要素

~UAは、［ 要素 %要素 に対し，追加的な情報を［ 示す／隠す ］よう要請する ］ことを利用者に許容するベキである。 そのような要請を尊守するときは、 ~UAは，次を走らすモノトスル：

• 示す場合 ⇒ %要素 の`属性~値を設定する$( `open^l, 空~文字列 )
• 隠す場合 ⇒ %要素 から ``open$a `属性を除去する$

◎ The user agent should allow the user to request that the additional information be shown or hidden. To honor a request for the details to be shown, the user agent must set the open attribute on the element to the empty string. To honor a request for the information to be hidden, the user agent must remove the open attribute from the element.

`details$e 要素 %要素 用に利用される`属性~変更-時の手続き$は、 所与の ( %局所~名, %旧-値, %値, %名前空間 ) に対し： ◎ The following attribute change steps, given element, localName, oldValue, value, and namespace, are used for all details elements:

1. ~IF［ %名前空間 ~NEQ ~NULL ］ ⇒ ~RET ◎ If namespace is not null, then return.
2. ~IF［ %局所~名 ~EQ "``name$a" ］ ⇒ `必要なら要素を閉じることにより~detailsの排他性を確保する$( %要素, `自身^i ) ◎ If localName is name, then ensure details exclusivity by closing the given element if needed given element.

3. ~IF［ %局所~名 ~EQ "``open$a" ］： ◎ If localName is open, then:

   1. ~IF［ %旧-値 ~NEQ %値 ］~AND［ ~NULL ~IN { %旧-値, %値 } ］： ◎ If one of oldValue or value is null and the other is not null, run the following steps,＼

      この段を成す手続きは、 %要素 用の `~details通知~task手続き@ と称される。 ◎ which are known as the details notification task steps, for this details element:

      注記： ``open$a 属性が何回か続けて~toggleされたときは、 結果の~taskは，本質的に~eventが 1 回だけ発火されるよう合体される。 ◎ When the open attribute is toggled several times in succession, the resulting tasks essentially get coalesced so that only one event is fired.

      1. ~IF［ %旧-値 ~EQ ~NULL ］ ⇒ `~details用の~toggle~event~taskを~queueする$( %要素, `closed^l, `open^l ) ◎ If oldValue is null, queue a details toggle event task given the details element, "closed", and "open".
      2. ~ELSE ⇒ `~details用の~toggle~event~taskを~queueする$( %要素, `open^l, `closed^l ) ◎ Otherwise, queue a details toggle event task given the details element, "open", and "closed".
   2. ~IF［ %旧-値 ~EQ ~NULL ］~AND［ %値 ~NEQ ~NULL ］ ⇒ `必要なら要素を閉じることにより~detailsの排他性を確保する$( %要素, `他の要素^i ) ◎ If oldValue is null and value is not null, then ensure details exclusivity by closing other elements if needed given element.

`details$e 用の`~HTML要素~挿入-時の手続き$は、 所与の ( %挿入される~node ) に対し： ◎ The details HTML element insertion steps, given insertedNode, are:

1. `必要なら要素を閉じることにより~detailsの排他性を確保する$( %挿入される~node, `自身^i ) ◎ Ensure details exclusivity by closing the given element if needed given insertedNode.

`~details用の~toggle~event~taskを~queueする@ ~algoは、 所与の ( `details$e 要素 %要素, 文字列 %旧-状態, 文字列 %新-状態 ) に対し： ◎ To queue a details toggle event task given a details element element, a string oldState, and a string newState:

1. %追跡子 ~LET %要素 の`~details用の~toggle~task追跡子$ ◎ ↓

2. ~IF［ %追跡子 ~NEQ ~NULL ］： ◎ If element's details toggle task tracker is not null, then:

   1. %旧-状態 ~SET %追跡子 の`旧-状態$tTk ◎ Set oldState to element's details toggle task tracker's old state.
   2. %追跡子 の`~task$tTkを それが属する`~task~queue$から除去する ◎ Remove element's details toggle task tracker's task from its task queue.
   3. %要素 の`~details用の~toggle~task追跡子$ ~SET ~NULL ◎ Set element's details toggle task tracker to null.

3. %~task ~LET `要素~taskを~queueする$( `~DOM操作~task~source$, %要素, 次の手続き ） ◎ Queue an element task given the DOM manipulation task source and element to run＼

   手続きは： ◎ the following steps:

   1. `~eventを発火する$( %要素, `toggle$et, `ToggleEvent$I ) — 次のように初期化して ⇒＃ `oldState$m 属性 ~SET %旧-状態, `newState$m 属性 ~SET %新-状態 ◎ Fire an event named toggle at element, using ToggleEvent, with the oldState attribute initialized to oldState and the newState attribute initialized to newState.
   2. %要素 の`~details用の~toggle~task追跡子$ ~SET ~NULL ◎ Set element's details toggle task tracker to null.
4. %要素 の`~details用の~toggle~task追跡子$ ~SET 次を伴う構造体 ⇒＃ `~task$tTk ~SET %~task, `旧-状態$tTk ~SET %旧-状態 ◎ Set element's details toggle task tracker to a struct with task set to the just-queued task and old state set to oldState.

`必要なら要素を閉じることにより~detailsの排他性を確保する@ ~algoは、 所与の ( `details$e 要素 %要素, %対象 ~IN { `自身＠#ensure-details-exclusivity-by-closing-the-given-element-if-needed@i, `他の要素＠#ensure-details-exclusivity-by-closing-other-elements-if-needed@i } ) に対し：

【 この~algoは、 原文では 2 つの~algoにより定義されているが， この訳では %対象 ~flagを通して 1 つに集約する。 】

1. ~IF［ %対象 ~EQ `自身^i ］ ⇒ ~Assert： %要素 は ``open$a 属性を有する
2. ~ELIF［ %要素 は ``open$a 属性を有さない ］ ⇒ ~RET
3. ~IF［ %要素 は ``name$a 属性を有さない ］~OR［ %要素 は ``name$a 属性を有していて，その値 ~EQ 空~文字列 ］ ⇒ ~RET
4. %閉じる必要がある要素 ~LET ε

5. %要素 が属する`有名~details~group$を成す ~EACH( %他の要素 ) に対し，`~tree順序$で：

   1. ~IF［ %他の要素 ~EQ %要素 ］ ⇒ ~CONTINUE
   2. ~IF［ %他の要素 は ``open$a 属性を有さない ］ ⇒ ~CONTINUE

   3. ~Assert： %要素 が属する`有名~details~group$を成す~memberのうち %要素, %他の要素 以外のものは ``open$a 属性を有さない。

      【 この表明は、 原文では %対象 ~EQ `他の要素^i の場合に限り与えられているが， %対象 を問わず満たされるはずである。 】

   4. %閉じる必要がある要素 ~LET %対象 に応じて ⇒＃ `他の要素^i ならば %他の要素 ／ `自身^i ならば %要素 ／
   5. ~BREAK
6. ~IF［ %閉じる必要がある要素 ~NEQ ε ］ ⇒ %閉じる必要がある要素 から ``open$a `属性を除去する$

◎ To ensure details exclusivity by closing other elements if needed given a details element element: • Assert: element has an open attribute. • If element does not have a name attribute, or its name attribute is the empty string, then return. • Let groupMembers be a list of elements, containing all elements in element's details name group except for element, in tree order. • For each element otherElement of groupMembers: •• If the open attribute is set on otherElement, then: ••• Assert: otherElement is the only element in groupMembers that has the open attribute set. ••• Remove the open attribute on otherElement. ••• Break. ◎ To ensure details exclusivity by closing the given element if needed given a details element element: • If element does not have an open attribute, then return. • If element does not have a name attribute, or its name attribute is the empty string, then return. • Let groupMembers be a list of elements, containing all elements in element's details name group except for element, in tree order. • For each element otherElement of groupMembers: •• If the open attribute is set on otherElement, then: ••• Remove the open attribute on element. ••• Break.

`先祖~detailsを露呈する@ ~algoは、 所与の ( %現在の~node ) に対し： ◎ The ancestor details revealing algorithm is to run the following steps on currentNode:

1. ~WHILE ［ %現在の~node は`平坦~tree$の中で親~nodeを有する ］: ◎ While currentNode has a parent node within the flat tree:

   1. ~IF［ ある `details$e 要素 %要素 が在って， %現在の~node は %要素 の `2 個目の~slot＠~HTMLrendering#_details-slots$の中に~slotされている ］： ◎ If currentNode is slotted into the second slot of a details element:

      1. %現在の~node ~SET %要素 ◎ Set currentNode to the details element which currentNode is slotted into.
      2. ~IF［ %要素 は ``open$a 属性を有していない ］ ⇒ %要素 の`属性~値を設定する$( `open^l, 空~文字列 ) ◎ If the open attribute is not set on currentNode, then set the open attribute on currentNode to the empty string.
   2. ~ELSE ⇒ %現在の~node ~SET `平坦~tree$の中の %現在の~node の親~node ◎ Otherwise, set currentNode to the parent node of currentNode within the flat tree.

document.getElementById("d2").setAttribute("open", "");

次を満たす要素は `親~details用の~summary@ であるとされる ⇒ ［ `summary$e 要素である ］~AND［ 親は `details$e 要素である ］~AND［ 先行する同胞に別の `summary$e 要素は無い ］ ◎ A summary element is a summary for its parent details if the following algorithm returns true: • If this summary element has no parent, then return false. • Let parent be this summary element's parent. • If parent is not a details element, then return false. • If parent's first summary element child is not this summary element, then return false. • Return true.

`summary$e 要素 %要素 の`作動化の挙動$は： ◎ The activation behavior of summary elements is to run the following steps:

1. ~IF［ %要素 は`親~details用の~summary$でない ］ ⇒ ~RET ◎ If this summary element is not the summary for its parent details, then return.
2. %親 ~LET %要素 の親 ◎ Let parent be this summary element's parent.
3. ~IF［ %親 は ``open$a 属性を有する ］ ⇒ %親 から ``open$a `属性を除去する$† ◎ If the open attribute is present on parent, then remove it.＼
4. ~ELSE ⇒ %親 の`属性~値を設定する$( `open^l, 空~文字列 )† ◎ Otherwise, set parent's open attribute to the empty string.

注記†： これは、 `~details通知~task手続き$を走らすことになる。 ◎ This will then run the details notification task steps.

``show()@m ~method手続きは： ◎ The show() method steps are:

1. ~IF［ コレは ``open$a 属性を有する ］：

   1. ~IF［ コレの`~modalか$dG ~EQ ~F ］ ⇒ ~RET
   2. ~THROW `InvalidStateError$E
   ◎ If this has an open attribute and is modal of this is false, then return. ◎ If this has an open attribute, then throw an "InvalidStateError" DOMException.
2. %取消されなかったか ~LET `~eventを発火する$( コレ, `beforetoggle$et, `ToggleEvent$I ) — 次のように初期化して ⇒＃ `cancelable$m 属性 ~SET ~T, `oldState$m 属性 ~SET `closed^l, `newState$m 属性 ~SET `open^l ◎ If the result of firing an event named beforetoggle, using ToggleEvent, with the cancelable attribute initialized to true, the oldState attribute initialized to "closed", and the newState attribute initialized to "open" at this＼

3. ~IF［ ~OR↓ ］…

   • %取消されなかったか ~EQ ~F
   • コレは ``open$a 属性を有する

   …ならば ⇒ ~RET

   ◎ is false, then return. ◎ If this has an open attribute, then return.
4. `~dialog用の~toggle~event~taskを~queueする$( コレ, `closed^l, `open^l ) ◎ Queue a dialog toggle event task given this, "closed", and "open".
5. コレの`属性~値を設定する$( `open^l, 空~文字列 ) 【！コレに［値に空~文字列を伴う ``open$a 属性］を追加する】 ◎ Add an open attribute to this, whose value is the empty string.
6. %文書 ~LET コレの`~node文書$ ◎ ↓
7. ~Assert： コレ ~NIN %文書 の`開な~dialog~list$doc ◎ Assert: this's node document's open dialogs list does not contain this.
8. %文書 の`開な~dialog~list$docにコレを`付加する$【！add】 ◎ Add this to this's node document's open dialogs list.
9. `~dialog用の閉-注視器を設定する$( コレ ) ◎ Set the dialog close watcher with this.
10. コレの`前回に~focusされた要素$ ~SET `~focusされて$いる要素 ◎ Set this's previously focused element to the focused element.

11. « `hint^l, `auto^l » を成す ~EACH( %~mode ) に対し：

    1. %~popover~list ~LET `文書が示している~popover~listを取得する$( %文書, %~mode )
    2. %ある所 ~SET `最上層な~popover先祖を見出す$( コレ, %~popover~list, ~NULL, ~F )
    3. ~IF［ %ある所 ~NEQ ~NULL ］ ⇒ ~BREAK
    ◎ ↑ Let document be this's node document. ◎ Let hideUntil be the result of running topmost popover ancestor given this, document's showing hint popover list, null, and false. ◎ If hideUntil is null, then set hideUntil to the result of running topmost popover ancestor given this, document's showing auto popover list, null, and false.
12. ~IF［ %ある所 ~EQ ~NULL ］ ⇒ %ある所 ~SET %文書 ◎ If hideUntil is null, then set hideUntil to document.
13. `ある所までの~popoverをすべて隠す$( %ある所, ~F, ~T ) ◎ Run hide all popovers until given hideUntil, false, and true.
14. `~dialogを~focusする$( コレ ) ◎ Run the dialog focusing steps given this.

``showModal()@m ~method手続きは ⇒ `~modal~dialogを示す$( コレ ) ◎ The showModal() method steps are to show a modal dialog given this.

``close(returnValue)@m ~method手続きは ⇒ `~dialogを閉じる$( コレ, %returnValue ) ◎ The close(returnValue) method steps are: • If returnValue is not given, then set it to null. • Close the dialog this with returnValue.

``requestClose(returnValue)@m ~method手続きは： ◎ The requestClose(returnValue) method steps are:

1. ~IF［ コレは ``open$a 属性を有していない ］ ⇒ ~RET ◎ If this does not have an open attribute, then return.
2. ~Assert： コレの`閉-注視器$dG ~NEQ ~NULL ◎ Assert: this's close watcher is not null.
3. コレ【！dialog】の`閉-要請~method用の閉-注視器を可能化するか$dG ~SET ~T ◎ Set dialog's enable close watcher for requestClose() to true.
4. ~IF［ %returnValue ~EQ ε ］ ⇒ %returnValue ~SET ~NULL ◎ If returnValue is not given, then set it to null.
5. コレの`閉-要請の返り値$dG ~SET %returnValue ◎ Set this's request close return value to returnValue.
6. `閉-注視器に閉じるよう要請する$( %dialog の`閉-注視器$dG, ~F ) ◎ Request to close dialog's close watcher with false.
7. %dialog の`閉-要請~method用の閉-注視器を可能化するか$dG ~SET ~F ◎ Set dialog's enable close watcher for requestClose() to false.

`dialog$e 要素~用の`~HTML要素~除去-時の手続き$は、 所与の ( %除去される~node, %旧-親 ) に対し： ◎ The dialog HTML element removing steps, given removedNode and oldParent, are:

1. ~IF［ %除去される~node の`閉-注視器$dG ~NEQ ~NULL ］： ◎ If removedNode's close watcher is not null, then:

   1. `閉-注視器を破壊する$( %除去される~node の`閉-注視器$dG ) ◎ Destroy removedNode's close watcher.
   2. %除去される~node の`閉-注視器$dG ~SET ~NULL ◎ Set removedNode's close watcher to null.
2. ~IF［ %除去される~node ~IN %除去される~node の`~node文書$の`上端~層$ ］ ⇒ `上端~層から要素を即時に除去する$( %除去される~node ) ◎ If removedNode's node document's top layer contains removedNode, then remove an element from the top layer immediately given removedNode.
3. %除去される~node の`~modalか$dG ~SET ~F ◎ Set is modal of removedNode to false.
4. %除去される~node の`~node文書$の`開な~dialog~list$docから %除去される~node を`除去する$ ◎ Remove removedNode from removedNode's node document's open dialogs list.

`~modal~dialogを示す@ ~algoは、 所与の ( `dialog$e 要素 %dialog ) に対し： ◎ To show a modal dialog given a dialog element subject:

1. ~IF［ %dialog は ``open$a 属性を有する ］~AND［ %dialog の`~modalか$dG ~EQ ~T ］ ⇒ ~RET ◎ If subject has an open attribute and is modal of subject is true, then return.

2. ~IF［ ~OR↓ ］…

   • %dialog は ``open$a 属性を有する
   • %dialog の`~node文書$は`全部的に作動中$でない
   • %dialog は`接続されて$いない
   • %dialog の`~popover可視性~状態$ ~EQ `示している$i

   …ならば ⇒ ~THROW `InvalidStateError$E

   ◎ If subject has an open attribute, then throw an "InvalidStateError" DOMException. ◎ If subject's node document is not fully active, then throw an "InvalidStateError" DOMException. ◎ If subject is not connected, then throw an "InvalidStateError" DOMException. ◎ If subject is in the popover showing state, then throw an "InvalidStateError" DOMException.
3. %取消されなかったか ~LET `~eventを発火する$( %dialog, `beforetoggle$et, `ToggleEvent$I ) — 次のように初期化して ⇒＃ `cancelable$m 属性 ~SET ~T, `oldState$m 属性 ~SET `closed^l, `newState$m 属性 ~SET `open^l ◎ If the result of firing an event named beforetoggle, using ToggleEvent, with the cancelable attribute initialized to true, the oldState attribute initialized to "closed", and the newState attribute initialized to "open" at subject＼

4. ~IF［ ~OR↓ ］…

   • %取消されなかったか ~EQ ~F
   • %dialog は ``open$a 属性を有する
   • %dialog は`接続されて$いない
   • %dialog の`~popover可視性~状態$ ~EQ `示している$i

   …ならば ⇒ ~RET

   ◎ is false, then return. ◎ If subject has an open attribute, then return. ◎ If subject is not connected, then return. ◎ If subject is in the popover showing state, then return.
5. `~dialog用の~toggle~event~taskを~queueする$( %dialog, `closed^l, `open^l ) ◎ Queue a dialog toggle event task given subject, "closed", and "open".
6. %dialog の`属性~値を設定する$( `open^l, 空~文字列 ) 【！%dialog に値に空~文字列を伴う ``open$a 属性を追加する】 ◎ Add an open attribute to subject, whose value is the empty string.
7. %dialog の`~modalか$dG ~SET ~T ◎ Set is modal of subject to true.
8. %文書 ~LET %dialog の`~node文書$ ◎ ↓
9. ~Assert： %dialog ~NIN %文書 の`開な~dialog~list$doc ◎ Assert: subject's node document's open dialogs list does not contain subject.
10. %文書 の`開な~dialog~list$docに %dialog を`付加する$【！add】 ◎ Add subject to subject's node document's open dialogs list.

11. %dialog を %文書 を`阻んでいる~modal~dialog$にする ◎ Let subject's node document be blocked by the modal dialog subject.

    注記： これは、 %文書 が`指名する被focus区画$docを`不活$にする （現在の被focus区画が %dialog の`~shadowも含めた子孫$でない限り）。 そのような事例では、 %文書 が`指名する被focus区画$docは， すぐに`表示域$に`設定し直される＠~WAPI#focus-fixup-rule$ことになる — が、 数~段~先にて，~focus先として もっと良い候補を見出そうと試みることになる。 ◎ This will cause the focused area of the document to become inert (unless that currently focused area is a shadow-including descendant of subject). In such cases, the focused area of the document will soon be reset to the viewport. In a couple steps we will attempt to find a better candidate to focus.

12. ~IF［ %dialog ~NIN %文書 の`上端~層$ ］ ⇒ `上端~層に要素を追加する$( %dialog ) ◎ If subject's node document's top layer does not already contain subject, then add an element to the top layer given subject.
13. `~dialog用の閉-注視器を設定する$( %dialog ) ◎ Set the dialog close watcher with subject.
14. %dialog の`前回に~focusされた要素$ ~SET `~focusされて$いる要素 ◎ Set subject's previously focused element to the focused element.

15. « `hint^l, `auto^l » を成す ~EACH( %~mode ) に対し：

    1. %~popover~list ~LET `文書が示している~popover~listを取得する$( %文書, %~mode )
    2. %ある所 ~SET `最上層な~popover先祖を見出す$( %dialog, %~popover~list, ~NULL, ~F )
    3. ~IF［ %ある所 ~NEQ ~NULL ］ ⇒ ~BREAK
    ◎ ↑ Let document be subject's node document. ◎ Let hideUntil be the result of running topmost popover ancestor given subject, document's showing hint popover list, null, and false. ◎ If hideUntil is null, then set hideUntil to the result of running topmost popover ancestor given subject, document's showing auto popover list, null, and false.
16. ~IF［ %ある所 ~EQ ~NULL ］ ⇒ %ある所 ~SET %文書 ◎ If hideUntil is null, then set hideUntil to document.
17. `ある所までの~popoverをすべて隠す$( %ある所, ~F, ~T ) ◎ Run hide all popovers until given hideUntil, false, and true.
18. `~dialogを~focusする$( %dialog ) ◎ Run the dialog focusing steps given subject.

`~dialog用の閉-注視器を設定する@ ~algoは、 所与の ( `dialog$e 要素 %dialog ) に対し： ◎ To set the dialog close watcher, given a dialog element dialog:

1. %dialog の`閉-注視器$dG ~SET `閉-注視器を確立する$( %dialog に`関連な大域~obj$ ) — 次も与える下で： ◎ Set dialog's close watcher to the result of establishing a close watcher given dialog's relevant global object, with:

   • `取消-動作^i は、 所与の ( %閉-を防止し得るか ) に対し ⇒ `~eventを発火する$( %dialog, `cancel$et ) — 次のように初期化して ⇒＃ `cancelable$m 属性 ~SET %閉-を防止し得るか ◎ cancelAction given canPreventClose being to return the result of firing an event named cancel at dialog, with the cancelable attribute initialized to canPreventClose.
   • `閉-動作^i は ⇒ `~dialogを閉じる$( %dialog, %dialog の`閉-要請の返り値$dG ) ◎ closeAction being to close the dialog given dialog and dialog's request close return value.
   • `可能化~状態を取得する^i は ⇒ ~RET ~IS［ %dialog の`閉-要請~method用の閉-注視器を可能化するか$dG ~EQ ~T ］~OR［ `~dialogの~closed-by状態を算出する$( %dialog ) ~NEQ `なし$st ］ ◎ getEnabledState being to return true if dialog's enable close watcher for requestClose() is true or dialog's computed closed-by state is not None; otherwise false.

`dialog$e 要素~用の `呼出元~commandは妥当か？手続き$ は、 所与の ( `command$a 属性 %~command ) に対し ⇒ ~RET ~IS［ %~command の状態 ~IN { `閉じる$st, `~modalを示す$st } ］ ◎ The is valid invoker command steps for dialog elements, given a command attribute command, are: • If command is in the Close state or in the Show Modal state, then return true. • Return false.

`dialog$e 要素~用の`呼出元~command手続き$は、 所与の ( 要素 %dialog, 要素 %呼出元, `command$a 属性 %~command ) に対し： ◎ The invoker command steps for dialog elements, given an element element, an element invoker, and a command attribute command, are:

1. ~IF［ %dialog の`~popover可視性~状態$ ~EQ `示している$i ］ ⇒ ~RET ◎ If element is in the popover showing state, then return.
2. ~IF［ %~command の状態 ~EQ `閉じる$st ］~AND［ %dialog は ``open$a 属性を有する ］ ⇒ `~dialogを閉じる$( %dialog, %呼出元 の`値$fe ) ◎ If command is in the Close state and element has an open attribute: • Let value be invoker's value. • Close the dialog element with value.
3. ~IF［ %~command の状態 ~EQ `~modalを示す$st ］~AND［ %dialog は ``open$a 属性を有さない ］ ⇒ `~modal~dialogを示す$( %dialog ) ◎ If command is the Show Modal state and element does not have an open attribute, then show a modal dialog given element.

`~dialogを閉じる@ ~algoは、 所与の ( `dialog$e 要素 %dialog, ［ ~NULL ／文字列 ］ %結果 ) に対し： ◎ When a dialog element subject is to be closed, with null or a string result, run these steps:

1. ~IF［ %dialog は ``open$a 属性を有さない ］ ⇒ ~RET ◎ If subject does not have an open attribute, then return.
2. `~eventを発火する$( %dialog, `beforetoggle$et, `ToggleEvent$I ) — 次のように初期化して ⇒＃ `oldState$m 属性 ~SET `open^l, `newState$m 属性 ~SET `closed^l ◎ Fire an event named beforetoggle, using ToggleEvent, with the oldState attribute initialized to "open" and the newState attribute initialized to "closed" at subject.
3. ~IF［ %dialog は ``open$a 属性を有さない ］ ⇒ ~RET ◎ If subject does not have an open attribute, then return.
4. `~dialog用の~toggle~event~taskを~queueする$( コレ【！subject】, `open^l, `closed^l ) ◎ Queue a dialog toggle event task given subject, "open", and "closed".
5. %dialog から ``open$a `属性を除去する$ ◎ Remove subject's open attribute.
6. ~IF［ %dialog の`~modalか$dG ~EQ ~T ］ ⇒ `上端~層から要素を除去するよう要請する$( %dialog ) ◎ If is modal of subject is true, then request an element to be removed from the top layer given subject.
7. %~modalであったか ~LET %dialog の`~modalか$dG ◎ Let wasModal be the value of subject's is modal flag.
8. %dialog の`~modalか$dG ~SET ~F ◎ Set is modal of subject to false.
9. %dialog の`~node文書$ の`開な~dialog~list$docから %dialog を`除去する$ ◎ Remove subject from subject's node document's open dialogs list.
10. ~IF［ %結果 ~NEQ ~NULL ］ ⇒ %dialog の `結果値$dG ~SET %結果 ◎ If result is not null, then set the returnValue attribute to result.
11. 【 %dialog の】`閉-要請の返り値$dG ~SET ~NULL ◎ Set the request close return value to null.

12. ~IF［ %dialog の`前回に~focusされた要素$ ~NEQ ~NULL ］： ◎ If subject's previously focused element is not null, then:

    1. %要素 ~LET %dialog の`前回に~focusされた要素$ ◎ Let element be subject's previously focused element.
    2. %dialog の`前回に~focusされた要素$ ~SET ~NULL ◎ Set subject's previously focused element to null.

    3. ~IF［ %dialog の`~node文書$が`指名する被focus区画$docの`~DOM~anchor$は， %dialog の`~shadowも含めた広義-子孫$である ］~OR［ %~modalであったか ~EQ ~T ］ ⇒ `~objを~focusする$( %要素 ) ◎ If subject's node document's focused area of the document's DOM anchor is a shadow-including inclusive descendant of subject, or wasModal is true, then run the focusing steps for element;＼

       この段を行うときは、 表示域は~scrollされるベキでない。 ◎ the viewport should not be scrolled by doing this step.

13. `要素~taskを~queueする$( `利用者ヤリトリ~task~source$, %dialog, 次の手続き )

    手続きは ⇒ `~eventを発火する$( %dialog, `close$et )
    ◎ Queue an element task on the user interaction task source given the subject element to fire an event named close at subject.

14. ~IF［ %dialog の`閉-注視器$dG ~NEQ ~NULL ］： ◎ If subject's close watcher is not null, then:

    1. `閉-注視器を破壊する$( %dialog の`閉-注視器$dG ) ◎ Destroy subject's close watcher.
    2. %dialog の`閉-注視器$dG ~SET ~NULL ◎ Set subject's close watcher to null.

`~dialog用の~toggle~event~taskを~queueする@ ~algoは、 所与の ( `dialog$e 要素 %dialog, 文字列 %旧-状態, 文字列 %新-状態 ) に対し： ◎ To queue a dialog toggle event task given a dialog element element, a string oldState, and a string newState:

1. ~IF［ %dialog の`~toggle~task追跡子$dG ~NEQ ~NULL ］： ◎ If element's dialog toggle task tracker is not null, then:

   1. %旧-状態 ~SET %dialog の`~toggle~task追跡子$dGの`旧-状態$tTk ◎ Set oldState to element's dialog toggle task tracker's old state.
   2. %dialog の`~toggle~task追跡子$dGの`~task$tTkを それが属する`~task~queue$から除去する ◎ Remove element's dialog toggle task tracker's task from its task queue.
   3. %dialog の`~toggle~task追跡子$dG ~SET ~NULL ◎ Set element's dialog toggle task tracker to null.

2. %~task ~LET `要素~taskを~queueする$( `~DOM操作~task~source$, %dialog, 次の手続き ) ◎ Queue an element task given the DOM manipulation task source and element to＼

   手続きは： ◎ run the following steps:

   1. `~eventを発火する$( %dialog, `toggle$et, `ToggleEvent$I ) — 次のように初期化して ⇒＃ `oldState$m 属性 ~SET %旧-状態, `newState$m 属性 ~SET %新-状態 ◎ Fire an event named toggle at element, using ToggleEvent, with the oldState attribute initialized to oldState and the newState attribute initialized to newState.
   2. %dialog の`~toggle~task追跡子$dG ~SET ~NULL ◎ Set element's dialog toggle task tracker to null.
3. %dialog の`~toggle~task追跡子$dG ~SET 次を伴う構造体 ⇒＃ `~task$tTk ~SET %~task, `旧-状態$tTk ~SET %旧-状態 ◎ Set element's dialog toggle task tracker to a struct with task set to the just-queued task and old state set to oldState.

`~dialogの~closed-by状態を算出する@ ~algoは、 所与の ( `dialog$e %dialog ) に対し： ◎ To retrieve a dialog's computed closed-by state, given a dialog dialog:

1. %状態 ~LET %dialog の ``closedby$a 属性の状態 ◎ ↓

2. ~IF［ %状態 ~EQ `自動$st ］： ◎ If the state of dialog's closedby attribute is Auto:

   1. ~IF［ %dialog の`~modalか$dG ~EQ ~T ］ ⇒ ~RET `閉-要請$st ◎ If dialog's is modal is true, then return Close Request.
   2. ~RET `なし$st ◎ Return None.
3. ~RET %状態 ◎ Return the state of dialog's closedby attribute.

`~dialogを~focusする@ ~algoは、 所与の ( `dialog$e 要素 %dialog ) に対し： ◎ The dialog focusing steps, given a dialog element subject, are as follows:

1. ~IF［ `~focusを許容する手続き$( %dialog の`~node文書$ ) ~EQ ~F ］ ⇒ ~RET ~F ◎ If the allow focus steps given subject's node document return false, then return.
2. %~control ~LET ~NULL ◎ Let control be null.
3. ~IF［ %dialog は `autofocus$a 属性を有さない ］ ⇒ %~control ~SET `~focus委任-先$( %dialog ) ◎ If subject has the autofocus attribute, then set control to subject. ◎ If control is null, then set control to the focus delegate of subject.
4. ~IF［ %~control ~EQ ~NULL ］ ⇒ %~control ~SET %dialog ◎ If control is null, then set control to subject.

5. `~objを~focusする$( %~control ) ◎ Run the focusing steps for control.

   注記： %~control は`~focus可能$でない場合、 これは何もしない。 そうなるのは、［ %dialog に~focus委任-先は無かった ］かつ［ ~UAは［ `dialog$e 要素は、 一般に，~focus可能でない ］ものと裁定していた ］ときに限られる。 その事例では、 当の文書が`指名する被focus区画$docに`先の改変＠#note-dialog-plus-focus-fixup$を適用することになる。 ◎ If control is not focusable, this will do nothing. This would only happen if subject had no focus delegate, and the user agent decided that dialog elements were not generally focusable. In that case, any earlier modifications to the focused area of the document will apply.

6. %~top文書 ~LET %~control の`~node~navigable$の`~top-level辿可能$navにて`作動中な文書$nav ◎ Let topDocument be control's node navigable's top-level traversable's active document.
7. ~IF［ ( %~control の`~node文書$の`生成元$doc, %~top文書 の`生成元$doc ) は`同一-生成元$でない ］ ⇒ ~RET ◎ If control's node document's origin is not the same as the origin of topDocument, then return.
8. %~top文書 の`自動focus候補~群$を`空にする$ ◎ Empty topDocument's autofocus candidates.
9. %~top文書 の`自動focusは処理-済みか$ ~SET ~T ◎ Set topDocument's autofocus processed flag to true.

`開な~dialogたちを軽く退ける@ ~algoは、 所与の ( `PointerEvent$I %~event ) に対し： ◎ To light dismiss open dialogs, given a PointerEvent event:

1. ~Assert： %~event の `isTrusted$m 属性 ~EQ ~T ◎ Assert: event's isTrusted attribute is true.
2. ~Assert： %~event の`~target$ ~NEQ ~NULL 【この段は、この訳による補完。】
3. %文書 ~LET %~event の`~target$の`~node文書$ ◎ Let document be event's target's node document.
4. ~IF［ %文書 の`開な~dialog~list$docは`空$である ］ ⇒ ~RET ◎ If document's open dialogs list is empty, then return.
5. %先祖 ~LET `最も近い~clickされた~dialogを見出す$( %~event ) ◎ Let ancestor be the result of running nearest clicked dialog given event.
6. ~IF［ %~event の `type$m ~EQ "`pointerdown$et" ］ ⇒ %文書 の`~dialog~pointerdown~target$doc ~SET %先祖 ◎ If event's type is "pointerdown", then set document's dialog pointerdown target to ancestor.

7. ~ELIF［ %~event の `type$m ~EQ "`pointerup$et" ］： ◎ If event's type is "pointerup", then:

   1. %同じ~targetか ~LET ~IS［ %先祖 ~EQ %文書 の`~dialog~pointerdown~target$doc ］ ◎ Let sameTarget be true if ancestor is document's dialog pointerdown target.
   2. %文書 の`~dialog~pointerdown~target$doc ~SET ~NULL ◎ Set document's dialog pointerdown target to null.
   3. ~IF［ %同じ~targetか ~EQ ~F ］ ⇒ ~RET ◎ If sameTarget is false, then return.
   4. %最上層な~dialog ~LET %文書 の`開な~dialog~list$docを成す最後の要素 ◎ Let topmostDialog be the last element of document's open dialogs list.
   5. ~IF［ %先祖 ~EQ %最上層な~dialog ］ ⇒ ~RET ◎ If ancestor is topmostDialog, then return.
   6. ~IF［ `~dialogの~closed-by状態を算出する$( %最上層な~dialog ) ~NEQ `何でも$st ］ ⇒ ~RET ◎ If topmostDialog's computed closed-by state is not Any, then return.
   7. ~Assert： %最上層な~dialog の`閉-注視器$dG ~NEQ ~NULL ◎ Assert: topmostDialog's close watcher is not null.
   8. `閉-注視器に閉じるよう要請する$( %最上層な~dialog の`閉-注視器$dG, ~F ) ◎ Request to close topmostDialog's close watcher with false.

`軽く退けるふるまいを走らす@ ~algoは、 所与の ( `PointerEvent$I %~event ) に対し： ◎ To run light dismiss activities, given a PointerEvent event:

1. `開な~popoverたちを軽く退ける$( %~event ) ◎ Run light dismiss open popovers with event.
2. `開な~dialogたちを軽く退ける$( %~event ) ◎ Run light dismiss open dialogs with event.

`軽く退けるふるまいを走らす$は、 利用者が~page上のどこでも［ ~clickした／~touchした ］ときに， `POINTEREVENTS$r 仕様により`~callされることになる＠https://github.com/w3c/pointerevents/pull/460$。 ◎ Run light dismiss activities will be called by the Pointer Events spec when the user clicks or touches anywhere on the page.

`最も近い~clickされた~dialogを見出す@ ~algoは、 所与の ( `PointerEvent$I %~event ) に対し： ◎ To find the nearest clicked dialog, given a PointerEvent event:

1. %~target ~LET %~event の`~target$ ◎ Let target be event's target.

2. ~IF［ ~AND↓ ］…

   • %~target は `dialog$e 要素である
   • %~target は ``open$a 属性を有している
   • %~target の`~modalか$dG ~EQ ~T

   • %~event の ( `clientX＠~CSSOMVIEW#dom-mouseevent-clientx$m, `clientY＠~CSSOMVIEW#dom-mouseevent-clienty$m ) は、 %~target の限界域の外側にある

     注記： この条件は、［ %~event が当の~dialogの `backdrop$pe 疑似要素で生じたものである場合 ］でも［ %~target は当の `dialog$e 要素になる ］ことから必要になる。

   …ならば ⇒ ~RET ~NULL

   ◎ If target is a dialog element, target has an open attribute, target's is modal is true, and event's clientX and clientY are outside the bounds of target, then return null. ◎ The check for clientX and clientY is because a pointer event that hits the ::backdrop pseudo element of a dialog will result in event having a target of the dialog element itself.
3. %現在の~node ~LET %~target ◎ Let currentNode be target.

4. ~WHILE［ %現在の~node ~NEQ ~NULL ］： ◎ While currentNode is not null:

   1. ~IF［ %現在の~node は `dialog$e 要素である ~AND %現在の~node は ``open$a 属性を有している ］ ⇒ ~RET %現在の~node ◎ If currentNode is a dialog element and currentNode has an open attribute, then return currentNode.
   2. %現在の~node ~SET `平坦~tree$における %現在の~node の親 ◎ Set currentNode to currentNode's parent in the flat tree.
5. ~RET ~NULL ◎ Return null.