Esta página foi traduzida do inglês pela comunidade.Saiba mais e junte-se à comunidade MDN Web Docs.
source
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since julho de 2015.
Sumário
O elementosource é utilizado para especificar múltiplos recursos de mídia de elementos<picture>,<audio> ou<video> em HTML5. É um elemento vazio. É normalmente usado para disponibilizarmultiple formats supported by different browsers.
Contexto de uso
| Conteúdo permitido | Nenhum; isso é um elemento vazio. |
|---|---|
| Omissão de tag | Deve ter uma tag de início, mas não deve ter uma tag de fim. |
| Elementos pais permitidos | <picture>,<audio>,<video> |
| Documento normativo | HTML5, section 4.8.8 |
Atributos
Como todos os outros elementos de HTML, esse elemento suporta osglobal attributes.
srcRequerido, endereço do arquivo de mídia.
typeO tipo MIME do arquivo, opcionalmente com um parametro de
codecs. Veja oRFC 4281 para informações sobre como especificar codec.mediaDefinição do tipo de mídia (Media query) pretendido.
Se o atributotype não está especificado, o tipo da mídia é obtido no servidor e é verificado se o Gecko consegue reproduzi-lo; se não for possível reproduzi-lo, o próximosource é verificado. Se o atributotype está definido, ele é comparado aos tipos que o Gecko consegue reproduzir, e se não for reconhecido, o servido não é solicitado; ao invés disso, o próximo elementosource é verificado.
Interface do DOM
Esse elemento implementa a interfaceHTMLSourceElement.
Exemplos
Esse exemplo demonstra como oferecer um vídeo no formato Ogg para usuários em que os navegadores suporta o formato Ogg, e um formato QuickTime para os usuários que o suporta. Se os elementosaudio ouvideo não forem suportados pelo navegador, um aviso será mostrado. Se o navegador suportar o elemento, mas não suportar nenhum dos formatos especificados, um evento deerror será lançado e os controles padrões de mídia (se ativados) indicarão o erro. Veja também a lista demedia formats supported by the audio and video elements em vários navegadores.
<video controls> <source src="foo.ogg" type="video/ogg" /> <!-- Escolhido pelo Firefox --> <source src="foo.mov" type="video/quicktime" /> <!-- Escolhido pelo Safari --> Desculpa; seu navegador não é compatível com vídeo em HTML5.</video>Para mais exemplos, vejaUsing audio and video in Firefox.