<audio>

Sommario

L'elemento HTML <audio> viene usato per incorporare contenuti sonori nei documenti. Può contenere diverse origini dell'audio, rappresentate usando l'attributo src o l'elemento <source>; il browser sceglierà il più adatto.

Si può anche aggiungere del contenuto per i browser che non supportano l'elemento <audio>.

Si possono usare direttamente le Web Audio API per generare e manipolare l'audio tramite il codice JavaScript.

• Categorie del contenuto Contenuto di flusso, contenuto delle espressioni, contenuto incluso. Se ha l'attributo controls: contenuto interattivo e contenuto tangibile.
• Contenuto permessoSe l'elemento ha l'attributo src: zero o più elementi <track>, seguiti da contenuto trasparente che non contenga elementi <audio> e <video>.
• Altrimenti: zero o più elementi <source>, seguiti da zero o più elementi <track>, seguiti da contenuto trasparente che non contenga elementi <audio> e <video>.
• Omissione dei tag Nessuna, sia il tag di apertura che quello di chiusura sono obbligatori.
• Elementi genitore permessi Qualsiasi elemento che accetti contenuto incluso.
• Interfaccia DOM HTMLAudioElement

Attributi

Questo elemento supporta gli attributi globali.

• none: indica che probabilmente l'audio non verrà ascoltato dall'utente o che il selver vuole minimizzare il traffico; in altre parole l'audio non dovrebbe essere precaricato;
• metadata: indica che probabilmente l'audio non verrà ascoltato, ma potrebbero essere utili i metadati relativi ad esso;
• auto: lascia al browser la scelta se caricare o no l'audio.

autoplay

Un attributo Boleano; se specificato (anche se con valore false!), l'audio partirà automaticamente il prima possiblie senza fermarsi per caricare i dati.

autobuffer Obsolete since Gecko 2.0

Un attributo Boleano; se specificato, l'audio verrà subito scaricato, anche se non viene impostato l'attributo autoplay, e continuerà finché la cache ad esso destinata non è piena o non ha finito di scaricarsi. Quindi questo attributo dovrebbe essere usato solo se ci si aspetta che l'utente faccia partire l'audio in un secondo momento.

Questo attributo è stato rimosso in Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1), a favore dell'attributo preload.

buffered

Un attributo che si può leggere per sapere quali parti dell'audio sono state scaricate. Questo attributo contiene un oggetto TimeRanges.

controls

Un attributo Boleano; se specificato, il browser offrirà dei controlli per l'audio, inclusi il volume e i pulsanti pausae play.

loop

Un attributo Boolano; se specificato, l'audio ripartirà automaticamente dall'inizio appena terminato.

mozCurrentSampleOffset

The offset, specified as the number of samples since the beginning of the audio stream, at which the audio is currently playing.

muted

Un attributo Boleano che indica se l'audio deve essere inizialmente muto.

played

Un oggetto TimeRanges che indica quali parti dell'audio sono state riprodotte.

preload

Lo scopo di questo attributo è suggerire al browser se caricare subito o no la traccia audio. Può assumere uno dei seguenti valori:

Se non impostato, il valore predefinito è scelto dal browser, ma la specifica suggerisce metadata.

Note:

• L'attributo autoplay ha la precedenza rispetto a questo: se l'audio deve partire subito, il browser deve ovviamente scaricarlo. Comunque è permesso impostare entrambi gli attributi autoplay e preload.
• La specifica non obbliga i browser a seguire il valore di questo attributo; è da considerare solo come un suggerimento.

src

L'URL dell'audio da includere. È opzionale: si può sostituire con gli elementi <source> figli dell'elemento <audio>.

 

Nota: L'URL indicato è soggetto al controllo di origine HTTP.

volume

Il volume della traccia audio, compreso tra 0.0 (silenzioso) e 1.0 (massimo).

Gli intervalli di tempo sono specificati come numeri decimali indicanti il numero di secondi da saltare.

Eventi

Un elemento <audio> diversi eventi.

Esempi

Uso di base

<!-- Un semplice audio -->
<audio src="https://developer.mozilla.org/@api/deki/files/2926/=AudioTest_(1).ogg" autoplay>
  Il tuo browser non supporta l'elemento <code>audio</code>.
</audio>

<!-- Audio con sottotitoli -->
<audio src="foo.ogg">
  <track kind="captions" src="foo.en.vtt" srclang="en" label="English">
  <track kind="captions" src="foo.it.vtt" srclang="it" label="Italiano">
</audio> 

Audio con elementi <source>

<audio controls="controls">
  Il tuo browser non supporta l'elemento <code>audio</code>.
  <source src="foo.wav" type="audio/wav">
</audio>

Specifiche

Compatibilità con i browser

Vedi anche

• Formati supportati dagli elementi <audio> e <video>
• Web Audio API
• HTMLAudioElement
• nsIDOMHTMLMediaElement
• <source>
• <video>
• Using audio and video
• L'elemento audio (specifica HTML5)