--- title: slug: Web/HTML/Element/audio tags: - Element - HTML - HTML contingut inserit - HTML5 - Media - Multimedia - Referencia - Web translation_of: Web/HTML/Element/audio --- Sumari L'element HTML <àudio> s'utilitza per inserir contingut de so en els documents. Pot contenir una o més fonts d'àudio, representat mitjançant l'atribut src o l'element {{HTMLElement("source")}} el navegador va a triar el més adequat. El contingut alternatiu per als navegadors que no suporten l'element <àudio> es pot també afegir, dins de l'obertura i tancament de les etiquetes <audio></audio>. La funcionalitat de reproducció més bàsica pot posar-se a disposició mitjançant l'atribut controls (vegeu més endavant); per a un ús més avançat, la reproducció d'àudio i els controls poden ser manipulats mitjançant l'HTML Media API, i més específicament les característiques definides a la interfície {{domxref("HTMLAudioElement")}}. També pot utilitzar la Web Audio API per generar i manipular directament els fluxos d'àudio des de codi JavaScript. Veure Web Audio API per a més detalls. Context d'us Contingut permès: Si l'element té un atribut {{htmlattrxref("src", "audio")}}: amb zero o més elements {{HTMLElement("track")}}, seguits pel contingut transparent que no conté elements multmèdia - és a dir, sense elements {{HTMLElement("audio")}} o {{HTMLElement("video")}}. O bé: amb zero o més elements {{HTMLElement("source")}}, seguit de zero o més elements {{HTMLElement("track")}}, seguit pel contingut transparent que no conté elements multimedia,és a dir, sense elements {{HTMLElement("audio")}} o {{HTMLElement("video")}}. Categories de contingut Contingut de Flux, phrasing content, contingut incrustat. Si té un atribut {{htmlattrxref("controls", "audio")}}: contingut interactiu i contingut palpable. Contingut permès Si l'element té un atribut {{htmlattrxref("src", "audio")}}: zero o més elements {{HTMLElement("track")}} seguit de contingut transparent que no conté elements mèdia, que no és {{HTMLElement("audio")}} o {{HTMLElement("video")}} O bé: zero o més elements {{HTMLElement("source")}}, seguit de zero o més elements {{HTMLElement("track")}}, seguit de contingut transparent que no conté elements mèdia, és a dir sense {{HTMLElement("audio")}} o {{HTMLElement("video")}}. Omissió de l'etiqueta {{no_tag_omission}} Elements pares permesos Qualsevol element que accepti contingut incrustat . Interfície DOM {{domxref("HTMLAudioElement")}} Atributs Aquest element inclou els gatributs globals. {{htmlattrdef("autoplay")}} Atribut Booleà; si s'especifica (fins i tot si el valor és "fals"!), l'àudio iniciarà automàticament la reproducció tan aviat com pugui fer-ho, sense esperar que l'arxiu d'àudio complet s'hagi acabat de descarregar. {{htmlattrdef("autobuffer")}} {{obsolete_inline("2.0")}} Atribut booleà; si s'especifica, s'iniciarà automàticament la descàrrega del àudio, fins i tot si no s'ha establert la reproducció automàtica. Això continua fins que la memòria cau multimèdia està plena, o tot l'arxiu d'àudio s'hagi descarregat, el que passi primer. Això només s'ha d'utilitzar quan s'espera que l'usuari esculli per reproduir l'àudio; per exemple, si l'usuari ha navegat a una pàgina mitjançant un enllaç "Reproduir aquest àudio". Aquest atribut es va eliminar al Gecko 2.0 {{geckoRelease ("2,0")}} en favor de l'atribut preload {{htmlattrdef("buffered")}} Un atribut que pot llegir per a veure els intervals de temps del media que han estat emmagatzemades en el buffer. Aquest atribut conté un objecte {{domxref("TimeRanges")}}. {{htmlattrdef("controls")}} Si aquest atribut és present, el navegador ofereix controls per permetre a l'usuari controlar la reproducció d'àudio, incloent el volum, recerca i pausa/reprendre la reproducció. {{htmlattrdef("loop")}} Atribut booleà; si s'especifica, buscarà automàticament de nou al començament en arribar al final de l'àudio. {{htmlattrdef("mozCurrentSampleOffset")}} {{gecko_minversion_inline("2.0")}} {{non-standard_inline}} El desplaçament, especificat com el nombre de mostres des del començament de la seqüència d'àudio, en el qual l'àudio s'està reproduint. {{htmlattrdef("muted")}} Atribut booleà que indica si l'àudio serà silenciat inicialment. El seu valor per defecte és fals. {{htmlattrdef("played")}} Un objecte {{domxref("TimeRanges")}} indicant totes les gammes d'àudio que s'han reproduït. {{htmlattrdef("preload")}} Aquest atribut enumerat està destinat a proporcionar un suggeriment al navegador sobre el que l'autor pensa en que el pot conduir a una millor experiència d'usuari. Pot tenir un dels següents valors: none: indica que l'àudio no ha de ser precarregat; metadata: indica que unicament es recupera les metadata d'àudio (per exemple, longitud); auto: indica que el fitxer d'àudio podria ser descarregat sencer, encara que no s'espera que l'usuari ho utilitzi; la cadena buida: sinònim del valor auto. Si no s'estableix el valor predeterminat és definit pel propi navegador (és a dir, cada navegador pot tenir el seu propi valor per omissió). L'especificació informa que s'estableixi en les metadata. Notes d'ús: L'atribut autoplay té prioritat sobre l'atribut preload.Si s'especifica autoplay, el navegador hauria de començar, òbviament, a descarregar l'àudio per a la seva reproducció. El navegador no és forçat per l'especificació a seguir el valor d'aquest atribut; és un mer suggeriment. {{htmlattrdef("src")}} La direcció URL de l'àudio a inserir. Està subjecte als controls d'access HTTP. És opcional; en el seu lloc podeu utilitzar el element {{htmlelement("source")}} dins del bloc d'àudio per especificar l'àudio a encastar. {{htmlattrdef("volume")}} El volum de reproducció, va del rang 0.0 (silenci) a 1.0 (el més alt). Els desplaçaments de temps s'especifiquen com a valors de coma flotant que indica el nombre de segons per compensar. Note: El valor de definició de desplaçament del temps encara no s'ha completat en l'especificació HTML5 i està subjecte a canvis. Events Un element audio pot disparar diversos events. Exemples Us bàsic <!-- Simple audio playback --> <audio src="http://developer.mozilla.org/@api/deki/files/2926/=AudioTest_(1).ogg" autoplay> Your browser does not support the <code>audio</code> element. </audio> <!-- Audio playback with captions --> <audio src="foo.ogg"> <track kind="captions" src="foo.en.vtt" srclang="en" label="English"> <track kind="captions" src="foo.sv.vtt" srclang="sv" label="Svenska"> </audio> Element audio amb l'element source <audio controls="controls"> Your browser does not support the <code>audio</code> element. <source src="foo.wav" type="audio/wav"> </audio> Especificacions Especificació Estat Comentari {{SpecName('HTML WHATWG', 'the-video-element.html#the-audio-element', '<audio>')}} {{Spec2('HTML WHATWG')}} {{SpecName('HTML5 W3C', 'embedded-content-0.html#the-audio-element', '<audio>')}} {{Spec2('HTML5 W3C')}} Navegadors compatibles {{CompatibilityTable}} Característica Chrome Firefox (Gecko) Internet Explorer Opera Safari Basic support 3.0 {{CompatGeckoDesktop("1.9.1")}} [1] 9.0 10.5 3.1 atribut autoplay 3.0 {{CompatGeckoDesktop("1.9.1")}} 9.0 10.5 3.1 atribut buffered {{CompatUnknown}} {{CompatGeckoDesktop("2.0")}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} atribut controls 3.0 {{CompatGeckoDesktop("1.9.1")}} 9.0 10.5 3.1 atribut loop 3.0 {{CompatGeckoDesktop("11.0")}} 9.0 10.5 3.1 atribut muted {{CompatUnknown}} {{CompatGeckoDesktop("11.0")}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} propietat played {{CompatUnknown}} {{CompatGeckoDesktop("15.0")}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} atribut preload 3.0 {{CompatGeckoDesktop("2.0")}} 9.0 {{CompatVersionUnknown}} [2] 3.1 atribut src 3.0 {{CompatGeckoDesktop("1.9.1")}} 9.0 10.5 3.1 atribut volume Característica Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile Suport bàsic {{CompatUnknown}} {{CompatGeckoMobile("1.0")}} [1] {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} atribut autoplay {{CompatUnknown}} {{CompatGeckoMobile("1.0")}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} atribut buffered {{CompatUnknown}} {{CompatGeckoMobile("2.0")}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} atribut controls {{CompatUnknown}} {{CompatGeckoMobile("1.0")}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} atribut loop {{CompatUnknown}} {{CompatGeckoMobile("11.0")}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} atribut muted {{CompatUnknown}} {{CompatGeckoMobile("11.0")}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} propietat played {{CompatUnknown}} {{CompatGeckoMobile("15.0")}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} atribut preload {{CompatUnknown}} {{CompatGeckoMobile("2.0")}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} atribut src {{CompatUnknown}} {{CompatGeckoMobile("1.0")}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} atribut volume [1] Per Gecko, per reproduir l'àudio, el servidor ha de servir l'arxiu amb el tipus MIME correcte. [2] Suportat sota el antic nom autobuffer Veure Formats media suportats pels elements audio i video Web Audio API {{domxref("HTMLAudioElement")}} nsIDOMHTMLMediaElement {{htmlelement("source")}} {{htmlelement("video")}} L'ús d'àudio i vídeo El element audio (HTML5 specification) {{HTMLRef}}
L'element HTML <àudio> s'utilitza per inserir contingut de so en els documents. Pot contenir una o més fonts d'àudio, representat mitjançant l'atribut src o l'element {{HTMLElement("source")}} el navegador va a triar el més adequat.
El contingut alternatiu per als navegadors que no suporten l'element <àudio> es pot també afegir, dins de l'obertura i tancament de les etiquetes <audio></audio>.
<audio></audio>
La funcionalitat de reproducció més bàsica pot posar-se a disposició mitjançant l'atribut controls (vegeu més endavant); per a un ús més avançat, la reproducció d'àudio i els controls poden ser manipulats mitjançant l'HTML Media API, i més específicament les característiques definides a la interfície {{domxref("HTMLAudioElement")}}.
També pot utilitzar la Web Audio API per generar i manipular directament els fluxos d'àudio des de codi JavaScript. Veure Web Audio API per a més detalls.
Aquest element inclou els gatributs globals.
none
metadata
auto
Si no s'estableix el valor predeterminat és definit pel propi navegador (és a dir, cada navegador pot tenir el seu propi valor per omissió). L'especificació informa que s'estableixi en les metadata.
autoplay
preload.
Els desplaçaments de temps s'especifiquen com a valors de coma flotant que indica el nombre de segons per compensar.
Un element audio pot disparar diversos events.
<!-- Simple audio playback --> <audio src="http://developer.mozilla.org/@api/deki/files/2926/=AudioTest_(1).ogg" autoplay> Your browser does not support the <code>audio</code> element. </audio> <!-- Audio playback with captions --> <audio src="foo.ogg"> <track kind="captions" src="foo.en.vtt" srclang="en" label="English"> <track kind="captions" src="foo.sv.vtt" srclang="sv" label="Svenska"> </audio>
<audio controls="controls"> Your browser does not support the <code>audio</code> element. <source src="foo.wav" type="audio/wav"> </audio>
buffered
controls
loop
muted
propietat played
preload
src
volume
[1] Per Gecko, per reproduir l'àudio, el servidor ha de servir l'arxiu amb el tipus MIME correcte.
[2] Suportat sota el antic nom autobuffer
autobuffer
nsIDOMHTMLMediaElement
audio
{{HTMLRef}}