HTML <source> メディアまたは画像のソース要素

試してみましょう

<video controls width="250" height="200" muted>
  <source src="/shared-assets/videos/flower.webm" type="video/webm" />
  <source src="/shared-assets/videos/flower.mp4" type="video/mp4" />
  Download the
  <a href="/shared-assets/videos/flower.webm">WEBM</a>
  or
  <a href="/shared-assets/videos/flower.mp4">MP4</a>
  video.
</video>

属性

この要素はすべてのグローバル属性をサポートし、加えて下記の属性を使うことができます。

type

画像の MIME メディア型またはその他のメディア型で、オプションで codecs 引数を伴います。

src

メディアのリソースの URL です。この source 要素の親が <audio> および <video> 要素の場合は必須ですが、source 要素の親が <picture> 要素である場合は指定できません。

srcset

1つ以上の画像のURLと記述子をカンマで区切ったリストです。この source 要素の親が <picture> 要素である場合は必須ですが、source 要素の親が <audio> または <video> 要素の場合は指定できません。

文字列をカンマ区切りで並べたリストであり、ブラウザーが使用できる画像のセットを示します。それぞれの文字列の構成は以下のとおりです。

1. 画像を指定する 1 つの URL
2. 幅記述子。これは正の整数に "w" を付加した文字列で、例えば 300w のようになります。
3. 画素密度記述子。これは直後に "x" を付加した正の浮動小数点数で、例えば 2x のようになります。

有効であるためには、リスト内の各文字列は、少なくとも幅記述子またはピクセル密度記述子を持たなければなりません。2 種類の記述子が混在してはならず、リスト全体で一貫して一方のみを使用しなければなりません。リストの中で、各記述子の値は固有でなければなりません。ブラウザーは記述子を基に、指定された時点で表示するために最も適切な画像を選びます。記述子が存在しない場合のデフォルト値は 1x です。sizes 属性が存在する場合は、各文字列に対して幅の記述子を指定しなければなりません。ブラウザーが srcset に対応していない場合は、src がデフォルト値として使用されます。

sizes

ソースの寸法のリストで、そのソースが表す画像が最終的に表示される幅を表します。この <source> 要素の親が <picture> 要素である場合は指定可能ですが、親が <audio> または <video> 要素の場合は指定できません。

リストはそれぞれのソースのサイズをカンマ区切りで並べたものです。サイズは、条件と長さの組です。この情報は srcset で指定されたどの画像を使用するかを決めるため、ページのレイアウトを行う前にブラウザーが使用します。なお、 sizes は srcset でピクセル倍率ではなく幅指定子が提供された時（例えば 2x ではなく 200w の場合）のみ、効果があることに注意してください。

media

リソースの志向するメディアのメディアクエリーです。

height

画像の本来の高さをピクセル単位で指定します。この source 要素の親が <picture> 要素である場合は指定可能ですが、source 要素の親が <audio> または <video> 要素の場合は指定できません。

単位のない整数でなければなりません。

width

画像の本来の幅をピクセル単位で指定します。この source 要素の親が <picture> 要素である場合は指定可能ですが、source 要素の親が <audio> または <video> 要素の場合は指定できません。

単位のない整数でなければなりません。

使用上のメモ

<source> 要素は空要素です。すなわち内容がないだけでなく、終了タグもありません。すなわち、 </source> は HTML の中で決して使われません。

ブラウザーは <source> 要素のリストをたどり、サポートする形式を探します。最初に見つかった表示可能なのものを使います。それぞれの <source> 要素で、

• type 属性が指定されていない場合は、サーバーからメディア形式を取得して、表示可能なものかを確認します。表示できない場合は、次の <source> をチェックします。
• type 属性が指定された場合、表示できる形式と比較します。扱えないものであれば、サーバーへのクエリーをスキップし、次の <source> 要素をチェックします。

提供されたすべての <source> を調べても使用する適切な画像が見つからなかった場合、

