atomic property

  1. @override
  2. @Accessor(key: 'aria-atomic')
bool? atomic

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?;
  1. @override
  2. @Accessor(key: 'aria-atomic')
void atomic=(bool? value)

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;