HTMLSourceElement - 操作 <source> 元素
HTMLSourceElement
接口提供了特殊的属性(除了通过继承通用的 HTMLElement
接口获得的常规属性)来操作 <source>
元素。
属性
属性继承自父类 HTMLElement
。
HTMLSourceElement.keySystem
一个 DOMString
,描述加密流的关键系统。
HTMLSourceElement.media
一个 DOMString
,反映了 media
HTML 属性,包含媒体资源的预期类型。
HTMLSourceElement.sizes
一个 DOMString
,代表断点之间的图像大小。
HTMLSourceElement.src
一个 DOMString
,反映了 src
HTML 属性,其中包含媒体资源的 URL
HTMLSourceElement.src
属性仅当关联的 <source>
元素嵌套在媒体元素 <video>
或 <audio>
中时才有意义。当它嵌套在 <picture>
元素中时没有意义,并且被忽略。
注意:如果更新了
src
属性(任何兄弟节点中),应该在更新后调用父节点HTMLMediaElement
的load
方法,因为<source>
元素的更新不会自动重新扫描到。
HTMLSourceElement.srcset
一个 DOMString
,反映了 srcset
HTML 属性,包含用逗号分隔(',', U+002C COMMA
)的候选图像列表。候选图像是一个 URL,后跟者图像宽度值和 w
描述符,或者跟着像素密度值和 x
描述符。
HTMLSourceElement.type
一个 DOMString
,反映了 type
HTML 属性,包含媒体资源类型。
方法
没有特有的方法; 所有方法继承自父类 HTMLElement
。
规范
规范 | 状态 | 备注 |
---|---|---|
Encrypted Media Extensions HTMLSourceElement 的定义 |
工作草案 | 增加了 keySystem 属性。 |
HTML Living Standard HTMLSourceElement 的定义 |
现行的标准 | 自从 HTML5 以来没有变化。 |
HTML5 HTMLSourceElement 的定义 |
推荐 | 初始定义。 |
桌面浏览器兼容性
特性 | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
基础支持 | 支持 | 支持 | 3.5 | 9 | 支持 | 支持 |
keySystem |
支持 | 支持 | 支持 | 未知 | 未知 | 未知 |
media |
支持 | 支持 | 3.5 | 9 | 支持 | 支持 |
sizes |
支持 | 支持 |
38 33 |
未知 | 未知 | 未知 |
src |
支持 | 支持 | 3.5 | 9 | 支持 | 支持 |
srcset |
支持 | 支持 |
38 33 |
未知 | 未知 | 未知 |
type |
支持 | 支持 | 3.5 | 9 | 支持 | 支持 |
移动浏览器兼容性
特性 | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
基础支持 | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
keySystem |
支持 | 支持 | 支持 | 支持 | 未知 | 未知 | 未知 |
media |
支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
sizes |
支持 | 支持 | 支持 |
38 33 |
未知 | 未知 | 未知 |
src |
支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
srcset |
支持 | 支持 | 支持 |
38 33 |
未知 | 未知 | 未知 |
type |
支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
相关链接
- 实现该接口的 HTML 元素:
<source>
。 - 可包含
<source>
元素的 HTML DOM API:HTMLVideoElement
,HTMLAudioElement
,HTMLPictureElement
。