Skip to main content

Visit Mozilla.org

DOM:element.localName

From MDC

« Gecko DOM Reference

Contents

[edit] Summary

Returns the local part of the qualified name of this node.

[edit] Syntax 

name = element.localName
  • name is the local name as a string (see Notes below for details)

[edit] Example

(Must be served with XML content type, such as text/xml or application/xhtml+xml.) 

<html xmlns="http://www.w3.org/1999/xhtml"
      xmlns:svg="http://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>

[edit] Notes

The local name of a node is that part of the node's qualified name that comes after the colon. Qualified names are typically used in XML as part of the namespace(s) of the particular XML documents. For example, in the qualified name ecomm:partners, partners is the local name and ecomm is the prefix: 

<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>

For nodes of any type other than ELEMENT_NODE and ATTRIBUTE_NODE and nodes created with a DOM Level 1 method, such as document.createElement, localName is always null.

[edit] See Also

element.namespaceURI

[edit] Specification

DOM Level 2 Core: Node.localName

Retrieved from "http://developer.mozilla.org/en/docs/DOM:element.localName"