EditContext: characterBounds()-Methode

Limited availability

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

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die characterBounds()-Methode der EditContext-Schnittstelle gibt ein Array zurück, das die Liste der Begrenzungsrechtecke für die Zeichen im EditContext-Objekt enthält.

Die Position und Größe der Zeichen in einem EditContext-Objekt wird vom Betriebssystem verwendet, um plattformspezifische, mit der Bearbeitung zusammenhängende Benutzeroberflächen wie ein Input Method Editor (IME)-Fenster korrekt zu positionieren, wenn dies erforderlich ist. Dies ist besonders wichtig in Situationen, in denen das Betriebssystem die Position und Größe der Zeichen nicht automatisch erkennen kann, wie z. B. beim Rendern von Text in einem <canvas>-Element.

Webentwickler werden höchstwahrscheinlich daran interessiert sein, das characterboundsupdate-Ereignis zusammen mit der EditContext.updateCharacterBounds()-Methode zu verwenden, um die Zeichenbegrenzungen zu aktualisieren, wenn das Betriebssystem angibt, dass es Informationen über die Position und Größe der Zeichen benötigt.

Die characterBounds()-Methode gibt die Liste der Zeichenbegrenzungen zurück, die zuletzt mit updateCharacterBounds() aktualisiert wurden. Die Liste enthält nicht für jedes Zeichen im EditContext-Objekt ein Element, sondern nur für die Zeichen, die mit updateCharacterBounds() aktualisiert wurden. Um zu wissen, wo sich die Zeichen im EditContext-Objekt befinden, verwenden Sie die EditContext.characterBoundsRangeStart-Eigenschaft.

Syntax

js
characterBounds()

Rückgabewert

Ein Array, das DOMRect-Objekte enthält.

Spezifikationen

Specification
EditContext API
# dom-editcontext-characterbounds

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch