利用者活性化

[81] DOM API の中には利 (り) 用 (よう) 者 (しゃ) 活 (かっ) 性 (せい) 化 (か) (user activation) が必要なものがいくつかあります。利用者活性化とは、利用者が viewport 内の要素をクリックするなど、当該閲覧文脈に対して明確に操作する意思を示したことをいいます。

[82] 利用者活性化の制約は、ある種のブラクラのような利用者の操作を妨害する動作をスクリプト (の著者) が勝手に実行させることを防ぐものであります。 Webプラットフォームの草創期 (平成時代初期) にその危険性が知られるようになり、発見的な制約から徐々に整備が進んできました。現在では HTML Standard によって挙動が詳細に定められています。

文脈

[83] 利用者活性化の制約は、 viewport の枠を超えて画面表示に干渉するような操作や、装置 (ハードウェア) の状態を変化させるような操作などに課されています。

[77] 利用者活性化は、粘着性活性化と過渡活性化の2つに大別されます。両者の使い方によって、利用者活性化に依存した API は3種類に分類されます。

[78] sticky activation-gated API は、最初に user activation を得るまでブロックされる API です。粘着性活性化状態が真である必要があるものです。 >>39
[79] transient activation-gated API は、 user activation ごとに、その過渡活性化状態が満期するまで、何度でも呼び出せる API です。過渡活性化状態が真である必要があるものです。 >>39
[80] transient activation-consuming API は、 user activation ごとに高々1回だけ呼び出せる API です。過渡活性化状態が真である必要があって、利用者活性化を消費するものです。 >>39

活性化通知

[84] 利用者活性化は、窓 (Window) ごとに管理されます。つまり利用者が Webブラウザーのある窓を操作しても、他の窓には影響しません。また、利用者があるフレームを操作しても、他のフレームに影響するとは限りません。

[85] 利用者によるクリックなどの操作は、活性化通知につながります。

[40] Window は、最 (さい) 終 (しゅう) 活 (かっ) 性 (せい) 化 (か) 時 (じ) 刻 (こく) 印 (いん) (last activation timestamp) を持ちます。これは、最後の活性化通知を得た時刻を表しています。 DOMHighResTimeStamp 値の他に、 +∞ や -∞ となることがあります。初期値は +∞ です。 >>39

[49] 閲覧文脈閲覧文脈における活 (かっ) 性 (せい) 化 (か) 通 (つう) 知 (ち) (activation notification) は、次のようにします。 >>39

[51] 文書を、 閲覧文脈の活性文書に設定します。
[52] 閲覧文脈群を、 閲覧文脈、 閲覧文脈の祖先閲覧文脈すべて、 文書の list of descendant browsing contexts 中の閲覧文脈のうち、その活性文書が文書と同じ起源であるものすべて、を含むリストに設定します。
[53] 窓群を、 閲覧文脈群中の各閲覧文脈のWindowProxyのWindowから構築したWindowのリストに設定します。
[54] 窓群の各窓について、順に、
1. [55] 窓の最終活性化時刻印を、現在高解像度時刻に設定します。

[50] 利用者エージェントは、閲覧文脈閲覧文脈における user interaction に関する activation triggering input event の dispatch の前に、 閲覧文脈について活性化通知しなければなりません。 >>39

[56] activation triggering input event は、次のすべてを満たすイベントイベントです。 >>39

[57] イベントのisTrustedが真、かつ、
[58] イベントの型が次のいずれか:
- change
- click
- contextmenu
- dblclick
- mouseup
- pointerup
- reset
- submit
- touchend

[87] 装置からの入力を表すイベントでも、 mousemove や orientationchange のように利用者の明示的な操作を表すとはいえないものは含まれていません。

[88] 利用者エージェントが発生させるイベントが対象です。スクリプトが dispacthEvent を使っても効果はありません。

粘着性活性化

