スクリーン方位 — Screen Orientation

`lock(orientation)@m ~method手続きは： ◎ ↑

1. %文書 ~LET コレに`関連な大域~obj$に`結付けられた文書$ ◎ Let document be this's relevant global object's associated Document.

2. `共通な安全性~検査$( %文書 )

   例外が投出されたときは，~catchして ⇒ ~RET `却下される~promise$( その例外 )

   ◎ Run the common safety checks with document. If an exception is thrown, return a promise rejected with that exception and abort these steps.
3. ~IF［ `~UA$は~screen方位を %orientation に~lockすることを~supportしない ］ ⇒ ~RET `却下される~promise$( `NotSupportedError$E 例外 ) ◎ If the user agent does not support locking the screen orientation to orientation, return a promise rejected with a "NotSupportedError" DOMException and abort these steps.
4. ~IF［ %文書 .`orientationPendingPromise$sl ~NEQ ~NULL ］ ⇒ `現在の~lock~promiseを却下して~NULL化する$( %文書, "`AbortError$E" ) `lock-basic^test ◎ If document's [[orientationPendingPromise]] is not null, reject and nullify the current lock promise of document with an "AbortError".
5. %文書 .`orientationPendingPromise$sl ~SET `新たな~promise$ `lock-basic^test ◎ Set document's [[orientationPendingPromise]] to a new promise.
6. `方位~lockを適用する$( %文書, %orientation ) ◎ Apply orientation lock orientation to document.
7. ~RET %文書 .`orientationPendingPromise$sl ◎ Return document's [[orientationPendingPromise]].

