JavaScript Element ariaValueMin Property

Beginner
5 min read
Updated: Nov 2026
3 examples
Property
Decorative image with the word ARIAVALUEMIN

Definition

Element.ariaValueMin reflects the aria-valuemin attribute: the minimum allowed value for a range widget such as a slider, scrollbar, or spinbutton (MDN). The value is a string number (decimal allowed).

Read the notes below before you get or set this property. Prefer feature detection when support is limited.

Syntax

Use el.ariaValueMin. Start with this line.

JavaScript
el.ariaValueMin / el.ariaValueMin = value
CallWhat it does
el.ariaValueMin / el.ariaValueMin = valuePrimary signature.

Built into the browser. Read or assign el.ariaValueMin — no import required.

Library declarations
JavaScript
el.ariaValueMin / el.ariaValueMin = value

Parameters

ParameterDescription
Range widgetRequired. slider / scrollbar / spinbutton / meter…
String numberRequired. Minimum; must be < max

Return Value

Return ValueDescription
*The current value of el.ariaValueMin.

JavaScript Examples

Example 1 — Read ariaValueMin

Log the minimum from a day-of-week slider.

JavaScript
const el = document.getElementById("slider");
console.log(el.ariaValueMin); // "1"

// HTML: role="slider" aria-valuemin="1" …
Try It Yourself

How It Works

  1. Find the slider. getElementById returns the range widget node.
  2. Read the reflection. ariaValueMin returns the aria-valuemin string.
  3. Interpret "1". Assistive technologies treat 1 as the floor of the range.
  4. Missing attribute. If unset, many browsers return null.

Example 2 — Update the Minimum (MDN)

MDN: change the reported min from "1" to "2".

JavaScript
const el = document.getElementById("slider");

console.log(el.ariaValueMin); // "1"
el.ariaValueMin = "2";
console.log(el.ariaValueMin); // "2"
console.log(el.getAttribute("aria-valuemin")); // "2"
Try It Yourself

How It Works

  1. Start at 1. The first log shows the initial minimum.
  2. Assign a string. el.ariaValueMin = "2" updates the reflected attribute.
  3. Confirm both sides. Property and getAttribute both report "2".
  4. After raising min. If ariaValueNow is below the new min, clamp it up.

Example 3 — Keep ariaValueNow in Range

When raising the min, clamp the current value so it stays valid.

JavaScript
const el = document.getElementById("slider");
const min = 3;

el.ariaValueMin = String(min);
let now = Number(el.ariaValueNow);
if (now < min) {
  el.ariaValueNow = String(min);
}

console.log(el.ariaValueMin); // "3"
console.log(el.ariaValueNow); // "3" (clamped from 1)
Try It Yourself

How It Works

  1. Raise the floor. Set ariaValueMin to "3".
  2. Read the current value. Convert ariaValueNow with Number(...).
  3. Clamp if needed. If now is below min, write min back to ariaValueNow.
  4. Why it matters. A current value below the minimum confuses assistive technologies.
Compatibility

Browser Support

Element.ariaValueMin is Baseline Widely available (MDN: across browsers since October 2023).

✓ Baseline · Widely available

Element.ariaValueMin

Supported in modern Chromium, Firefox, Safari, and Edge. Internet Explorer has no ariaValueMin IDL — use getAttribute / setAttribute there.

95% Modern browser support
Google Chrome Supported · Desktop & Mobile
Full support
Mozilla Firefox Supported · Desktop & Mobile
Full support
Apple Safari Supported · macOS & iOS
Full support
Microsoft Edge Supported · Chromium
Full support
Internet Explorer No native support · Use a polyfill
Polyfill
Opera Supported · Modern versions
Full support
Samsung Internet Supported · Android
Full support
Android WebView Supported · Modern WebView
Full support
Element.ariaValueMin Excellent

Bottom line: Safe for modern web apps. Prefer native min when you can; for custom widgets keep min, max, and now consistent.

Frequently Asked Questions

It reflects the aria-valuemin attribute as a string number that defines the minimum allowed value for a range widget such as a slider, scrollbar, spinbutton, meter, or progressbar.
No. MDN marks Element.ariaValueMin as Baseline Widely available (since October 2023). It is not Deprecated, Experimental, or Non-standard.
A string containing a number (decimal allowed), and it must be less than the maximum value (aria-valuemax).
MDN lists it as required for slider, scrollbar, and spinbutton. It is also used on meter, separator, and progressbar-related range widgets.
No. MDN warns that the abstract range role should not be used. Use a concrete subtype such as slider, scrollbar, or spinbutton.
On native <input type="range">, <progress>, or <meter>, prefer the HTML min attribute. Use aria-valuemin when you build a custom range widget with ARIA roles.

Next: ariaValueNow

Learn the reflected aria-valuenow property for the current value of range widgets like sliders and progress bars.

ariaValueNow tutorial →

About the author

Mari Selvan M P
Mari Selvan M P 🔗

Developer, cloud engineer, and technical writer

  • Experience 12 years building web and cloud systems
  • Focus Full Stack Development, AWS, and Developer Education

I write practical tutorials so students and working developers can learn by doing—from databases and APIs to deployment on AWS.

AWS Certified Developer – Associate (Credly)

11 people found this page helpful

JavaScript Element ariaValueMax Property JavaScript Element ariaValueNow Property