HTMLObjectElement - 操作 <object> 元素
HTMLObjectElement
接口提供了特殊的属性和方法(除了通过继承通用的 HTMLElement
接口获得的常规属性)来操作 <object>
元素,它表示外部的资源。
属性
从其父接口 HTMLElement
继承了属性。
HTMLObjectElement.align
一个 DOMString
,表示枚举属性,指示元素内容相对于周围上下文的对齐。可能的值是 "left"
,"right"
,"justify"
和 "center"
。
HTMLObjectElement.archive
一个 DOMString
,它反映了 archive
HTML 属性,包含此对象资源的归档列表。
HTMLObjectElement.border
一个 DOMString
,它反映了 border
HTML 属性,指定了对象周围边框的宽度。
HTMLObjectElement.code
一个 DOMString
,表示 applet 类文件的名称,包含 applet 的子类或到达类的路径,包括类文件本身。
HTMLObjectElement.codeBase
一个 DOMString
,它反映了 codebase
HTML 属性,指定了用于解析相对 URI 的基本路径。
HTMLObjectElement.codeType
一个 DOMString
,它反映了 codetype
HTML 属性,指定了数据的内容类型。
HTMLObjectElement.contentDocument
只读
返回一个 Document
,表示对象元素的嵌套浏览上下文的活动文档,如果没有则为 null
。
HTMLObjectElement.contentWindow
只读
返回一个 WindowProxy
,表示对象元素嵌套浏览上下文的窗口代理,如果没有则为 null
。
HTMLObjectElement.data
返回一个 DOMString
,反映了 data
HTML 属性,指定资源数据的地址。
HTMLObjectElement.declare
一个 Boolean
,它反映了 declare
HTML 属性,表明这是对象的声明,而不是实例化。
HTMLObjectElement.form
只读
返回一个 HTMLFormElement
,表示对象元素表单所有者,如果没有则为 null
。
HTMLObjectElement.height
返回一个 DOMString
,反映了 height
HTML 属性,指定以 CSS 像素显示的资源高度。
HTMLObjectElement.hspace
一个 long
表示控件周围的水平空间(以像素为单位)。
HTMLObjectElement.name
返回一个 DOMString
,反映了 name
HTML 属性,指定浏览上下文的名称。
HTMLObjectElement.standby
一个 DOMString
,它反映了 standby
HTML 属性,指定了在对象加载时显示的消息。
HTMLObjectElement.tabindex
一个 long
,表示当前文档的 Tab 键导航顺序中元素的位置。
HTMLObjectElement.type
一个 DOMString
,它反映了 type
HTML 属性,指定了资源的 MIME 类型。
HTMLObjectElement.typeMustMatch
一个 Boolean
,它反映了typemustmatch
HTML 属性,指示 data
指定的资源只有在匹配 type
属性时才能播放。
HTMLObjectElement.useMap
一个 DOMString
,它反映了 usemap
HTML 属性,指定了要使用的<map>
元素。
HTMLObjectElement.validationMessage
只读
返回一个 DOMString
,表示本地化消息,该消息描述控件不满足的验证约束(如果有的话)。如果控件不是约束验证的候选者( willValidate
为 false
),则它是空字符串,或者它满足其约束。
HTMLObjectElement.validity
只读
返回 ValidityState
,其中包含此元素所在的有效状态。
HTMLObjectElement.vspace
一个 long
,表示控件周围的水平空间(以像素为单位)。
HTMLObjectElement.width
一个 DOMString
,反映了 width
HTML 属性,指定以 CSS 像素显示的资源宽度。
HTMLObjectElement.willValidate
只读
返回一个 Boolean
,指示元素是否是约束验证的候选者。HTMLObjectElement
对象总是返回 false
。
方法
从其父接口 HTMLElement
继承方法。
HTMLObjectElement.checkValidity()
返回一个 Boolean
,始终为 true
,因为 object
永远不是约束验证的候选对象。
HTMLObjectElement.setCustomValidity()
为该元素设置自定义有效性消息。如果该消息不是空字符串,则该元素遇到自定义有效性错误,并且不进行验证。
规范
规范 | 状态 | 备注 |
---|---|---|
HTML Living Standard HTMLObjectElement 的定义 |
现行的标准 | - |
HTML5 HTMLObjectElement 的定义 |
推荐 | W3C 规范是 HTML Living Standard 的先前版本的最新版本。 从技术上讲,属性 tabindex 现在在 HTMLElement 上定义。以下属性现已过时: align ,archive ,border ,code ,codeBase ,codeType ,declare ,hspace ,standby 和 vspace 。添加了以下属性: typeMustMatch ,contentWindow ,willValidate ,validity 和 validationMessage 。添加了以下方法: checkValidity() 和setCustomValidity() 。 |
Document Object Model (DOM) Level 2 HTML Specification HTMLObjectElement 的定义 |
已过时 | 增加了 contentDocument 属性。 |
Document Object Model (DOM) Level 1 Specification HTMLObjectElement 的定义 |
已过时 | 初始定义。 |
桌面浏览器兼容性
特性 | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
基础支持 | 支持 | 支持 | 1 | 支持 | 支持 | 支持 |
align | 支持 | 支持 | 1 | 支持 | 支持 | 支持 |
archive | 支持 | 支持 | 1 | 支持 | 支持 | 支持 |
border | 支持 | 支持 | 1 | 支持 | 支持 | 支持 |
code | 支持 | 支持 | 1 | 支持 | 支持 | 支持 |
codeBase | 支持 | 支持 | 1 | 支持 | 支持 | 支持 |
codeType | 支持 | 支持 | 1 | 支持 | 支持 | 支持 |
contentDocument | 支持 | 支持 | 1 | 支持 | 支持 | 支持 |
contentWindow | 支持 | 不支持 | 不支持 | 不支持 | 不支持 | 不支持 |
data | 支持 | 支持 | 1 | 支持 | 支持 | 支持 |
declare | 支持 | 支持 | 1 | 支持 | 支持 | 支持 |
form | 支持 | 支持 | 1 | 支持 | 支持 | 支持 |
height | 支持 | 支持 | 1 | 支持 | 支持 | 支持 |
hspace | 支持 | 支持 | 1 | 支持 | 支持 | 支持 |
name | 支持 | 支持 | 1 | 支持 | 支持 | 支持 |
standby | 支持 | 支持 | 1 | 支持 | 支持 | 支持 |
type | 支持 | 支持 | 1 | 支持 | 支持 | 支持 |
typeMustMatch | 不支持 | 不支持 | 27 | 不支持 | 不支持 | 不支持 |
useMap | 支持 | 支持 | 1 | 支持 | 支持 | 支持 |
validationMessage | 支持 | 支持 | 1 | 支持 | 支持 | 支持 |
validity | 支持 | 支持 | 1 | 支持 | 支持 | 支持 |
vspace | 支持 | 支持 | 1 | 支持 | 支持 | 支持 |
width | 支持 | 支持 | 1 | 支持 | 支持 | 支持 |
willValidate | 支持 | 支持 | 1 | 支持 | 支持 | 支持 |
checkValidity | 支持 | 支持 | 1 | 支持 | 支持 | 支持 |
getSVGDocument | 支持 | 支持 | 支持 | 不支持 | 支持 | 支持 |
reportValidity | 支持 | 支持 | 1 | 支持 | 支持 | 支持 |
setCustomValidity | 支持 | 支持 | 1 | 支持 | 支持 | 支持 |
移动浏览器兼容性
特性 | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
基础支持 | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
align | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
archive | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
border | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
code | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
codeBase | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
codeType | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
contentDocument | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
contentWindow | 支持 | 支持 | 不支持 | 不支持 | 未知 | 不支持 | 不支持 |
data | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
declare | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
form | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
height | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
hspace | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
name | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
standby | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
type | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
typeMustMatch | 不支持 | 不支持 | 不支持 | 27 | 未知 | 不支持 | 不支持 |
useMap | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
validationMessage | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
validity | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
vspace | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
width | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
willValidate | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
checkValidity | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
getSVGDocument | 支持 | 支持 | 支持 | 支持 | 未知 | 支持 | 支持 |
reportValidity | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
setCustomValidity | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
相关链接
- 实现该接口的 HTML 元素:
<object>