Attr: localName Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die schreibgeschützte localName Eigenschaft der Attr Schnittstelle gibt den lokalen Teil des qualifizierten Namens eines Attributs zurück, also den Namen des Attributs, ohne jegliches vorangestelltes Namensraum-Präfix. Zum Beispiel, wenn der qualifizierte Name xml:lang ist, ist der zurückgegebene lokale Name lang, vorausgesetzt, das Element unterstützt diesen Namensraum.

Der lokale Name ist immer in Kleinbuchstaben, unabhängig von der Groß- und Kleinschreibung bei der Erstellung des Attributs.

Hinweis: HTML unterstützt nur eine festgelegte Menge an Namensräumen auf SVG- und MathML-Elementen. Diese sind xml (für das xml:lang Attribut), xlink (für die xlink:href, xlink:show, xlink:target und xlink:title Attribute) und xpath.

Das bedeutet, dass der lokale Name eines Attributs eines HTML-Elements immer gleich seinem qualifizierten Namen ist: Doppelpunkte werden als reguläre Zeichen behandelt. In XML, wie in SVG oder MathML, kennzeichnet der Doppelpunkt das Ende des Präfixes und das, was davor liegt, ist der Namensraum; der lokale Name kann sich vom qualifizierten Namen unterscheiden.

Wert

Ein String, der den lokalen Teil des qualifizierten Namens des Attributs repräsentiert.

Beispiel

Das folgende Beispiel zeigt den lokalen Namen des ersten Attributs der beiden ersten Elemente an, wenn wir auf den entsprechenden Button klicken. Das <svg> Element ist XML und unterstützt Namensräume, was dazu führt, dass der lokale Name (lang) sich vom qualifizierten Namen xml:lang unterscheidet. Das <label> Element ist HTML, das keine Namensräume unterstützt, wodurch der lokale Name und der qualifizierte Name beide xml:lang sind.

HTML

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

js
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++;
}

Spezifikationen

Specification
DOM Standard
# dom-attr-localname

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch