Spec-Zone.ru › Web APIs

HTMLElement: свойство outerText

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

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

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

Свойство outerText интерфейса HTMLElement возвращает то же значение, что и HTMLElement.innerText. При использовании в качестве установщика оно заменяет весь текущий узел заданным текстом (это отличается от innerText, которое заменяет содержимое внутри текущего узла).

Для получения дополнительной информации и примеров использования обоих свойств в качестве получателей см. HTMLElement.innerText.

Значение

Строка, представляющая отрендеренное текстовое содержимое элемента и его потомков.

Если сам элемент не отображается (например, отсоединён от документа или скрыт от просмотра), возвращаемое значение такое же, как и свойство Node.textContent.

При использовании в качестве установщика оно заменяет текущий узел заданным текстом, преобразуя любые символы новой строки в элементы <br>.

Примеры

Этот пример демонстрирует основное различие между outerText и innerText при использовании в качестве установщиков (при использовании в качестве получателей они одинаковы).

Примечание: Пример — изменённая версия Что такое разница между innerText и outerText? (Stack Overflow) от codingintrigue, лицензия CC BY-SA 3.0.

Рассмотрим страницу с следующим HTML:

<div>
  <p>Original content</p>
</div>

outerText заменяет весь выбранный элемент, поэтому JavaScript p.outerText = "Whole element replaced" заменяет весь выбранный p элемент:

<div>Whole element replaced</div>

В отличие от этого, p.innerText = "Content inside element replaced" заменяет содержимое внутри выбранного p элемента:

<div>
  <p>Content inside element replaced</p>
</div>

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

Спецификация
HTML
# dom-outertext

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

Рабочий стол Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
outerText 1 12 98 ≤12.1 1.3 18 98 ≤12.1 1 1.0 1

См. также

  • HTMLElement.innerText
  • Element.outerHTML

© 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/outerText

Spec-Zone.ru

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