WAudio

WAudio is a component for creating audio output controls.

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

UI-related Properties

The autoplay property

This property is part of the HTML5 AUDIO element specification but is not supported as it is in direct contravention of WCAG 2.0 guidelines SC 1.4.2 G171: Playing sounds only on user request. Some common user agents which support native audio players disable autoplay. This property should never be specified and is in the API for completeness.

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 and is in the API for completeness.

The muted property

This is a Boolean property which if set true will cause the media to initially be muted. The default is false and should generally be left in that state since we do not support autoplay so it makes little sense to mute an audio player which will only operate if explicitly triggered by the user.

The toolTip property

See toolTip.

Related Components

• WVideo

Further information

• JavaDoc;
• JSDoc (media player with legacy support);
• SchemaDoc;
• HTML Specification;
• List of WComponents.