入力イベント レベル 2

この文書は、UIイベント仕様 [UI-EVENTS] で説明されている input および beforeinput の2つのイベントに編集関連の追加を記述します。これらのイベントの目的は、著者が編集の前後でデフォルト編集動作を理解・上書きできるようにすることです。

非規範的と記載されたセクションだけでなく、本仕様書に含まれる著作ガイドライン・図・例・注記もすべて非規範的です。それ以外の記述はすべて規範的です。

本文書中の MAY、MUST、MUST NOT というキーワードは、BCP 14 [RFC2119] [RFC8174] に示される通り、ここで示すようにすべて大文字で記載されている場合のみ適用されます。

意図の表明

ユーザーは、キーボード・IME・音声入力などの手段を使って、特定の編集操作を実行する意図を表明できます。具体的な入力操作は、プラットフォームごとの慣習に従って意図にマッピングされます。

キルバッファ

この定義は規範的ではありません。

キルバッファは、クリップボードとは別のリッチテキストコンテンツを格納するインメモリストアで、特定の削除コマンドによって削除された内容を一時的に保存するためのものです。ユーザーはキルバッファをヤンクする意図を示すことで、現在の選択範囲をキルバッファの内容で置換できます。

このセクションは規範的ではありません。

ウェブベースのテキストエディターを作成するには、ブラウザーコードの上に多くのJavaScriptが必要になりますが、その理由は以下の通りです。

1. ブラウザーごとに編集操作の扱いが異なるため。
2. 一部の編集操作に対するブラウザーの挙動にバグが多いため。
3. 各サイトごとに編集操作の扱いに独自の好みがあるため。
4. ブラウザーの高機能テキスト編集機能の開発は、Extensible Web Manifestoの原則に従っていない場合があり、ウェブ開発者コミュニティのニーズと連携していないことがあるため。

本仕様は、beforeinput イベントを通じてすべてのユーザー入力に関するブラウザーの処理を上書きできる方法と、input イベントを通じてユーザー入力によるDOMの変更を監視できる方法をウェブ開発者に提供し、こうした課題の解消を目指します。

このセクションは規範的ではありません。

1. JavaScriptテキストエディターを作成し、ユーザーが太字としてマークしたテキストを <b> タグではなく <strong> タグでマークするように、すべてのブラウザーにアクセスできなくても、ブラウザー組み込みの太字機能を利用できるようにする。
2. 編集されたテキストのDOMへのレンダリングをJavaScriptが担当し、裏でデータモデルが動作するJavaScriptテキストエディターを作成する。
3. 太字のみ許可し斜体は許可しないなど、リッチテキスト編集の一部のみを許可するJavaScriptエディターを作成する。
4. ユーザーが異なるブラウザーで異なる意図表現方法を用いても、ユーザーの意図に基づきJavaScriptでDOM変更をレンダリングする協働型エディターを作成する。
5. 一部ユーザーのみテキスト追加・削除が可能、他のユーザーのみ特定の書式設定の追加・削除が可能な、異なるアクセス権限を持つJavaScriptエディターを作成する。

入力イベントは、ユーザーがマークアップを編集しようとする前（beforeinputイベント）および後（inputイベント）に送信されます。これには、内容の挿入・削除や書式変更も含まれます。

入力イベントは、dispatchされる対象として、編集ホストとなる要素（contenteditable属性が設定された要素、 textarea 要素、ならびに input 要素でテキスト入力を許可するもの）が含まれます。

WebIDLpartial interface InputEvent {
   readonly attribute DataTransfer? dataTransfer;
   sequence<StaticRange> getTargetRanges();
};

partial dictionary InputEventInit {
   DataTransfer? dataTransfer = null;
   sequence<StaticRange> targetRanges = [];
};

構成の開始は、compositionstartイベントのdispatchによって示されます。

構成セッション中、テキスト構成システムがアクティブなテキスト部分を更新するたびに、compositionupdateイベントがdispatchされます。

各compositionupdateイベントの後に、beforeinputイベントとinputイベントのペアがdispatchされます。 beforeinputおよびinputイベントは：

• キャンセル不可である
• inputTypeが"insertCompositionText"に設定されている
• data属性はcompositionupdateイベントのそれと等しい
• targetRangeは構成のアクティブなテキスト部分を囲む

アクティブなテキスト部分のDOM内容は、beforeinputイベントのdispatch後、inputイベントのdispatch前に更新されます。

構成セッションの終了は、compositionendイベントのdispatchによって示されます。

"insertFromPaste"のbeforeinputイベントがdispatchされる場合、必ずその前にpaste [CLIPBOARD-APIS]イベントがdispatchされなければなりません。

このセクションは規範的ではありません。

この機能による既存イベント（keydownやkeypress[UI-EVENTS]イベントなど）ですでに利用可能なフィンガープリント [fingerprinting-guidance]技術を除き、既知のセキュリティやプライバシーへの影響はありません。

この機能が既存イベントを置き換える場合、ユーザーの意図が記録されるため、利用したハードウェアの種類ではなくフィンガープリント [fingerprinting-guidance]技術の利用可能性が低下する可能性があります。 意図の表明方法が記録されるためです。

Michael Aufreiter、Adrian Bateman、Oliver Buchtala、Robin Berjon、Enrica Casucci、Bo Cupp、Domenic Denicola、Emil Eklund、Olivier Forget、Aryeh Gregor、Marijn Haverbeke、Yoshifumi Inoue、Koji Ishii、Gary Kacmarcik、Ian Kilpatrick、Frederico Caldeira Knabben、Takayoshi Kochi、Piotrek Koszuliński、Travis Leithead、Grisha Lyukshin、Miles Maxfield、Chaals McCathie Nevile、Masayuki Nakano、Ryosuke Niwa、Julie Parent、Ben Peters、Florian Rivoal、Morgan Smith、Hallvord R. M. Steen、Johan Sörlin、Cristian Talau、Dave Tapuska、Ojan Vafai、Léonie Watson、Xiaoqian Wu、Chong Zhang、Joanmarie、そしてEditing Taskforceの皆様に感謝します。