Свойство Attr: localName

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

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

Чтение-только свойство localName интерфейса Attr возвращает локальную часть полного имени атрибута, то есть имя атрибута, очищенное от любого префикса пространства имён. Например, если полное имя — xml:lang, то возвращаемое локальное имя — lang, если элемент поддерживает это пространство имён.

Локальное имя всегда в нижнем регистре, независимо от регистра при создании атрибута.

Примечание: HTML поддерживает только фиксированный набор пространств имён для элементов SVG и MathML. Это xml (для атрибута xml:lang), xlink (для атрибутов xlink:href, xlink:show, xlink:target и xlink:title), и xpath.

Это означает, что локальное имя атрибута HTML-элемента всегда равно его полному имени: двоеточия обрабатываются как обычные символы. В XML, как в SVG или MathML, двоеточие обозначает конец префикса, а всё, что перед ним, — пространство имён; локальное имя может отличаться от полного имени.

Значение

Строка, представляющая локальную часть полного имени атрибута.

Пример

В следующем примере отображается локальное имя первого атрибута двух первых элементов при нажатии соответствующей кнопки. Элемент <svg> — XML и поддерживает пространства имён, что приводит к тому, что локальное имя (lang) отличается от полного имени xml:lang. Элемент <label> — HTML, который не поддерживает пространства имён, что приводит к тому, что локальное имя и полное имя оба равны xml:lang.

HTML

<svg xml:lang="en-US" class="struct" height="1" width="1">Click me</svg>
<label xml:lang="en-US" class="struct"></label>

<p>
  <button>Show value for &lt;svg&gt;</button>
  <button>Show value for &lt;label&gt;</button>
</p>

<p>
  Local part of the attribute <code>xml:lang</code>:
  <output id="result">None.</output>
</p>

JavaScript

const elements = document.querySelectorAll(".struct");
const buttons = document.querySelectorAll("button");
const outputEl = document.querySelector("#result");

let i = 0;
for (const button of buttons) {
  const element = elements[i];
  button.addEventListener("click", () => {
    const attribute = element.attributes[0];
    outputEl.value = attribute.localName;
  });
  i++;
}

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

Спецификация
DOM # dom-attr-localname

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

	Рабочий стол					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`localName`	1	12	1	≤12.1	1	18	4	≤12.1	1	1.0	4.4

См. также

Свойства Attr.name, возвращающее полное имя атрибута, и Attr.prefix, префикс пространства имён.
Свойство Element.localName(), возвращающее локальное имя Element.

© 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/Attr/localName