Element.localName
読み取り専用プロパティは、要素の修飾名のローカル部分を返します。
DOM4 より前、この API は Node
の中で定義されていました。
構文
name = element.localName
返り値
要素の修飾名の、ローカル部分を示す DOMString
。
例
(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" xmlns:ecomm="https://example.com/ecomm"> <ecomm:partners> <ecomm:partner id="1001">Tony's Syrup Warehouse </ecomm:partner> </ecomm:partner> </ecomm:business>
注: Gecko 1.9.2 以前、このプロパティは、HTML DOM における HTML 要素ではローカル名を大文字で返していました(XML DOM における XHTML 要素とは対照的に)。最新バージョンでは HTML5 に従い、このプロパティは内部の DOM ストレージの場合、HTML DOM における HTML要素と XHTML DOM における XHTML要素のいずれも、小文字で返します。tagName
プロパティは引き続き、HTML DOM における HTML要素では大文字で返します。
仕様
仕様 | 状態 | コメント |
---|---|---|
DOM4 Element.localName の定義 |
勧告 | 初めての定義 |
ブラウザ互換性
機能 | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
基本サポート | 46.0[1] | 48.0 (48.0)[1] | ? | (有) | ? |
機能 | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|
基本サポート | ? | 48.0 (48.0)[1] | ? | ? | ? |
[1] この API は以前、Node
API で利用可能でした。