Элемент: метод insertAdjacentText()
Базовая реализация Широко доступен
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.
Метод insertAdjacentText() интерфейса Element, принимая относительную позицию и строку, вставляет новый узел текста в заданной позиции относительно элемента, из которого он вызван.
Синтаксис
insertAdjacentText(where, data)
Параметры
where-
Строка, представляющая позицию относительно элемента, из которого вызывается метод; должна быть одной из следующих строк:
-
'beforebegin': Перед самим элементом. -
'afterbegin': Внутри элемента, перед его первым дочерним элементом. -
'beforeend': Внутри элемента, после его последнего дочернего элемента. -
'afterend': После самого элемента.
-
data-
Строка, из которой будет создан новый узел текста для вставки в заданную позицию
whereотносительно элемента, из которого вызывается метод.
Возвращаемое значение
None (undefined).
Исключения
-
SyntaxErrorDOMException -
Выбрасывается, если
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 | 48 | ≤12.1 | 4 | 18 | 48 | ≤12.1 | 4 | 1.0 | 2.2 |
См. также
© 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