Spec-Zone.ru › Web APIs

EditContext: метод updateControlBounds()

Ограниченная доступность

Эта функция не является Baseline, так как она не работает в некоторых из наиболее широко используемых браузеров.

  • Узнать больше
  • Полная совместимость
  • Отправить отзыв

Экспериментальная функция: Это экспериментальная технология
Перед использованием в рабочей среде внимательно ознакомьтесь со таблицей совместимости браузеров.

Метод EditContext.updateControlBounds() интерфейса EditContext используется для информирования операционной системы о позиции и размерах области редактируемого текста объекта EditContext.

Вызовите этот метод, чтобы сообщить операционной системе границы текущей области редактирования. Вы должны вызывать его при инициализации EditContext и всякий раз, когда изменяются границы области редактирования, например, при изменении размеров веб-страницы. Эти границы используются для позиционирования специфичных для платформы пользовательских интерфейсов, связанных с редактированием, таких как окно Input Method Editor (IME).

Синтаксис

updateControlBounds(controlBounds)

Параметры

controlBounds

Объект DOMRect, представляющий новые границы управления.

Исключения

  • Если аргумент не указан, выбрасывается исключение TypeError DOMException.
  • Если предоставленный аргумент не является объектом DOMRect, выбрасывается исключение TypeError DOMException.

Примеры

Обновление границ управления при инициализации редактора и при изменении размера окна

В этом примере показано, как использовать метод updateControlBounds() для указания платформе местоположения области редактирования в любое время.

#editor {
  border: 1px solid black;
  height: 50vw;
  width: 50vh;
}
<div id="editor"></div>
const editorEl = document.getElementById("editor");
const editContext = new EditContext();
editorEl.editContext = editContext;

function updateControlBounds() {
  const editorBounds = editorEl.getBoundingClientRect();
  editContext.updateControlBounds(editorBounds);
  console.log(
    `Updated control bounds to ${editorBounds.x}, ${editorBounds.y}, ${editorBounds.width}, ${editorBounds.height}`,
  );
}

// Update the control bounds now.
updateControlBounds();
// And when the page is resized.
window.addEventListener("resize", updateControlBounds);

Спецификации

Спецификация
API EditContext
# dom-editcontext-updatecontrolbounds

Совместимость с браузерами

Десктоп Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
updateControlBounds 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/EditContext/updateControlBounds

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API