Spec-Zone.ru › Web APIs

Элемент: свойство tagName

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

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

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

tagName свойство интерфейса Element, возвращает имя тега элемента, к которому оно применено.

Например, если элемент является <img>, его tagName свойство равно IMG (для HTML документов; в XML/XHTML документах оно может иметь другой регистр). Примечание: вы можете использовать свойство localName для доступа к локальному имени элемента — в данном случае img (в нижнем регистре).

Значение

Строка, указывающая имя тега элемента. Регистр этой строки зависит от типа документа:

  • Для DOM-деревьев, представляющих HTML-документы, возвращаемое имя тега всегда в стандартном верхнем регистре. Например, tagName вызываемое на элементе <div> возвращает "DIV".
  • Имена тегов элементов в XML DOM-дереве возвращаются в том же регистре, что и в исходном XML-файле. Если XML-документ содержит тег "<SomeTag>", тогда значение свойства tagName равно "SomeTag".

Для объектов Element, значение tagName такое же, как у свойства nodeName, которое наследуется элементом от объекта Node.

Примеры

HTML

<span id="born">When I was born…</span>

JavaScript

const span = document.getElementById("born");
console.log(span.tagName);

В XHTML (или любом другом XML формате) сохраняется исходный регистр, поэтому "span" будет выведено, если исходное имя тега было создано в нижнем регистре. В HTML, вместо этого будет выведено "SPAN" независимо от регистра, использованного при создании исходного документа.

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

Спецификация
DOM
# ref-for-dom-element-tagname①

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

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на IOS Samsung Internet WebView Android
tagName 1 12 1 8 1 18 4 10.1 1 1.0 4.4

См. также

  • Element.localName

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

Spec-Zone.ru

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