atomic property
Indicates whether assistive technologies will present all, or only parts of, the changed region based on the change notifications defined by the aria-relevant attribute. See related aria-relevant.
Both accessibility APIs and the Document Object Model DOM
provide events to allow the assistive
technologies to determine changed areas of the document.
When the content of a live region changes, user agents SHOULD examine the changed element and traverse the ancestors to find the first element with aria-atomic set, and apply the appropriate behavior for the cases below.
If none of the ancestors have explicitly set aria-atomic, the default is that aria-atomic is false, and assistive technologies will only present the changed node to the user.If aria-atomic is explicitly set to false, assistive technologies will stop searching up the ancestor chain and present only the changed node to the user.If aria-atomic is explicitly set to true, assistive technologies will present the entire contents of the element.
When aria-atomic is true, assistive technologies MAY choose to combine several changes and present the entire changed region at once.
See: developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-atomic
Implementation
@override
@Accessor(key: 'aria-atomic')
bool? get atomic => (props[_$key__atomic___$AriaPropsMixin] ?? null) as bool?;
Indicates whether assistive technologies will present all, or only parts of, the changed region based on the change notifications defined by the aria-relevant attribute. See related aria-relevant.
Both accessibility APIs and the Document Object Model DOM
provide events to allow the assistive
technologies to determine changed areas of the document.
When the content of a live region changes, user agents SHOULD examine the changed element and traverse the ancestors to find the first element with aria-atomic set, and apply the appropriate behavior for the cases below.
If none of the ancestors have explicitly set aria-atomic, the default is that aria-atomic is false, and assistive technologies will only present the changed node to the user.If aria-atomic is explicitly set to false, assistive technologies will stop searching up the ancestor chain and present only the changed node to the user.If aria-atomic is explicitly set to true, assistive technologies will present the entire contents of the element.
When aria-atomic is true, assistive technologies MAY choose to combine several changes and present the entire changed region at once.
See: developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-atomic
Implementation
@override
@Accessor(key: 'aria-atomic')
set atomic(bool? value) => props[_$key__atomic___$AriaPropsMixin] = value;