<audio>

di 1 collaboratore:

Introduced in HTML5

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.

Nota: La definizione dei valori degli intervalli di tempo non è ancora completa nella specifica HTML5 e potrebbe cambiare.

Eventi

Un elemento <audio> diversi eventi.

Esempi

Uso di base

<!-- Un semplice audio -->
<audio src="http://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

Specifica Stato Commenti
WHATWG HTML Living Standard
The definition of '<audio>' in that specification.
Living Standard  
HTML5
The definition of '<audio>' in that specification.
Recommendation  

Compatibilità con i browser

Funzionalità Chrome Firefox (Gecko) Internet Explorer Opera Safari
Supporto di base 3.0 3.5 (1.9.1) 9.0 10.5 3.1
attributo autoplay 3.0 3.5 (1.9.1) 9.0 10.5 3.1
attributo buffered ? 4.0 (2.0) ? ? ?
attributo controls 3.0 3.5 (1.9.1) 9.0 10.5 3.1
attributo loop 3.0 11.0 (11.0) 9.0 10.5 3.1
attributo muted ? 11.0 (11.0) ? ? ?
proprietà played ? 15.0 (15.0) ? ? ?
attributo preload 3.0 4.0 (2.0) 9.0 Supported under the older name autobuffer 3.1
attributo src 3.0 3.5 (1.9.1) 9.0 10.5 3.1
attributo volume          
Funzionalità Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Supporto di base ? 1.0 (1.0) ? ? ?
attributo autoplay ? 1.0 (1.0) ? ? ?
attributo buffered ? 4.0 (2.0) ? ? ?
attributo controls ? 1.0 (1.0) ? ? ?
attributo loop ? 11.0 (11.0) ? ? ?
attributo muted ? 11.0 (11.0) ? ? ?
proprietà played ? 15.0 (15.0) ? ? ?
attributo preload ? 4.0 (2.0) ? ? ?
attributo src ? 1.0 (1.0) ? ? ?
attributo volume          
Nota: Geko riproduce gli audio solo se il server li serve usando il corretto tipo MIME.

Vedi anche

Etichette del documento e nomi di chi ha collaborato alla sua stesura

Contributors to this page: nicolo-ribaudo
Ultima modifica di: nicolo-ribaudo,