Attr.localName

The Attr.localName read-only property returns the local part of the qualified name of an element.

Before DOM4 this API was defined within the Node interface.

Syntax

JavaScript
<var>name</var> = <var>attribute</var>.localName

Return value

A DOMString representing the local part of the attribute's qualified name.

Example

The following example shows "id" in an alert dialog.

HTML Content

HTML
<button id="example">Click me</button>

JavaScript Content

JavaScript
const element = document.querySelector("#example");
element.addEventListener("click", function() {
  const attribute = element.attributes[0];
  alert(attribute.localName);
});

Notes

The local name of an attribute is the part of the attribute'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.

Note: In Gecko 1.9.2 and earlier, the property returns the upper-cased version of the local name for HTML attributes in HTML DOMs (as opposed to XHTML attributes in XML DOMs). In later versions, in compliance with HTML5, the property returns in the case of the internal DOM storage, which is lower case for both HTML attributes in HTML DOMs and XHTML attributes in XML DOMs.

Specifications

Specification Status Comment
DOM4
The definition of 'Attr.localName' in that specification.		 Recommendation Initial definition

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support 46.0[1] 48.0 (48.0)[1] ? (Yes) ?
Feature Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support ? 48.0 (48.0)[1] ? ? ?

[1] This API was previously available on the Node API.

See also

License

© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/api/attr/localname

API DOM NeedsBrowserCompatibility NeedsMobileBrowserCompatibility Property Reference