Element.ariaAutoComplete reflects the aria-autocomplete attribute (MDN). It tells assistive technologies whether typing in a combobox, searchbox, or textbox may show predictions — and how those predictions are presented: "inline", "list", "both", or "none".
Read the notes below before you get or set this property. Prefer feature detection when support is limited.
Syntax
Use el.ariaAutoComplete. Start with this line.
JavaScript
element.ariaAutoComplete
Call
What it does
element.ariaAutoComplete
Primary signature.
Built into the browser. Read or assign el.ariaAutoComplete — no import required.
Library declarations
JavaScript
element.ariaAutoComplete
Parameters
This member has no parameters beyond those shown in the signature.
Return Value
Return Value
Description
*
The current value of el.ariaAutoComplete.
JavaScript Examples
Example 1 — Read ariaAutoComplete (MDN)
Read the reflected string from a combobox input.
JavaScript
const el = document.getElementById("animal");
console.log(el.ariaAutoComplete);
// → "inline"
Assign "list". Matches a popup collection of values (MDN).
Attribute updates to aria-autocomplete="list".
AT expects a listbox (or similar) for suggestions.
Keep popup attrs in sync (aria-expanded, controls).
Example 3 — Cycle Allowed Values
Step through inline → list → both → none.
JavaScript
const el = document.getElementById("animal");
const modes = ["inline", "list", "both", "none"];
let i = modes.indexOf(el.ariaAutoComplete);
if (i < 0) i = 0;
i = (i + 1) % modes.length;
el.ariaAutoComplete = modes[i];
console.log(el.ariaAutoComplete);
In real apps, pick one stable mode for the widget design.
Compatibility
Browser Support
Element.ariaAutoComplete is Baseline Widely available on MDN (across browsers since October 2023). Safe to use for reflecting aria-autocomplete on combobox/search/textbox widgets.
✓ Baseline Widely available
Element.ariaAutoComplete
Reflect aria-autocomplete for prediction UI — widely supported.
WideBaseline
Google ChromeSupported · Desktop & Mobile
Full support
Mozilla FirefoxSupported · Desktop & Mobile
Full support
Apple SafariSupported · macOS & iOS
Full support
Microsoft EdgeSupported · Chromium
Full support
Internet ExplorerNo native support · Use a polyfill
Polyfill
OperaSupported · Modern versions
Full support
Samsung InternetSupported · Android
Full support
Android WebViewSupported · Modern WebView
Full support
ariaAutoCompleteWidely available
Bottom line: Use "inline" | "list" | "both" | "none". Prefer "list" for combobox + listbox popups. Not the same as HTML autocomplete autofill.
Frequently Asked Questions
It reflects the aria-autocomplete attribute as a string, describing whether typing may show predictions for a combobox, searchbox, or textbox, and how those predictions are presented (MDN).
No. MDN marks Element.ariaAutoComplete as Baseline Widely available (across browsers since October 2023). It is not Deprecated, Experimental, or Non-standard.
One of the strings "inline", "list", "both", or "none" (MDN).
MDN’s example updates from "inline" to "list", noting that "list" is the expected value for a combobox that invokes a listbox popup.
HTML autocomplete (and autofill) is about browser/password-manager form filling. aria-autocomplete / ariaAutoComplete describes ARIA prediction UI for widgets like comboboxes.
Yes. Reading and writing ariaAutoComplete updates the reflected aria-autocomplete attribute (MDN).