• <picture> 要素で用いた場合は、<picture> 要素の子の <img> で指定した画像を代わりに使用します。
• <audio> または <video>要素で用いた場合は、代わりにブラウザーは開始タグと終了タグの間にある内容を表示します。

ウェブブラウザーが対応している画像形式の詳細と、使用する適切な形式を選択するためのガイダンスについては、ウェブ上で使用する画像ファイルの種類と画像のガイドを参照してください。使用できる動画・音声メディアの種類については、ウェブ上で使用するメディアの種類と形式のガイドを参照してください。

例

<video> で type 属性を使う例

次の例は、 異なる形式で動画を提供する記述方法です。Webm 形式をサポートするブラウザーと、Ogg 形式に対応した環境と QuickTime 動画形式を再生可能なブラウザーを想定した記述例です。<audio> 要素や <video> 要素に対応していない場合、代わりに通知が表示されます。ブラウザーがその要素に対応しているものの、指定された形式のいずれも対応していない場合、 error イベントが <audio> または <video> 要素で発生し、デフォルトのメディアコントロール（有効になっている場合）がエラーを示します。使用できるメディアファイル形式や、ブラウザーが対応しているメディアファイル形式の詳細については、ウェブ上のメディアの種類と形式についてのガイドを参照してください。

<video controls>
  <source src="foo.webm" type="video/webm" />
  <source src="foo.ogg" type="video/ogg" />
  <source src="foo.mov" type="video/quicktime" />
  ごめんなさい。このブラウザーは HTML video に対応していません。
</video>

<video> で media 属性を使う例

こので例は、上のビューポートである幅に合わせた代わりのソースを提供する方法を示します。ユーザーのブラウザー環境が指定された media 条件に合致するとき、関連付けられた <source> 要素が選ばれます。その src 属性の内容が要求され、表示されます。もし media 条件に合うものがなければ、ブラウザーはリストの次の <source> に進みます。下のコードの 2 つめの <source> は media 条件の指定がなく、1 番めの条件以外のすべての場合に選択されます。

<video controls>
  <source src="foo-large.webm" media="(width >= 800px)" />
  <source src="foo.webm" />
  ごめんなさい。このブラウザーは HTML video に対応していません。
</video>

その他の例については、学習エリアの記事動画と音声のコンテンツにすばらしいリソースがあります。

<picture> で media 属性を使う例

この例では、2 つの <source> 要素が <picture> 内に含まれており、利用可能な空間の大きさがある幅を超えた時に使用する画像のバージョンを提供します。利用可能な幅がこれらの幅よりも小さい場合、ユーザーエージェントは <img> 要素で指定された代替画像を表示します。

<picture>
  <source srcset="mdn-logo-wide.png" media="(width >= 800px)" />
  <source srcset="mdn-logo-medium.png" media="(width >= 600px)" />
  <img src="mdn-logo-narrow.png" alt="MDN Web Docs" />
</picture>

<picture> 要素では、常に一つの <img> 要素をフォールバック画像として、 alt 属性をアクセシビリティのためにつける必要があります。 (画像が内容に関連のない純粋に装飾的な画像でない限り)。

<picture> で height および width 属性を使う例

この例では、height と width 属性を持つ 3 つの<source>要素が、<picture> 要素に含まれています。 メディアクエリーにより、ビューポートの寸法に基づいて、height および width 属性により表示すべき画像をブラウザーに選択させます。

<picture>
  <source
    srcset="landscape.png"
    media="(width >= 1000px)"
    width="1000"
    height="400" />
  <source
    srcset="square.png"
    media="(width >= 800px)"
    width="800"
    height="800" />
  <source
    srcset="portrait.png"
    media="(width >= 600px)"
    width="600"
    height="800" />
  <img
    src="fallback.png"
    alt="ブラウザーがソース画像に対応していない場合に使用される画像"
    width="500"
    height="400" />
</picture>

技術的概要

仕様書

ブラウザーの互換性

関連情報

• <audio> 要素
• <picture> 要素
• <video> 要素
• 画像ファイルの種類と形式ガイド
• ウェブ上のメディアの種類と形式のガイド
• ウェブパフォーマンス