我們的志工尚未將此文章翻譯為 正體中文 (繁體) 版本。加入我們,幫忙翻譯!
The HTMLObjectElement
interface provides special properties and methods (beyond those on the HTMLElement
interface it also has available to it by inheritance) for manipulating the layout and presentation of <object>
element, representing external resources.
Properties
Inherits properties from its parent, HTMLElement
.
HTMLObjectElement.align
- Is a
DOMString
representing an enumerated property indicating alignment of the element's contents with respect to the surrounding context. The possible values are"left"
,"right"
,"justify"
, and"center"
. HTMLObjectElement.archive
- Is a
DOMString
that reflects thearchive
HTML attribute, containing a list of archives for resources for this object. HTMLObjectElement.border
- Is a
DOMString
that reflects theborder
HTML attribute, specifying the width of a border around the object. HTMLObjectElement.code
- Is a
DOMString
representing the name of an applet class file, containing either the applet's subclass, or the path to get to the class, including the class file itself. HTMLObjectElement.codeBase
- Is a
DOMString
that reflects thecodebase
HTML attribute, specifying the base path to use to resolve relative URIs. HTMLObjectElement.codeType
- Is a
DOMString
that reflects thecodetype
HTML attribute, specifying the content type of the data. HTMLObjectElement.contentDocument
Read only- Returns a
Document
representing the active document of the object element's nested browsing context, if any; otherwisenull
. HTMLObjectElement.contentWindow
Read only- Returns a
WindowProxy
representing the window proxy of the object element's nested browsing context, if any; otherwisenull
. HTMLObjectElement.data
- Is a
DOMString
that reflects thedata
HTML attribute, specifying the address of a resource's data. HTMLObjectElement.declare
- Is a
Boolean
that reflects thedeclare
HTML attribute, indicating that this is a declaration, not an instantiation, of the object. HTMLObjectElement.form
Read only- Retuns a
HTMLFormElement
representing the object element's form owner, or null if there isn't one. HTMLObjectElement.height
- Is a
DOMString
that reflects theheight
HTML attribute, specifying the displayed height of the resource in CSS pixels. HTMLObjectElement.hspace
- Is a
long
representing the horizontal space in pixels around the control. HTMLObjectElement.name
- Is a
DOMString
that reflects thename
HTML attribute, specifying the name of the browsing context. HTMLObjectElement.standby
- Is a
DOMString
that reflects thestandby
HTML attribute, specifying a message to display while the object loads. HTMLObjectElement.tabindex
- Is a
long
representing the position of the element in the tabbing navigation order for the current document. HTMLObjectElement.type
- Is a
DOMString
that reflects thetype
HTML attribute, specifying the MIME type of the resource. HTMLObjectElement.typeMustMatch
- Is a
Boolean
that reflects thetypemustmatch
HTML attribute, indicating if the resource specified bydata
must only be played if it matches thetype
attribute. HTMLObjectElement.useMap
- Is a
DOMString
that reflects theusemap
HTML attribute, specifying a<map>
element to use. HTMLObjectElement.validationMessage
Read only- Returns a
DOMString
representing a localized message that describes the validation constraints that the control does not satisfy (if any). This is the empty string if the control is not a candidate for constraint validation (willValidate
isfalse
), or it satisfies its constraints. HTMLObjectElement.validity
Read only- Returns a
ValidityState
with the validity states that this element is in. HTMLObjectElement.vspace
- Is a
long
representing the horizontal space in pixels around the control. HTMLObjectElement.width
- Is a
DOMString
that reflects thewidth
HTML attribute, specifying the displayed width of the resource in CSS pixels. HTMLObjectElement.willValidate
Read only- Returns a
Boolean
that indicates whether the element is a candidate for constraint validation. Alwaysfalse
forHTMLObjectElement
objects.
Methods
Inherits methods from its parent, HTMLElement
.
HTMLObjectElement.checkValidity()
- Retuns a
Boolean
that always istrue
, becauseobject
objects are never candidates for constraint validation. HTMLObjectElement.setCustomValidity()
- Sets a custom validity message for the element. If this message is not the empty string, then the element is suffering from a custom validity error, and does not validate.
Specifications
Specification | Status | Comment |
---|---|---|
WHATWG HTML Living Standard The definition of 'HTMLObjectElement' in that specification. |
Living Standard | No change from HTML5, the latest snaspshot of the WHATWG specification. |
HTML5 The definition of 'HTMLObjectElement' in that specification. |
Recommendation | The W3C specification is a latest of a previous version of WHATWG HTML Living Standard Technically, the property tabindex is now defined on HTMLElement .The following properties are now obsolete: align , archive , border , code , codeBase , codeType , declare , hspace , standby , and vspace .The following properties have been added: typeMustMatch , contentWindow , willValidate , validity , and validationMessage .The following methods have been added: checkValidity() and setCustomValidity() . |
Document Object Model (DOM) Level 2 HTML Specification The definition of 'HTMLObjectElement' in that specification. |
Recommendation | The contentDocument property has been added. |
Document Object Model (DOM) Level 1 Specification The definition of 'HTMLObjectElement' in that specification. |
Recommendation | Initial definition. |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
Basic support | (Yes) | 1.0 (1.7 or earlier) | (Yes) | (Yes) | (Yes) |
typeMustMatch |
? | 27 (27) | ? | ? | ? |
contentWindow |
? | Not supported (bug 678460) | ? | ? | ? |
Feature | Android | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|
Basic support | (Yes) | 1.0 (1.0) | (Yes) | (Yes) | (Yes) |
typeMustMatch |
? | 27.0 (27) | ? | ? | ? |
contentWindow |
? | Not supported (bug 678460) | ? | ? | ? |
See also
- The HTML element implementing this interface:
<object>