[43] Window 窓が粘 (ねん) 着 (ちゃく) 性 (せい) 活 (かっ) 性 (せい) 化 (か) (sticky activation) 状態であるか否かは、

窓の最終活性化時刻印 ≦ 現在高解像度時刻

... であるか否かです。 >>39

[44] 窓の粘着性活性化は、利用者が窓と interaction したことがあるかどうかを表しています。初期状態では偽になります (現在高解像度時刻が +∞)。 窓が初めて活性化通知を得たとき真となり、再び偽となることはありません。 >>39

[45] Web頁を開いたとき (または勝手に開かれたとき)、利用者が何も操作していないのに、勝手に意図せぬ動作をして利用者が困るのを防ぐため、使われています。

過渡活性化

[46] Window 窓が過 (か) 渡 (と) 活 (かっ) 性 (せい) 化 (か) (transient activation) 状態であるか否かは、

窓の最終活性化時刻印 ≦ 現在高解像度時刻 < 窓の最終活性化時刻印 + 過渡活性化時間長

... であるか否かです。 >>39

[47] 窓の過渡活性化は、利用者が最近窓と interaction したかどうかを表しています。初期状態では偽になります。 窓が活性化通知を得たとき真となり、しばらくして偽に戻ります。 >>39

[86] 過渡活性化が真から偽に変化するのは、一定時間が経過した場合 (満期) と、特定の API が呼び出された場合 (利用者活性化消費) の2通りがあります。

[41] 過 (か) 渡 (と) 活 (かっ) 性 (せい) 化 (か) 時 (じ) 間 (かん) 長 (ちょう) (transient activation duration) は、利用者エージェントの定義する値です。対象の API において利用者による活性化が利用可能な長さを表す定数です。 >>39

[42] この値は、高々数秒程度で、利用者による頁との interaction と、頁が当該 API を呼び出したこととの関係を知覚できる長さであることが期待されています。 >>39

[48] 窓の過渡活性化状態が過渡活性化時間長の経過を以て偽となることを、満 (まん) 期 (き) 済 (ずみ) (expired) といいます。 >>39

[59] Window 窓について利 (り) 用 (よう) 者 (しゃ) 活 (かっ) 性 (せい) 化 (か) 消 (しょう) 費 (ひ) (consume user activation) は、次のようにします。 >>39

[61] 窓の閲覧文脈が null の場合、
1. [62] ここで停止します。
[63] 頂を、 窓の閲覧文脈の最上位閲覧文脈に設定します。
[70] 閲覧文脈群を、 頂の活性文書のlist of the descendant browsing contextsに設定します。
[71] 頂を、 閲覧文脈群の末尾に追加します。
[72] 窓群を、 閲覧文脈群中の各閲覧文脈のWindowProxyのWindowから構築したWindowのリストに設定します。
[73] 窓群の各窓について、順に、
1. [74] 窓の最終活性化時刻印が +∞ でない場合、
  1. [75] 窓の最終活性化時刻印を、 -∞ に設定します。

[76] 仕様書のアルゴリズム中の list of the descendant browsing contexts は毎回新しい複製が得られるようです。

[60] 活性化消費するAPIから呼び出されます。 >>39

[89] 過渡活性化は、次の場面で参照されます。

[90] 過渡活性化状態用API

歴史

初期モデル

[1] Editorial: "allowed to show a popup" → "triggered by user activation" ( (domenic著, 2016-06-01 17:23:12 +09:00)) https://github.com/whatwg/html/commit/797f412eb78fd88bd5d0a1c098d17fbf1736c188

[2] Existing intervention: user gesture required for sensitive operations · Issue #12 · WICG/interventions ( (2016-06-02 18:08:21 +09:00)) https://github.com/WICG/interventions/issues/12

[3] Allow requestFullscreen() to be called from an orientation change event (mounirlamouri著, 2016-07-22 02:49:53 +09:00) https://github.com/whatwg/fullscreen/commit/e5e96a9da944babf0e246980559cd80a46a300ca

