Skip to content
marksreeves edited this page Jul 25, 2016 · 15 revisions

WAudio is a component for creating audio output controls.

Accessibility

Every use of WAudio must comply with the requirements outlined in Media Accessibility User Requirements. The WCAG quick references pertinent to WAudio can be found at Guideline 1.2, Guideline 1.4.2 and Guideline 1.4.7.

HTML output

WAudio is based on a HTML audio element. This is embedded content and is, in itself, phrasing content. However, it may be converted to, or be wrapped in, other components depending upon the user agent and the audio media.

For all design purposes you should assume that WAudio includes non-phrasing content and interactive controls.

Legacy support

WAudio will output links to source (and track if provided) files in any user agent which is unable to play any of the audio provided.

Screen shot of a typical use

Screen shot of an audio element in Chrome 33

UI-related Properties

The autoplay property

When set true this property will cause the audio to play automatically in supported browsers. Use of this setting is discouraged as it may conflict with WCAG guideline 1.4.2. It is recommended that audio clips be played only on user request as outlined in G171. Some common user agents which support native audio players disable autoplay.

The loop property

This is a Boolean property which if true will cause the audio to automatically restart once it finishes. This defaults to false and should generally be left there. This property should never be specified; it is in the API for completeness and is under review.

The toolTip property

See toolTip.

Related Components

Further information

Clone this wiki locally