Spec-Zone.ru › Web APIs

Элемент: метод insertAdjacentText()

Базовая реализация Широко доступен

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

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

Метод insertAdjacentText() интерфейса Element, принимая относительную позицию и строку, вставляет новый узел текста в заданной позиции относительно элемента, из которого он вызван.

Синтаксис

insertAdjacentText(where, data)

Параметры

where

Строка, представляющая позицию относительно элемента, из которого вызывается метод; должна быть одной из следующих строк:

  • 'beforebegin': Перед самим элементом.
  • 'afterbegin': Внутри элемента, перед его первым дочерним элементом.
  • 'beforeend': Внутри элемента, после его последнего дочернего элемента.
  • 'afterend': После самого элемента.
data

Строка, из которой будет создан новый узел текста для вставки в заданную позицию where относительно элемента, из которого вызывается метод.

Возвращаемое значение

None (undefined).

Исключения

SyntaxError DOMException

Выбрасывается, если where не является распознаваемым значением.

Визуализация имён позиций

<!-- beforebegin -->
<p>
  <!-- afterbegin -->
  foo
  <!-- beforeend -->
</p>
<!-- afterend -->

Примечание: Позиции beforebegin и afterend работают только если у узла есть родительский элемент в дереве.

Примеры

beforeBtn.addEventListener("click", () => {
  para.insertAdjacentText("afterbegin", textInput.value);
});

afterBtn.addEventListener("click", () => {
  para.insertAdjacentText("beforeend", textInput.value);
});

Посмотрите наш демонстрационный пример insertAdjacentText.html на GitHub (и исходный код здесь). Здесь у нас простая абзацная структура. Вы можете ввести текст в элемент формы, а затем нажать кнопки Вставить перед и Вставить после, чтобы вставить его перед или после существующего текста абзаца с помощью insertAdjacentText(). Обратите внимание, что существующий узел текста не добавляется — создаются новые узлы текста, содержащие новые добавления.

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

Спецификация
DOM
# dom-element-insertadjacenttext

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

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на IOS Samsung Internet WebView Android
insertAdjacentText 1 17
12–17Поддерживается только для HTMLElement, а не для всех объектов Element, таких как SVGElement.
48 ≤12.1 4 18 48 ≤12.1 4 1.0 2.2

См. также

  • Element.insertAdjacentElement()
  • Element.insertAdjacentHTML()

© 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/Element/insertAdjacentText

Spec-Zone.ru

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