[11] 17041 – Setting location before the page is done loading shouldn't always be a replace load ( (2016-08-26 14:04:08 +09:00)) https://www.w3.org/Bugs/Public/show_bug.cgi?id=17041

[12] Consider pointerup and touchend for "triggered by user activation" (NavidZ著, 2016-10-13 05:29:42 +09:00) https://github.com/whatwg/html/commit/adafe995c6d4f5f6df0497a534d31e51043b6750

[30] Add allow-top-navigation-by-user-activation sandbox token (domenic著, 2017-02-24 04:51:48 +09:00) https://github.com/whatwg/html/commit/8abd73ec3a56541e3f6486d3a593a8bcfd67295d

[33] Require user gesture to request notification permissions · Issue #49 · WICG/interventions (2017-07-16 00:39:12 +09:00) https://github.com/WICG/interventions/issues/49

[34] Need concept of "consuming" user activation · Issue #3122 · whatwg/html (2017-10-14 21:02:25 +09:00) https://github.com/whatwg/html/issues/3122

[35] Treat trusted contextmenu events as user activation (mustaqahmed著, 2018-05-03 01:07:47 +09:00) https://github.com/whatwg/html/commit/51bd770cf58cdd761674df0f47c9f9dfc58c5310

[36] Treat trusted `contextmenu` events as user activation. by mustaqahmed · Pull Request #3659 · whatwg/html (2018-05-03 10:55:44 +09:00) https://github.com/whatwg/html/pull/3659

[37] Deprecations and removals in Chrome 69 | Web | Google Developers (2018-09-15 02:56:15 +09:00) https://developers.google.com/web/updates/2018/09/chrome-70-deps-rems

user activation

[69] triggered by user activation (旧 allowed to show a popup) とは、次のいずれかの条件を満たすことをいいます >>68。

[14] タスクが信頼済み click イベントの活性化動作の処理中である
[15] タスクが信頼済み click, change, contextmenu, dblclick, mouseup, reset, submit, pointerup, touchend イベントのイベントリスナーの処理中である
[16] タスクが triggered by user activation なタスクからタスクキューに追加されたものである、ただし最初のタスクから利用者エージェント定義の時間が経過していない

[17] 時間制限は、例えばクリックから数秒後ならともかく、数時間後は相応しくない >>68 ことによります。

[29] button のクリック時のポップアップは認められますが、 input の入力や select の変更では認められません。

[31] 他に、閲覧文脈外部で利用者の明示的な指示があった場合も含めるべきと思われます。

[32] 例えば利用者がブックマークから選択したブックマークレットが window.open を実行した場合、ポップアップ窓が開かれるのが普通です。

[64] Location では、次のいずれかの条件を満たすと分岐します >>65。 (タスク以外の判定条件もあります。 Location 参照。)

[66] タスクが信頼済み click イベントの活性化動作の処理中である
[67] タスクが信頼済み click イベントのイベントリスナーの処理中である

[18] タスクは、自身がこの条件を満たしているかどうかの情報を保持しておく必要があります。またイベントオブジェクト (の持つ情報の一部または全部) も必要かもしれません。例えば window.open は、プラットフォームの慣習により、 Ctrl 押下時に新しい閲覧文脈を常に開く、といったような動作にできます。

[25] 実際には triggered by user activation の実装 (またはその呼び出し元の実装) は更に厳しく制限しているかもしれません。

[27] 例えば同じタスク内で多数の新しい最上位閲覧文脈を作成するのはブラクラであり、拒否するべきと考えられます。

[26] 更に、タスクを超えた制約もあるかもしれません。

[28] 例えば setTimeout を使って短時間に別のタスクで多くの新しい最上位閲覧文脈を作成するのはブラクラであり、拒否するべきと考えられます。

[19] triggered by user activation は、次の場面で使われます。