inert Focus Suppression Lookup
Resolves inert attribute restrictions from own and inherited flat-tree inertness. A modal dialog opened with showModal escapes inherited inertness, while its own inert attribute still applies. Other disabling and focus rules are separate.
Description
Inert content suppresses interaction and focus across an inherited flat-tree state.
Inert content suppresses interaction and focus across an inherited flat-tree state. A modal dialog can escape inherited inertness while retaining its own inert attribute.1
Resolves inert attribute restrictions from own and inherited flat-tree inertness. A modal dialog opened with showModal escapes inherited inertness, while its own inert attribute still applies. Other disabling and focus rules are separate.
When to use inert Focus Suppression Lookup
Use this for the following task: Resolves inert attribute restrictions from own and inherited flat-tree inertness. A modal dialog opened with showModal escapes inherited inertness, while its own inert attribute still applies. Other disabling and focus rules are separate.
Prepare the parsed attribute values, element states or ordered local lists requested below. Keep attribute presence separate from value.
How to use inert Focus Suppression Lookup and understand its results
- Prepare the parsed attribute values, element states or ordered local lists requested below. Keep attribute presence separate from value.
- Enter ownInert, ancestorInert, modalDialogEscapes using the field table, then run the tool.
- Read inert, focusSuppressed, interactionSuppressed. Interpret flags, units, ordering and placeholder values using the rules below.
- Review any reported issue or failed check, correct the supplied values when appropriate, and verify the result in its intended context.
| Input field | Meaning | Value type and bounds | Requirement |
|---|---|---|---|
| ownInert | Own Inert | boolean | Required |
| ancestorInert | Ancestor Inert | boolean | Required |
| modalDialogEscapes | Modal Dialog Escapes | boolean | Required |
Supply own and inherited inertness and whether a modal dialog escapes the inherited state. Return the same effective flag for inertness, focus suppression and interaction suppression.2
inert = ownInert OR (ancestorInert AND !modalDialogEscapes) This summarizes the declared operation. Units, indexing, inclusivity and exceptional cases are explained in the surrounding text.
| Output field | Meaning | Value type |
|---|---|---|
| inert | Inert | boolean |
| focusSuppressed | Focus Suppressed | boolean |
| interactionSuppressed | Interaction Suppressed | boolean |
{
"input": {
"ownInert": false,
"ancestorInert": true,
"modalDialogEscapes": false
},
"output": {
"inert": true,
"focusSuppressed": true,
"interactionSuppressed": true
}
}Limitations and assumptions
The tool does not traverse the flat tree or evaluate other disabling and focus rules.
This evaluates supplied local information; it does not fetch a page or run a browser. Malformed requests produce input errors. A successfully evaluated request can still contain false flags, empty result lists or a result outside the supplied threshold; those outcomes have the meanings stated above.
Alternative or Complementary methods
Choose dialog::backdrop Open Method Lookup for this operation: Classifies closed, show/open nonmodal and showModal modal dialog states. Only modal dialogs enter the top layer and have a backdrop; actual appearance depends on CSS. For a complementary task, use Positive tabindex Anti-Pattern Check for this operation: Classifies an explicit parsed tabindex integer: positive values request an ordering priority, zero follows ordinary sequential order, negative requests exclusion from sequential navigation. Disabled, inert and browser focus preferences are outside this attribute-only check.
Further background: HTML / accessibility reference: inert Focus Suppression Lookup.
References
Similar or alternative tools
- dialog::backdrop Open Method Lookup
Classifies closed, show/open nonmodal and showModal modal dialog states. Only modal dialogs enter the top layer and have a backdrop; actual appearance depends on CSS.
- Positive tabindex Anti-Pattern Check
Classifies an explicit parsed tabindex integer: positive values request an ordering priority, zero follows ordinary sequential order, negative requests exclusion from sequential navigation. Disabled, inert and browser focus preferences are outside this attribute-only check.