HTMLElement: свойство editContext
Ограниченная доступность
Эта функция не относится к Baseline, так как она не работает в некоторых из наиболее широко используемых браузеров.
Экспериментально: Это экспериментальная технология экспериментальная технология
Перед использованием в производстве внимательно проверьте таблицу совместимости браузеров в разделе Таблица совместимости браузеров.
Свойство editContext интерфейса HTMLElement получает и устанавливает связанный с элементом объект EditContext.
API EditContext можно использовать для создания веб-редакторов с богатым функционалом, которые поддерживают расширенный ввод текста, такие как ввод с помощью редактора метода ввода (IME), выбор эмодзи или любые другие платформенно-специфические элементы пользовательского интерфейса, связанные с редактированием.
Возможные элементы
Установка свойства editContext работает только с определёнными типами элементов:
- Один из этих HTML-элементов:
<article>,<aside>,<blockquote>,<body>,<div>,<footer>,<h1>,<h2>,<h3>,<h4>,<h5>,<h6>,<header>,<main>,<nav>,<p>,<section>, или<span>. - Действительный пользовательский элемент.
- Элемент
<canvas>.
Если вы попытаетесь установить свойство editContext для элемента, который не является одним из вышеперечисленных, будет брошено исключение NotSupportedError DOMException.
Связывание элемента
Установка свойства editContext элемента на экземпляр EditContext связывает этот элемент с экземпляром EditContext.
Связь является однозначной:
- Элемент может быть связан только с одним экземпляром
EditContext. - Экземпляр
EditContextможет быть связан только с одним элементом.
Если вы попытаетесь связать уже связанный экземпляр EditContext с другим элементом, будет брошено исключение DOMException.
Если вы попытаетесь связать другой экземпляр EditContext с элементом, который уже связан, также будет брошено исключение DOMException.
Чтобы проверить, связан ли элемент с экземпляром EditContext, используйте метод EditContext.attachedElements().
Уборка мусора
Экземпляр EditContext сохранит связанный элемент активным, если у него есть другие активные ссылки, даже если связанный элемент удалён из DOM.
Если вы хотите убедиться, что элемент будет удалён, очистите свойство editContext элемента.
Значение
Объект EditContext или null.
Примеры
Установка свойства editContext элемента
Этот пример показывает, как установить свойство editContext элемента <canvas> на новый экземпляр EditContext для редактирования элемента.
<canvas id="editor-canvas"></canvas>
const canvas = document.getElementById("editor-canvas");
const editContext = new EditContext();
canvas.editContext = editContext;
Очистка свойства editContext элемента
Этот пример показывает, как очистить свойство editContext редактируемого элемента <canvas> для безопасного удаления элемента из DOM.
<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();
Спецификации
| Спецификация |
|---|
| API EditContext # dom-htmlelement-editcontext |
Совместимость браузеров
| Рабочий стол | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | |
editContext |
121 | 121 | Нет | 107 | Нет | 121 | Нет | 81 | Нет | 25.0 | 121 |
См. также
- Интерфейс
EditContext.
© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/editContext
