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,表示本地化消息,该消息描述控件不满足的验证约束(如果有的话)。如果控件不是约束验证的候选者( willValidatefalse),则它是空字符串,或者它满足其约束。

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 上定义。
以下属性现已过时:alignarchivebordercodecodeBasecodeTypedeclarehspacestandbyvspace
添加了以下属性:typeMustMatchcontentWindowwillValidatevalidityvalidationMessage
添加了以下方法: checkValidity()setCustomValidity()
Document Object Model (DOM) Level 2 HTML Specification
HTMLObjectElement 的定义
已过时 增加了 contentDocument 属性。
Document Object Model (DOM) Level 1 Specification
HTMLObjectElement 的定义
已过时 初始定义。

桌面浏览器兼容性

特性ChromeEdgeFirefoxInternet ExplorerOperaSafari
基础支持 支持 支持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 支持 支持 支持

移动浏览器兼容性

特性AndroidChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS 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>