HTMLSourceElement
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。
HTMLSourceElement インターフェイスは、(通常の HTMLElement インターフェイスから継承されるもの以外に) <source> 要素を操作するための特別なプロパティとメソッドを提供します。
インスタンスプロパティ
親である 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> |
ブラウザーの互換性
関連情報
- このインターフェイスを実装する HTML 要素:
<source> <source>要素を含むことができる要素の HTML DOM API:HTMLVideoElement,HTMLAudioElement,HTMLPictureElement