source

  • Revision slug: HTML/Element/Source
  • Revision title: source
  • Revision id: 292963
  • Criado:
  • Criador: LeonardoPacheco
  • É a revisão atual? Não
  • Comentar

Conteúdo da revisão

Sumário

O elemento source é utilizado para especificar múltiplos recursos de mídia de elementos audio e 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 {{ HTMLElement("audio") }}, {{ HTMLElement("video") }}
Documento normativo HTML5, section 4.8.8

Atributos

Como todos os outros elementos de HTML, esse elemento suporta os global attributes.

{{ htmlattrdef("src") }}
Requerido, endereço do arquivo de mídia.
{{ htmlattrdef("type") }}
O tipo MIME do arquivo, opcionalmente com um parametro de codecs. Veja o RFC 4281 para informações sobre como especificar codec.
{{ htmlattrdef("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.

<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 dos Navegadores

{{ CompatibilityTable() }}

Recurso Chrome Firefox (Gecko) Internet Explorer Opera Safari
Suporte Básico {{ CompatVersionUnknown() }} {{ CompatGeckoDesktop("1.9.1") }} 9.0 {{ CompatVersionUnknown() }} {{ CompatVersionUnknown() }}
Atributo media {{ CompatVersionUnknown() }} {{ CompatGeckoDesktop("15.0") }} {{ CompatUnknown() }} {{ CompatVersionUnknown() }} {{ CompatVersionUnknown() }}
Recurso Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Suporte básico {{ CompatVersionUnknown() }} {{ CompatGeckoMobile("1.0") }} {{ CompatUnknown() }} {{ CompatUnknown() }} {{ CompatUnknown() }}
Atributo media {{ CompatVersionUnknown() }} {{ CompatGeckoMobile("15.0") }} {{ CompatUnknown() }} {{ CompatUnknown() }} {{ CompatUnknown() }}

Notas específicas do Gecko

Atualmente, apenas um pequeno conjunto de funcionalidades está implementado — o Gecko escolhe o primeiro elemento source que tem um tipo correspondente the MIME-type of a supported media format; veja o {{ bug(449363) }} para detalhes.

{{ languages({ "en":"en/HTML/Element/source", "ja":"ja/HTML/Element/source" }) }}

Fonte da revisão

<h2 id="Summary">Sumário</h2>
<p>O elemento <code>source</code> é utilizado para especificar múltiplos recursos de mídia de elementos <code> audio</code> e <code>video</code> em HTML5. É um elemento vazio. É normalmente usado para disponibilizar <a href="/En/Media_formats_supported_by_the_audio_and_video_elements" title="En/Media formats supported by the audio and video elements">multiple formats supported by different browsers</a>.</p>
<h2 id="Usage_Context">Contexto de uso</h2>
<table class="standard-table">
  <tbody>
    <tr>
      <td>Conteúdo permitido</td>
      <td>Nenhum; isso é um elemento vazio.</td>
    </tr>
    <tr>
      <td>Omissão de tag</td>
      <td>Deve ter uma tag de início, mas não deve ter uma tag de fim.</td>
    </tr>
    <tr>
      <td>Elementos pais permitidos</td>
      <td>{{ HTMLElement("audio") }}, {{ HTMLElement("video") }}</td>
    </tr>
    <tr>
      <td>Documento normativo</td>
      <td><a class="external" href="http://www.w3.org/TR/html5/video.html#the-source-element" title="http://www.w3.org/TR/html5/video.html#the-source-element">HTML5, section 4.8.8</a></td>
    </tr>
  </tbody>
</table>
<h2 id="Attributes">Atributos</h2>
<p>Como todos os outros elementos de HTML, esse elemento suporta os <a href="/en/HTML/Global_attributes" title="en/HTML/Global attributes">global attributes</a>.</p>
<dl>
  <dt>
    {{ htmlattrdef("src") }}</dt>
  <dd>
    Requerido, endereço do arquivo de mídia.</dd>
  <dt>
    {{ htmlattrdef("type") }}</dt>
  <dd>
    O tipo MIME do arquivo, opcionalmente com um parametro de <code>codecs</code>. Veja o <a class="external" href="http://www.rfc-editor.org/rfc/rfc4281.txt" title="http://www.rfc-editor.org/rfc/rfc4281.txt">RFC 4281</a> para informações sobre como especificar codec.</dd>
  <dt>
    {{ htmlattrdef("media") }}</dt>
  <dd>
    Definição do tipo de mídia (<a class="internal" href="/en/CSS/Media_queries" title="En/CSS/Media queries">Media query</a>) pretendido.</dd>
</dl>
<p>Se o atributo <strong>type</strong> 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 <strong>source</strong> é verificado. Se o atributo <strong>type</strong> 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 <strong>source</strong> é verificado.</p>
<h2 id="DOM.C2.A0Interface">Interface do DOM</h2>
<p>Esse elemento implementa a interface <code><a href="/en/DOM/HTMLSourceElement" title="en/DOM/HTMLSourceElement">HTMLSourceElement</a></code>.</p>
<h2 id="Examples">Exemplos</h2>
<p>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 <code> audio</code> ou <code>video</code> 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 <code>error</code> será lançado e os controles padrões de mídia (se ativados) indicarão o erro. Veja também a lista de <a href="/En/Media_formats_supported_by_the_audio_and_video_elements" title="En/Media formats supported by the audio and video elements">media formats supported by the audio and video elements</a> em vários navegadores.</p>
<pre class="brush: html">
&lt;video controls&gt;
  &lt;source src="foo.ogg" type="video/ogg"&gt; &lt;!-- Escolhido pelo Firefox --&gt;
  &lt;source src="foo.mov" type="video/quicktime"&gt; &lt;!-- Escolhido pelo Safari --&gt;
&nbsp; Desculpa; seu navegador não é compatível com vídeo em HTML5.
&lt;/video&gt;
</pre>
<p>Para mais exemplos, veja <a class="internal" href="/en/Using_HTML5_audio_and_video" title="En/Using audio and video in Firefox">Using audio and video in Firefox</a>.</p>
<h2 id="Browser_compatibility">Compatibilidade dos Navegadores</h2>
<p>{{ CompatibilityTable() }}</p>
<div id="compat-desktop">
  <table class="compat-table">
    <tbody>
      <tr>
        <th>Recurso</th>
        <th>Chrome</th>
        <th>Firefox (Gecko)</th>
        <th>Internet Explorer</th>
        <th>Opera</th>
        <th>Safari</th>
      </tr>
      <tr>
        <td>Suporte Básico</td>
        <td>{{ CompatVersionUnknown() }}</td>
        <td>{{ CompatGeckoDesktop("1.9.1") }}</td>
        <td>9.0</td>
        <td>{{ CompatVersionUnknown() }}</td>
        <td>{{ CompatVersionUnknown() }}</td>
      </tr>
      <tr>
        <td>Atributo <code>media</code></td>
        <td>{{ CompatVersionUnknown() }}</td>
        <td>{{ CompatGeckoDesktop("15.0") }}</td>
        <td>{{ CompatUnknown() }}</td>
        <td>{{ CompatVersionUnknown() }}</td>
        <td>{{ CompatVersionUnknown() }}</td>
      </tr>
    </tbody>
  </table>
</div>
<div id="compat-mobile">
  <table class="compat-table">
    <tbody>
      <tr>
        <th>Recurso</th>
        <th>Android</th>
        <th>Firefox Mobile (Gecko)</th>
        <th>IE Mobile</th>
        <th>Opera Mobile</th>
        <th>Safari Mobile</th>
      </tr>
      <tr>
        <td>Suporte básico</td>
        <td>{{ CompatVersionUnknown() }}</td>
        <td>{{ CompatGeckoMobile("1.0") }}</td>
        <td>{{ CompatUnknown() }}</td>
        <td>{{ CompatUnknown() }}</td>
        <td>{{ CompatUnknown() }}</td>
      </tr>
      <tr>
        <td>Atributo <code>media</code></td>
        <td>{{ CompatVersionUnknown() }}</td>
        <td>{{ CompatGeckoMobile("15.0") }}</td>
        <td>{{ CompatUnknown() }}</td>
        <td>{{ CompatUnknown() }}</td>
        <td>{{ CompatUnknown() }}</td>
      </tr>
    </tbody>
  </table>
</div>
<h3 id="Gecko-specific_notes">Notas específicas do Gecko</h3>
<p>Atualmente, apenas um pequeno conjunto de funcionalidades está implementado — o Gecko escolhe o primeiro elemento source que tem um tipo correspondente <a href="/En/Media_formats_supported_by_the_audio_and_video_elements" title="En/Media formats supported by the audio and video elements">the MIME-type of a supported media format</a>; veja o {{ bug(449363) }} para detalhes.</p>
<div class="noinclude">
  {{ languages({ "en":"en/HTML/Element/source", "ja":"ja/HTML/Element/source" }) }}</div>
Reverter para esta revisão