Template:Audio/doc

This template enhances the regular audio embed with automatic fallback using multiple <source> elements, no preloading for faster load times, and no download option. Uses HTML5AudioPlayer.

To use, replace any regular audio embed with this template. For example, [[File:Elevator Jam.ogg]] can be replaced with {{Audio|Elevator Jam.ogg}}. When played, it tries to play File:Elevator Jam.ogg, falling back to File:Elevator Jam.ogg.mp3 if OGG files cannot be played in the current browser.

Usage

{{Audio|1|2|no-fallback=|allow-preload=}}

Parameters

No description.

Template parameters

This template prefers inline formatting of parameters.

Parameter		Description	Type	Status
Primary audio file	1	Name of the primary audio file, without "File:".	String	required
Fallback audio file	2	Name of the audio file to be played when the primary one fails. By default, this is the primary file with .mp3 appended. Default <primary audio file>.mp3	String	optional
Disable fallback?	no-fallback	Disables the fallback functionality. Use if the primary audio file is not an OGG file.	Boolean	optional
Allow preloading?	allow-preload	Allows the audio to be embedded when custom JavaScript is not available, like on mobile devices, at the expense of slower load times. Use if the page has a few audio files or if the audio files are small.	Boolean	optional

Examples

Template code	Generates
Typical usage {{Audio|Elevator Jam.ogg}}	Play (MP3) }}{{#var: audio-no-js-text}}
MP3 file {{Audio|Trailer Theme Remix.mp3|no-fallback=1}}	Play }}{{#var: audio-no-js-text}}
Preloading allowed {{Audio|Item Shimmer.ogg|allow-preload=1}}	Play (MP3) }}{{#var: audio-no-js-text}}