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() Experimental

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

インスタンスプロパティ

EditContext.text 読取専用 Experimental

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

EditContext.selectionStart 読取専用 Experimental

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

EditContext.selectionEnd 読取専用 Experimental

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

EditContext.characterBoundsRangeStart 読取専用 Experimental

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

インスタンスメソッド

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

EditContext.attachedElements() Experimental

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

EditContext.characterBounds() Experimental

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

EditContext.updateText() Experimental

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

EditContext.updateSelection() Experimental

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

EditContext.updateControlBounds() Experimental

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

EditContext.updateSelectionBounds() Experimental

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

EditContext.updateCharacterBounds() Experimental

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

イベント

textupdate Experimental

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

textformatupdate Experimental

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

characterboundsupdate Experimental

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

compositionstart Experimental

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

compositionend Experimental

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

仕様書

Specification
EditContext API
# dom-editcontext

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
EditContext
Experimental
EditContext() constructor
Experimental
attachedElements
Experimental
characterBounds
Experimental
characterBoundsRangeStart
Experimental
characterboundsupdate event
Experimental
compositionend event
Experimental
compositionstart event
Experimental
selectionEnd
Experimental
selectionStart
Experimental
text
Experimental
textformatupdate event
Experimental
textupdate event
Experimental
updateCharacterBounds
Experimental
updateControlBounds
Experimental
updateSelection
Experimental
updateSelectionBounds
Experimental
updateText
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.
See implementation notes.