source

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.

* Some parts of this feature may have varying levels of support.

Sumário

O elemento source é utilizado para especificar múltiplos recursos de mídia de elementos <picture>, <audio> ou <video> em HTML5. É um elemento vazio. É normalmente usado para disponibilizar multiple 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 os global attributes.

src

Requerido, endereço do arquivo de mídia.

type

O tipo MIME do arquivo, opcionalmente com um parametro de codecs. Veja o RFC 4281 para informações sobre como especificar codec.

media

Definição do tipo de mídia (Media query) pretendido.

Se o atributo type 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óximo source é verificado. Se o atributo type 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 elemento source é verificado.

Interface do DOM

Esse elemento implementa a interface HTMLSourceElement.

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 elementos audio ou video 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 de error será lançado e os controles padrões de mídia (se ativados) indicarão o erro. Veja também a lista de media formats supported by the audio and video elements em vários navegadores.

html
<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, veja Using audio and video in Firefox.

Compatibilidade com navegadores

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
source
height
media
sizes
src
srcset
type
width

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
See implementation notes.
Has more compatibility info.