HTMLElement: editContext-Eigenschaft
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, bevor Sie diese produktiv verwenden.
Die editContext-Eigenschaft des HTMLElement-Interfaces ruft das zugeordnete EditContext-Objekt eines Elements ab und setzt es.
Die EditContext API kann verwendet werden, um Rich-Text-Editoren im Web zu erstellen, die fortgeschrittene Textein- und -ausgaberfahrungen unterstützen, wie z.B. die Input Method Editor (IME) Komposition, Emoji-Auswahl oder andere plattform-spezifische, bearbeitungsbezogene Benutzeroberflächen.
Mögliche Elemente
Das Setzen der editContext-Eigenschaft funktioniert nur bei bestimmten Elementtypen:
- Eines dieser HTML-Elemente:
<article>,<aside>,<blockquote>,<body>,<div>,<footer>,<h1>,<h2>,<h3>,<h4>,<h5>,<h6>,<header>,<main>,<nav>,<p>,<section>, oder<span>. - Ein gültiges Custom Element.
- Ein
<canvas>-Element.
Wenn Sie versuchen, die editContext-Eigenschaft auf einem Element zu setzen, das nicht zu den oben genannten gehört, wird ein NotSupportedError DOMException ausgelöst.
Element-Zuordnung
Wenn die editContext-Eigenschaft eines Elements auf eine EditContext-Instanz gesetzt wird, wird dieses Element mit der EditContext-Instanz verknüpft.
Die Zuordnung ist eins-zu-eins:
- Ein Element kann nur mit einer
EditContext-Instanz verknüpft werden. - Eine
EditContext-Instanz kann nur einem Element zugeordnet werden.
Wenn Sie versuchen, eine bereits zugeordnete EditContext-Instanz einem anderen Element zuzuordnen, wird eine DOMException ausgelöst.
Wenn Sie versuchen, eine andere EditContext-Instanz zu einem bereits zugeordneten Element zuzuordnen, wird ebenfalls eine DOMException ausgelöst.
Um zu überprüfen, ob ein Element bereits mit einer EditContext-Instanz verknüpft ist, verwenden Sie die Methode EditContext.attachedElements().
Speicherbereinigung
Eine EditContext-Instanz hält ihr zugeordnetes Element am Leben, wenn es andere aktive Referenzen gibt, selbst wenn das zugeordnete Element aus dem DOM entfernt wird.
Wenn Sie sicherstellen möchten, dass das Element einer Speicherbereinigung unterzogen wird, löschen Sie die editContext-Eigenschaft des Elements.
Wert
Ein EditContext-Objekt oder null.
Beispiele
Die editContext-Eigenschaft eines Elements setzen
Dieses Beispiel zeigt, wie Sie die editContext-Eigenschaft eines <canvas>-Elements auf eine neue EditContext-Instanz setzen, um das Element bearbeitbar zu machen.
<canvas id="editor-canvas"></canvas>
const canvas = document.getElementById("editor-canvas");
const editContext = new EditContext();
canvas.editContext = editContext;
Die editContext-Eigenschaft eines Elements löschen
Dieses Beispiel zeigt, wie Sie die editContext-Eigenschaft eines bearbeitbaren <canvas>-Elements löschen, um das Element sicher aus dem DOM zu entfernen.
<canvas id="editor-canvas"></canvas>
// Create the EditContext and associate it with the canvas element.
const canvas = document.getElementById("editor-canvas");
const editContext = new EditContext();
canvas.editContext = editContext;
// Later, clear the editContext property, and remove the element.
canvas.editContext = null;
canvas.remove();
Spezifikationen
| Specification |
|---|
| EditContext API # dom-htmlelement-editcontext |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
- Die
EditContext-Schnittstelle.