Element.ariaLevel

The ariaLevel property of the Element interface reflects the value of the aria-level attribute, which defines the hierarchical level of an element within a structure.

Note: Where possible use an HTML <h1> or other correct heading level as these have built in semantics and do not require ARIA attributes.

Syntax

var ariaLevel = element.ariaLevel;
element.ariaLevel = ariaLevel

Value

A DOMString containing an integer.

Examples

In this example the aria-level attribute on the element with an ID of main-heading is set to "1". Using ariaLevel we update the value to "2".

<div role="heading" id="main-heading" aria-level="1">This is a main page heading</div>

let el = document.getElementById('main-heading');
console.log(el.ariaLevel); // "1"
el.ariaLevel = "2"
console.log(el.ariaLevel); // "2"

Specifications

Specification
Accessible Rich Internet Applications (WAI-ARIA) 1.2 (WAI-ARIA 1.2) # dom-ariamixin-arialevel

Browser compatibility

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet
`ariaLevel`	81	81	No	No	68	12.1	81	81	No	58	12.2	13.0