Attr.localName
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 のように、コロンは接頭辞の終わりを表し、それ以前は名前空間となります。ローカル名は、修飾名と異なる場合があります。
値
属性の修飾名のローカル部分を表す文字列です。
例
HTML コンテンツ
<svg xml:lang="en-US" class="struct" height="1" width="1">Click me</svg>
<label xml:lang="en-US" class="struct"></label>
<button>Click me for <svg>…</button>
<button>Click me for <label>…</button>
<br><br>
Local part of the attribute <code>xml:lang</code>: <output id="result"><i>None.</i></output>
JavaScript コンテンツ
const elements = document.getElementsByClassName("struct");
const buttons = document.getElementsByTagName("button");
const result = document.querySelector("#result");
function handleEvent(element) {
return function(e) {
attribute = element.attributes[0];
result.value = attribute.localName;
}
}
let i=0;
for (let button of buttons) {
button.addEventListener('click', handleEvent(elements[i]));
i++;
}
結果
仕様書
Specification |
---|
DOM Standard # dom-attr-localname |
ブラウザーの互換性
BCD tables only load in the browser
関連情報
Attr.name
プロパティはこの属性の修飾名を返し、Attr.prefix
は名前空間接頭辞を返します。Element.localName()
プロパティはElement
のローカル名を返します。