`unlock()@m ~method手続きは： ◎ When the unlock() method is invoked, the user agent MUST run the following steps:

1. %文書 ~LET コレに`関連な大域~obj$に`結付けられた文書$ ◎ Let document be this's relevant global object's associated Document.
2. `共通な安全性~検査$( %文書 ) ◎ Run the common safety checks with document. If an exception is thrown, re-throw that exception and abort these steps.
3. ~IF［ ~screenの`作動中な方位~lock$ ~EQ ~NULL ］ ⇒ ~RET ◎ If screen's active orientation lock is null, return undefined.
4. ~IF［ %文書 .`orientationPendingPromise$sl ~NEQ ~NULL ］ ⇒ `現在の~lock~promiseを却下して~NULL化する$( %文書, "`AbortError$E" ) ◎ If document's [[orientationPendingPromise]] is not null, reject and nullify the current lock promise of document with an "AbortError".
5. `方位~lockを適用する$( %文書 ) ◎ Apply orientation lock null to document.

`共通な安全性~検査@ は、 所与の ( `文書$ %文書 ) に対し： ◎ The common safety checks for a Document document are the following steps:

1. ~IF［ %文書 は`全部的に作動中$でない ］ ⇒ ~THROW `InvalidStateError$E `non-fully-active^test ◎ If document is not fully active, throw an "InvalidStateError" DOMException.
2. ~IF［ `閲覧~文脈~sandbox化( 方位~lock )~flag$ ~IN %文書 にて`作動中な~sandbox法~flag集合$ ］ ⇒ ~THROW `SecurityError$E `lock-sandboxed-iframe^test ◎ If document has the sandboxed orientation lock browsing context flag set, throw "SecurityError" DOMException.
3. ~IF［ %文書 の`可視性~状態$doc ~EQ `hidden^l ］ ⇒ ~THROW `SecurityError$E `hidden_document^test ◎ If document's visibility state is "hidden", throw "SecurityError" DOMException.

`type@m 取得子~手続きは ⇒ ~RET コレ.`type$sl ◎ When getting, the type attribute returns this's [[type]].

`angle@m 取得子~手続きは ⇒ ~RET コレ.`angle$sl ◎ When getting, the angle attribute returns this's [[angle]].

`閲覧~文脈$ %文脈 が作成されたときは、 次を走らすモノトスル： ◎ When a browsing context context is created, the user agent MUST:

1. %~screen方位 ~LET %文脈 【にて`作動中な~window$bc】の`方位~obj$ ◎ Let screenOrientation be context's associated ScreenOrientation.
2. %~screen方位 .`initialType$sl ~SET ~screenの`現在の方位~種別$ ◎ Initialize screenOrientation's [[initialType]] internal slot to the screen's current orientation type.
3. %~screen方位 .`type$sl ~SET ~screenの`現在の方位~種別$ ◎ Initialize screenOrientation's [[type]] internal slot to the screen's current orientation type.
4. %~screen方位 .`angle$sl ~SET ~screenの`現在の方位~角度$ ◎ Initialize screenOrientation's [[angle]] internal slot to the screen's current orientation angle.

`現在の~lock~promiseを却下して~NULL化する@ ときは、 所与の ( `文書$ %文書, 文字列【！DOMString】 %例外~名 ) に対し，次を走らすモノトスル： ◎ When steps require to reject and nullify the current lock promise of Document document with a DOMString exceptionName, the user agent MUST:

1. %~promise ~LET %文書 .`orientationPendingPromise$sl ◎ ↓
2. ~Assert： %~promise ~NEQ ~NULL ◎ Assert: [[orientationPendingPromise]] is not null. ◎ Let promise be document's [[orientationPendingPromise]].

3. `大域~taskを~queueする$( `~DOM操作~task~source$, %文書 に`関連な大域~obj$, 次の手続き ) ◎ Queue a global task on the DOM manipulation task source with document's relevant global object to＼

   手続きは ⇒ `~promiseを却下する$( %~promise, 新たな %例外~名 `DOMException$I )
   ◎ reject promise with a new exceptionName DOMException.
4. %文書 .`orientationPendingPromise$sl ~SET ~NULL ◎ Set document's [[orientationPendingPromise]] to null.

`方位~lockを適用する@ ときは、 所与の ( `文書$ %文書, `OrientationLockType$I %方位 （省略時は ~NULL ）) に対し，次を遂行するモノトスル： ◎ When steps require to apply orientation lock of OrientationLockType? orientation to Document document, the user agent MUST perform do the following steps:

1. ~IF［ %文書 `stops being^en `全部的に作動中$ `while in^en `並列的$† ］~AND［ %文書 .`orientationPendingPromise$sl ~NEQ ~NULL ］ ⇒ `現在の~lock~promiseを却下して~NULL化する$( %文書, "`AbortError$E" )

   【† この段は、 並列的に遂行されていないにもかかわらず， “並列的” が利用されている — その意図が はっきりしない （単に， “%文書 は`全部的に作動中$でない” ？）。 】

   ◎ If document stops being fully active while in parallel, and [[orientationPendingPromise]] is not null, reject and nullify the current lock promise of document with an "AbortError".
2. %~top-level文書 ~LET %文書 の`~node~navigable$の`~top-level辿可能$navにて`作動中な文書$nav ◎ Let topDocument be document's top-level browsing context's active document.

3. %~top-level文書 の`~node~navigable$の`子孫~navigable群$を成す ~EACH( %~navigable ) に対し： ◎ Let descendantDocs be an ordered set consisting of topDocument's descendant navigables's active documents, if any, in tree order. ◎ For each doc in descendantDocs:

   1. %子孫~文書 ~LET %~navigable にて`作動中な文書$nav ◎ ↑
   2. ~IF［ %子孫~文書 ~EQ %文書 ］ ⇒ ~CONTINUE ◎ If doc is document, continue.
   3. ~IF［ %子孫~文書 .`orientationPendingPromise$sl ~EQ ~NULL ］ ⇒ ~CONTINUE ◎ If doc [[orientationPendingPromise]] is null, continue.
   4. `現在の~lock~promiseを却下して~NULL化する$( %子孫~文書, "`AbortError$E" ) ◎ Reject and nullify the current lock promise of doc with an "AbortError".

4. この段は`並列的$に走らす： ◎ Run the following sub-steps in parallel:

   1. ~IF［ %文書 は`全部的に作動中$でない ］~AND［ %文書 .`orientationPendingPromise$sl ~NEQ ~NULL ］ ⇒＃ `現在の~lock~promiseを却下して~NULL化する$( %文書, "`AbortError$E" )； ~RET ◎ If document has stopped being fully active, and if the document's [[orientationPendingPromise]] is not null, reject and nullify the current lock promise of document with an "AbortError" and abort these steps.
   2. ~IF［ %方位 ~EQ ~NULL ］ ⇒ `~screen方位を~unlockする$ ◎ If orientation is null, unlock the screen orientation.

   3. ~ELSE： ◎ Otherwise,＼

      1. %方位 に`~screen方位を~lockする$よう試みる — ~platform規約に依存して， %文書 の表示域の描かれ方を %方位 に合致するよう変更する ◎ attempt to lock the screen orientation to orientation. Depending on platform conventions, change how the viewport is drawn to match orientation.

      2. ~IF［ 前~段の試みは失敗した （これまでに確立された利用者-選好, ~platform制限, その他の何らかの理由に因り） ］： ◎ If the attempt fails due to previously-established user preference, or platform limitation, or any other reason:

         1. ~screenの`作動中な方位~lock$ ~SET ~NULL ◎ Set the screen's active orientation lock to null.

         2. `~taskを~queueする$【`大域~taskを~queueする$】( `~DOM操作~task~source$, %文書 に`関連な大域~obj$, 次の手続き )： ◎ Queue a task on the DOM manipulation task source with document's relevant global object to:

            手続きは：

            1. ~IF［ %文書 .`orientationPendingPromise$sl ~NEQ ~NULL ］ ⇒ `現在の~lock~promiseを却下して~NULL化する$( %文書, "`NotSupportedError$E" ) ◎ If the document's [[orientationPendingPromise]] is not null, reject and nullify the current lock promise of document with a "NotSupportedError".

            2. `Abort these steps.^en

               【 この段は、 実際には，この手続きの外に置かれるべきに思われる。 ~RET を意味するこの段は，ここに在っても無為であることに加え、 そうしなければ，上で`作動中な方位~lock$を設定する段も無為になるので。 】

         3. 【~RET （上の訳注を見よ。）】

         注記： これは、 次のいずれかの場合に起こり得る：

         • 利用者が［ ~web~appが~screen方位を変更する ］ことを防止する選好を設定した
         • ~UAではなく下層の~platformが，所与の %方位 に~screen方位を~lockすることを許容していない 【これに該当するかどうかは、 %方位 にも依存するかもしれない。】

         ◎ Note This can happen if the user has set a preference that prevents web applications from changing the screen orientation, or if the underlying platform, rather than the user agent, does not allow locking the screen orientation to the given orientation.
   4. ~screenの`作動中な方位~lock$ ~SET %方位 ◎ Set the screen's active orientation lock to orientation＼
   5. ［ `現在の方位~種別$, `現在の方位~角度$ ］を［ `~screen方位$に対する変更を反映する ］よう更新する ◎ and update the current orientation type and current orientation angle to reflect any changes to the screen orientation.

5. `大域~taskを~queueする$( `~DOM操作~task~source$, %文書 に`関連な大域~obj$, 次の手続き )： ◎ Queue a global task on the DOM manipulation task source with document's relevant global object to:

   手続きは： ◎ ↑

   1. %~promise ~LET %文書 .`orientationPendingPromise$sl ◎ Let promise be document's [[orientationPendingPromise]].

      注記： ~promiseは `change$et ~eventを発火した後に解決する必要があるので、［ ~eventの~handler関数が `lock()$m を~callしても，中止されない ］よう参照を保つ。 ◎ Note As the promise needs to resolve after a "change" event is fired, we keep a reference to prevent it from being aborted by an event's handler function calling lock().

   2. %文書 .`orientationPendingPromise$sl ~SET ~NULL ◎ Set document's [[orientationPendingPromise]] to null.
   3. `~screen方位~変更~手続き$( %~top-level文書 ) ◎ Run the screen orientation change steps with topDocument.
   4. ~IF［ %~promise ~NEQ ~NULL ］ ⇒ `~promiseを解決する$( %~promise ) ◎ If promise is not null, resolve promise with undefined.

所与の`~top-level辿可能$ %辿可能 に対し， ［ ~UAが %辿可能 用に~screen方位を変更するよう決定した／ 利用者が %辿可能 を異なる~screenへ移動した ］ときは、 次を走らす ⇒ `~screen方位~変更~手続き$( %辿可能 にて`作動中な文書$nav ) ◎ When a user-agent determines that the screen's orientation has changed for a top-level browsing context, or the user moves the top-level browsing context to a different screen, then run the screen orientation change steps with the top-level browsing context's active document.

`~screen方位~変更~手続き@ は、 所与の ( `文書$ %文書 ) に対し，次に従う： ◎ The screen orientation change steps for Document document are as follows:

1. ~IF［ %文書 の`可視性~状態$doc ~EQ `hidden^l ］ ⇒ ~RET ◎ If document's visibility state is "hidden", abort these steps.
2. %種別 ~LET ~screenの`現在の方位~種別$ ◎ ↓
3. %角度 ~LET ~screenの`現在の方位~角度$ ◎ Let type and angle be the screen's current orientation type and current orientation angle.
4. %~screen方位 ~LET %文書 に`関連な大域~obj$の`方位~obj$ ◎ Let screenOrientation be document's relevant global object's associated ScreenOrientation.
5. ~IF［ %種別 ~EQ %~screen方位 .`type$sl ］~AND［ %角度 ~EQ %~screen方位 .`angle$sl ］ ⇒ ~RET ◎ If type is equal to screenOrientation's [[type]] and angle is equal to screenOrientation's [[angle]], abort these steps.

6. `大域~taskを~queueする$( `利用者~対話~task~source$, %文書 に`関連な大域~obj$, 次の手続き ) ◎ Queue a global task on the user interaction task source with document's relevant global object to＼

   手続きは： ◎ perform the following steps:

   1. %~screen方位 .`angle$sl ~SET %角度 ◎ Set screenOrientation's [[angle]] to angle.
   2. %~screen方位 .`type$sl ~SET %種別 ◎ Set screenOrientation's [[type]] to type.
   3. `~eventを発火する$( %~screen方位, `change$et ) ◎ Fire an event named "change" at screenOrientation.
7. %文書 の`~node~navigable$の`子孫~navigable群$を成す ~EACH( %~navigable ) に対し【！不要：if any, in tree order】 ⇒ `~screen方位~変更~手続き$( %~navigable にて`作動中な文書$nav ) ◎ Let descendantDocs be an ordered set consisting of document's descendant navigables's active documents, if any, in tree order. ◎ For each doc in descendantDocs, run the screen orientation change steps with doc.

`文書~unload時の片付け手続き$を所与の ( `文書$ %文書 ) の下で走らすときは、 次も走らすモノトスル ⇒ ~IF［ 【！%文書 は ある`~top-level閲覧~文脈$にて`作動中な文書$navである】 %文書 ~EQ %文書 の`~node~navigable$の`~top-level辿可能$navにて`作動中な文書$nav ］ ⇒ `~screen方位を全部的に~unlockする手続き$( %文書 ) ◎ Whenever the unloading document cleanup steps run with a document, the user agent MUST run the following steps: • If document is not a top-level browsing context's active document, abort these steps. • Run the fully unlock the screen orientation steps with document.

`~screen方位を全部的に~unlockする手続き@ は、 所与の ( `文書$ %文書 ) に対し，次に従う： ◎ The fully unlock the screen orientation steps for Document document are as follows:

1. ~IF［ %文書 .`orientationPendingPromise$sl ~NEQ ~NULL ］ ⇒ `現在の~lock~promiseを却下して~NULL化する$( %文書, "`AbortError$E" ) ◎ If document's [[orientationPendingPromise]] is not null, reject and nullify the current lock promise of document with an "AbortError".
2. `方位~lockを適用する$( %文書 の`~node~navigable$の`~top-level辿可能$navにて`作動中な文書$nav ) ◎ Let topDocument be document's top-level browsing context's active document. ◎ Apply orientation lock null to topDocument.