EditContext

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

EditContext インターフェイスは、EditContext API を用いて、編集可能になった要素のテキスト編集コンテキストを表します。

EditContext API は、インプットメソッドエディター (IME) による変換、絵文字ピッカー、その他のプラットフォーム固有の編集関係の UI などの高度なテキスト入力体験に対応したリッチなテキストエディターをウェブ上で構築するのに利用できます。

コンストラクター

EditContext()

新しい EditContext のインスタンスを返します。

インスタンスプロパティ

EditContext.text 読取専用

要素の編集可能なコンテンツです。

EditContext.selectionStart 読取専用

編集可能なテキストコンテンツ内での、現在選択されている範囲の始点のオフセットです。

EditContext.selectionEnd 読取専用

編集可能なテキストコンテンツ内での、現在選択されている範囲の終点のオフセットです。

EditContext.characterBoundsRangeStart 読取専用

編集可能なテキストコンテンツ内での、IME による変換が最後に開始された場所のオフセットです。

インスタンスメソッド

EditContext は EventTarget インターフェイスがもととなっており、そのメソッドを含みます。

EditContext.attachedElements()

この EditContext オブジェクトに関係する要素である HTMLElement オブジェクト 1 個が格納された Array です。

EditContext.characterBounds()

EditContext オブジェクト内の各文字を囲む長方形のリストです。

EditContext.updateText()

EditContext オブジェクト内部のテキストコンテンツを更新します。

EditContext.updateSelection()

編集可能なテキストコンテンツ内の選択の内部状態を更新します。

EditContext.updateControlBounds()

オペレーティングシステムに、編集可能なテキスト領域の位置と大きさを知らせます。

EditContext.updateSelectionBounds()

オペレーティングシステムに、編集可能なテキスト領域内で選択されている部分の位置と大きさを知らせます。

EditContext.updateCharacterBounds()

オペレーティングシステムに、EditContext オブジェクト内の各文字の位置と大きさを知らせます。

イベント

textupdate

ユーザーがテキストまたは選択範囲を変更した時発火します。

textformatupdate

インプットメソッドエディター (IME) ウィンドウを用いた変換を実行中であり、IME が変換の状態を表すためテキストの変換中の部分を別の書式で表示するべきだと判断した時発火します。

characterboundsupdate

オペレーティングシステムが、IME ウィンドウを表示するため、EditContext オブジェクトの編集可能なテキスト領域内にある特定の各文字の大きさと位置を知る必要がある時発火します。

compositionstart

IME ウィンドウを用いた変換が開始する時発火します。

compositionend

IME ウィンドウを用いた変換が終了する時発火します。

仕様書

Specification
EditContext API
# dom-editcontext

ブラウザーの互換性

BCD tables only load in the browser