このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

HTMLSourceElement

Baseline
広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。

HTMLSourceElement インターフェイスは、(通常の HTMLElement インターフェイスから継承されるもの以外に) <source> 要素を操作するための特別なプロパティとメソッドを提供します。

EventTarget Node Element HTMLElement HTMLSourceElement

インスタンスプロパティ

親である HTMLElement から継承したプロパティがあります。

HTMLSourceElement.height

数値で、HTML の height 属性を反映します。画像リソースの高さを CSS ピクセルで表します。このプロパティは、現在の <source> 要素の親が <picture> 要素である場合にのみ意味を持ちます。

HTMLSourceElement.media

文字列で、HTML の media 属性を反映し、メディアリソースの意図する型が入ります。

HTMLSourceElement.sizes

文字列で、ブレークポイント間の画像の寸法を表します。

HTMLSourceElement.src

文字列で、HTML の src 属性を反映し、メディアリソースの URL を保持します。HTMLSourceElement.src プロパティは、関連する <source> 要素が <video> または <audio> 要素の中に入れ子になっている場合にのみ意味を持ちます。<picture> 要素の中に入れ子になっている場合は意味を持たず、無視されます。

メモ: src プロパティを更新した場合(ほかの兄弟要素も更新した場合を含む)は、更新が完了した時点で親の HTMLMediaElement の load メソッドを呼び出してください。<source> 要素は自動的には再スキャンされないためです。

HTMLSourceElement.srcset

文字列で、HTML の srcset 属性を反映し、カンマ (',', U+002C COMMA) で区切られた画像の候補のリストが入ります。画像の候補は URL の後に 'w' に続いて画像の幅、または 'x' に続いてピクセルの密度を指定します。

HTMLSourceElement.type

文字列で、HTML の type 属性を反映し、メディアリソースの型を保持します。

HTMLSourceElement.width

数値で、HTML の width 属性を反映します。画像リソースの幅を CSS ピクセルで表します。このプロパティは、現在の <source> 要素の親が <picture> 要素である場合にのみ意味を持ちます。

インスタンスメソッド

固有のメソッドはありません。親である HTMLElement から継承したメソッドがあります。

仕様書

仕様書
HTML
# htmlsourceelement

ブラウザーの互換性

関連情報