log role (aria)
Screen reader support level: partial (74/79)
Voice Control support level: unknown
On this page
- About this feature
- Age of results
- Expectations
- announce changes to the live region
- convey the implicit aria-live value of polite by not interrupting the current announcement
- convey the implicit aria-atomic value of false by only announcing content that has changed
- convey its name and role as part of the live announcement if it has a name
- convey its name and role while navigating the page if it has a name
- Related tests
- Is something not right?
About this feature
A type of live region where new information is added in meaningful order and old information may disappear
Age of results
Results across all tests for this feature range from 4 months ago to a year ago. Detailed dates and version information can be found in associated tests.
Failing and partial results are between a year ago and a year ago.
Expectations
Screen Reader support by expectation
| Expectation | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| MUST announce changes to the live region | supported | supported | supported | none | supported | supported | supported | supported | supported | supported | supported |
| MUST convey the implicit aria-live value of polite by not interrupting the current announcement | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
| MUST convey the implicit aria-atomic value of false by only announcing content that has changed | supported | supported | supported | none | supported | supported | supported | supported | supported | supported | supported |
| MAY convey its name and role as part of the live announcement if it has a name | none | none | none | none | partial | partial | none | none | none | none | none |
| MAY convey its name and role while navigating the page if it has a name | supported | supported | none | none | supported | supported | none | none | none | none | supported |
Voice Control support by expectation
| Expectation | Dragon Naturally Speaking | Voice Access (Android) | Voice Control (iOS) | Voice Control (MacOS) | Windows Speech Recognition |
|---|---|---|---|---|---|
| Chrome | Chrome | Safari | Safari | Chrome | |
| Not applicable | |||||
Expectation: announce changes to the live region
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Examples:
- Screen readers will automatically announce the live region.
| Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| named log role applied to: div element | supported | supported | supported | none | supported | supported | supported | supported | supported | supported | supported |
| unnamed log role applied to: div element | supported | supported | supported | none | supported | supported | supported | supported | supported | supported | supported |
Expectation: convey the implicit aria-live value of polite by not interrupting the current announcement
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Examples:
- Screen readers will changes to content within role="log" after other announcements finish.
| Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| named log role applied to: div element | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
| unnamed log role applied to: div element | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
Expectation: convey the implicit aria-atomic value of false by only announcing content that has changed
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Examples:
- Screen readers will announce all the content within role="log".
| Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| named log role applied to: div element | supported | supported | supported | none | supported | supported | supported | supported | supported | supported | supported |
| unnamed log role applied to: div element | supported | supported | supported | none | supported | supported | supported | supported | supported | supported | supported |
Expectation: convey its name and role as part of the live announcement if it has a name
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MAY
- Voice Control: NA
Examples:
- Screen readers may announce the name and logf role if it has a name from the author (usually via aria-label or aria-labelledby).
- The name will be announced before or after the contents of the live region.
- The the role will be implied by interruption, or may be explicitly stated as something like "log" or an earcon
| Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| named log role applied to: div element | none | none | none | none | partial | partial | none | none | none | none | none |
Expectation: convey its name and role while navigating the page if it has a name
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MAY
- Voice Control: NA
Examples:
- Screen readers may announce the name and role if it has a name from the author (usually via aria-label or aria-labelledby). The name and role are usually announced when navigating into the element.
- screen readers may convey the role as an earcon.
| Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| named log role applied to: div element | supported | supported | none | none | supported | supported | none | none | none | none | supported |