EditContext: characterBounds() メソッド

Limited availability

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

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

EditContext インターフェイスの characterBounds() メソッドは、この EditContext オブジェクト内の各文字を囲む長方形のリストが格納された Array を返します。

EditContext オブジェクト内の各文字の位置とサイズは、必要に応じて、オペレーティングシステムがインプットメソッドエディター (IME) などのプラットフォーム固有の編集関係の UI を正しく配置するために用いられます。これは、テキストを <canvas> 要素に描画するときなど、オペレーティングシステムが自動的に各文字の位置と大きさを求めることができない状況で特に重要です。

ウェブ開発者は、characterboundsupdate イベントと EditContext.updateCharacterBounds() メソッドを組み合わせて用い、オペレーティングシステムが各文字の位置と大きさの情報を要求した時に各文字の領域を更新することに関心を持つ可能性が高いでしょう。

characterBounds() メソッドは、updateCharacterBounds() により最後に更新された各文字の領域のリストを返します。このリストには EditContext オブジェクト内のすべての文字に対応する要素が格納されているのではなく、updateCharacterBounds() で更新された文字に対応する要素のみが格納されています。これらの各文字が EditContext オブジェクト内のどこに位置するかを知るには、EditContext.characterBoundsRangeStart プロパティを使用してください。