Important: This website does not attempt to establish a standard for how assistive technologies must behave. Read the FAQ for more information. Additionally, this is a work in progress. Please submit feedback or suggestions.

log role (aria)

Screen Reader support level: partial (62/66)

On this page

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 3 years ago to 4 years ago. Detailed dates and version information can be found in associated tests.

Caution

Failing or partial results may be out of date. The oldest result is from 4 years ago. Consider running the associated tests and contributing results.

Expectations

What are expectations?

Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
MUST announce changes to the live regionsupportedsupportedsupportednonesupportedsupportedsupportedsupportedsupportedsupportedsupported
MUST convey the implicit aria-live value of polite by not interrupting the current announcementsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupported
MUST convey the implicit aria-atomic value of false by only announcing content that has changedsupportedsupportedsupportednonesupportedsupportedsupportedsupportedsupportedsupportedsupported
MAY convey its name and role as part of the live announcement if it has a namenonenonenonenonepartialpartialnonenonenonenonenone
MAY convey its name and role while navigating the page if it has a namesupportedsupportednonenonesupportedsupportednonenonenonenonesupported

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.
Screen Reader support for 'MUST announce changes to the live region'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
named log role applied to: div elementsupportedsupportedsupportednonesupportedsupportedsupportedsupportedsupportedsupportedsupported
unnamed log role applied to: div elementsupportedsupportedsupportednonesupportedsupportedsupportedsupportedsupportedsupportedsupported

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.
Screen Reader support for 'MUST convey the implicit aria-live value of polite by not interrupting the current announcement'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
named log role applied to: div elementsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupported
unnamed log role applied to: div elementsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupported

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".
Screen Reader support for 'MUST convey the implicit aria-atomic value of false by only announcing content that has changed'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
named log role applied to: div elementsupportedsupportedsupportednonesupportedsupportedsupportedsupportedsupportedsupportedsupported
unnamed log role applied to: div elementsupportedsupportedsupportednonesupportedsupportedsupportedsupportedsupportedsupportedsupported

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
Screen Reader support for 'MAY convey its name and role as part of the live announcement if it has a name'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
named log role applied to: div elementnonenonenonenonepartialpartialnonenonenonenonenone

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.
Screen Reader support for 'MAY convey its name and role while navigating the page if it has a name'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
named log role applied to: div elementsupportedsupportednonenonesupportedsupportednonenonenonenonesupported