概要
このノードの修飾名のローカル部分を返します。
構文
name = element.localName
name
は文字列でのローカル名です(詳細は下の注記 を参照してください)
例
(text/xml
や application/xhtml+xml
のような XML コンテンツタイプで提供されなくてはなりません。)
<html xmlns="https://www.w3.org/1999/xhtml" xmlns:svg="https://www.w3.org/2000/svg"> <head> <script type="application/javascript"><![CDATA[ function test() { var text = document.getElementById('text'); var circle = document.getElementById('circle'); text.value = "<svg:circle> has:\n" + "localName = '" + circle.localName + "'\n" + "namespaceURI = '" + circle.namespaceURI + "'"; } ]]></script> </head> <body onload="test()"> <svg:svg version="1.1" width="100px" height="100px" viewBox="0 0 100 100"> <svg:circle cx="50" cy="50" r="30" style="fill:#aaa" id="circle"/> </svg:svg> <textarea id="text" rows="4" cols="55"/> </body> </html>
注記
ノードのローカル名はノードの修飾名のコロン(:)の後ろの部分です。修飾名は特定の XML 文書の名前空間の一部として XML の中で特に使われます。例えば、修飾名 ecomm:partners
の中で partners
がローカル名で ecomm
が接頭辞です。
<ecomm:business id="soda_shop" type="brick_n_mortar"> <ecomm:partners> <ecomm:partner id="1001">Tony's Syrup Warehouse </ecomm:partner> </ecomm:partner> </ecomm:business>
Needs to be reworded; right now it's wrong. -Nickolay The prefix—in this case, "ecomm"—defines the namespace in which the local name can be used.
Gecko 1.9.2 note
Firefox 3.5 およびそれ以前では、このプロパティは HTML DOM 中の HTML 要素については大文字のローカル名を返します(XML DOM 中の XHTML 要素については小文字のローカル名を返します)。 Firefox 3.6 以降のバージョンでは、 HTML 5 との互換性のため、内部的な DOM ストレージにおける大文字/小文字で返します。つまり、 HTML DOM と XML DOM の両方において、 HTML 要素は小文字のローカル名となります。 tagName プロパティは、 HTML DOM 中の HTML 要素についても今まで通り大文字のローカル名を返します。
ELEMENT_NODE
と ATTRIBUTE_NODE
以外の種類全てに属すノードでは、常に localName
は null
です。