spAriaUtil - Client

concept australia Updated Sep 10, 2026 1 min read spAriaUtil-API.md
Raw file servicenow.com

The spAriaUtil API provides methods to show messages on a screen reader.

This API is an angular service that you can use in Service Portal widget client scripts.

Parent Topic:Client API reference

spAriaUtil - sendLiveMessage(String message)

Announce a message to a screen reader.

The sendLiveMessage() method injects text into an aria-live region on the page. The default setting for an aria-live region is assertive, which means that messages are announced immediately. This can annoy and confuse users if used too frequently.

Name Type Description
message String The message to be shown.
Type Description
void
JavaScript
function(spAriaUtil) {  /* widget controller */
  spAriaUtil.sendLiveMessage('Hello world!');}
Search documentation
Search document titles and file paths on the australia branch