audio
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Sumário
O elemento audio
é utilizado para embutir conteúdo de som em um documento HTML ou XHTML.O elemento audio
foi adicionado como parte do HTML5.
Você pode utilizar recursos avançados da API de áudio — que são específicas do Gecko — para gerar e manipular diretamente fluxo de áudio a partir do código JavaScript. Veja Introducing the audio API extension para detalhes.
Contexto de Uso
Conteúdo permitido | Transparent content, tanto um atributo src quanto um ou mais elementos <source> , seguidos por um flow content ou phrasing content, sem<video> ou elementos <audio> . |
---|---|
Omissão de tag | Nenhuma, tanto as tags iniciais quanto as finais devem estar presentes. |
Elementos pai permitidos | Qualquer elemento que aceite flow content, ou qualquer elemento que aceite phrasing content. |
Documento normativo | HTML5, section 4.8.7 |
Atributos
Como todos os elementos HTML, este elemento suporta os global attributes.
autoplay
-
Um atributo Booleano; se especificado (mesmo se o valor for "false"!), o áudio iniciará automaticamente assim que possível sem parar de carregar os dados.
autobuffer
-
Um atributo Booleano; se especificado, o audio será baixado automaticamente, mesmo se não está configurado para reprodução automática. Isto continua até que o cache de mídia esteja cheio, ou até que o o arquivo de áudio completo tenha sido baixado, o que vier primeiro. Isto deve ser utilizado apenas quando é esperado que o usuário escolherá tocar o áudio; por exemplo, se o usuário navegou para a página utilizando um link "Reproduzir". Este atributo foi removido no Gecko 2.0 em razão do atributo
preload
. buffered
-
Um atributo que pode ser lido para determinar os intervalos do áudio que já foram carregados. Este atributo contém um objeto
TimeRanges
. controls
-
Se esse atributo estiver presente, o navegador oferecerá controles para permitir ao usuário controlar a reprodução do áudio, incluindo volume, navegação, e pausa/continuação da reprodução.
loop
-
Um atributo Booleano; se especificado, ao chegar no fim do áudio, ele voltará automaticamente para o começo.
mozCurrentSampleOffset
Non-standard-
The offset, specified as the number of samples since the beginning of the audio stream, at which the audio is currently playing.
muted
-
Um atributo Booleano que indica se o áudio será inicializado silenciado.
played
-
Um objeto
TimeRanges
indicando que todo o áudio foi reproduzido. preload
-
Esse atributo enumerado pretende dar uma sugestão ao navegador sobre o que o autor pensa que proporcionará uma melhor experiência do usuário. Ele pode ter os seguintes valores:
- none: indica que o usuário não necessitará consultar o áudio ou que o servidor quer minimizar seu tráfego; em outros termos indica que o áudio não deve ser pré-carregado;
- metadata: indica que embora o usuário não necessitará consultar o áudio, pegar os meta-dados (ex: comprimento) é interessante;
- auto: indica que o usuário necessita ter prioridade; em outros termos isso significa que, se necessário, o áudio inteiro pode ser baixado, mesmo que não seja esperado a execução;
- Uma string vazia: é um sinônimo do valor auto.
Se não definido, seu valor padrão será definido pelo navegador (isto é, cada navegador pode escolher seu valor padrão), embora a especificação recomenda que seja definido para o metadata.
Note: Notas de uso:- O atributo
autoplay
tem precedência sobre opreload
, pois se é necessário executar o áudio automaticamente, o navegador obviamente o baixará. Definindo ambosautoplay
epreload
é permitido pela especificação.- O navegador não é forçado pela especifição a seguir o valor desse atributo; é apenas uma sugestão.
src
-
A URL do áudio a ser incorporado. Isso é sujeito a HTTP access controls. Isto é opcional; ao invés disso você pode usar o elemento
<source>
dentro do bloco do áudio para especificar o vídeo a ser incorporado .
O tempo de compensação (time offset) entre o áudio e o vídeo está especificado como um valor de ponto flutuante (float) representando o número de segundos da compensação.
Nota: A definição de valor de tempo de compensação ainda não foi completada na especificação do HTML 5 e está sujeita a mudança.
Examples
<!-- Reprodução simples de áudio -->
<audio src="AudioTest.ogg" autoplay>
<a href="AudioTest.ogg" download="AudioTest.ogg">Baixar áudio OGG</a>.
</audio>
<!-- Reprodução de áudio com legendas -->
<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>
Reproduz o arquivo de áudio anexado a esse artigo.
Interface do DOM
Compatibilidade com navegadores
BCD tables only load in the browser