Web/API/Attr/localName

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

In previous DOM specifications this API was defined within the Node interface.

Syntax

name = attribute.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

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

JavaScript Content

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
DOMThe definition of 'Attr.localName' in that specification.	Living Standard	Initial definition

Browser compatibility

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`localName`	Chrome Full support 46 Notes' Full support 46 Notes' Notes' This API was previously available on the `Node` API.	Edge Full support ≤18	Firefox Full support 48 Notes' Full support 48 Notes' Notes' This API was previously available on the `Node` API.	IE No support No	Opera Full support 33 Notes' Full support 33 Notes' Notes' This API was previously available on the `Node` API.	Safari Full support 1.3	WebView Android Full support 46 Notes' Full support 46 Notes' Notes' This API was previously available on the `Node` API.	Chrome Android Full support 46 Notes' Full support 46 Notes' Notes' This API was previously available on the `Node` API.	Firefox Android Full support 48 Notes' Full support 48 Notes' Notes' This API was previously available on the `Node` API.	Opera Android Full support 33 Notes' Full support 33 Notes' Notes' This API was previously available on the `Node` API.	Safari iOS Full support 1	Samsung Internet Android Full support 5.0 Notes' Full support 5.0 Notes' Notes' This API was previously available on the `Node` API.

Legend

Full support: Full support
No support: No support
See implementation notes.': See implementation notes.