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
DOMStringrepresenting 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
DOMStringthat reflects thearchiveHTML attribute, containing a list of archives for resources for this object. HTMLObjectElement.border- Is a
DOMStringthat reflects theborderHTML attribute, specifying the width of a border around the object. HTMLObjectElement.code- Is a
DOMStringrepresenting 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
DOMStringthat reflects thecodebaseHTML attribute, specifying the base path to use to resolve relative URIs. HTMLObjectElement.codeType- Is a
DOMStringthat reflects thecodetypeHTML attribute, specifying the content type of the data. HTMLObjectElement.contentDocumentRead only- Returns a
Documentrepresenting the active document of the object element's nested browsing context, if any; otherwisenull. HTMLObjectElement.contentWindowRead only- Returns a
WindowProxyrepresenting the window proxy of the object element's nested browsing context, if any; otherwisenull. HTMLObjectElement.data- Is a
DOMStringthat reflects thedataHTML attribute, specifying the address of a resource's data. HTMLObjectElement.declare- Is a
Booleanthat reflects thedeclareHTML attribute, indicating that this is a declaration, not an instantiation, of the object. HTMLObjectElement.formRead only- Retuns a
HTMLFormElementrepresenting the object element's form owner, or null if there isn't one. HTMLObjectElement.height- Is a
DOMStringthat reflects theheightHTML attribute, specifying the displayed height of the resource in CSS pixels. HTMLObjectElement.hspace- Is a
longrepresenting the horizontal space in pixels around the control. HTMLObjectElement.name- Is a
DOMStringthat reflects thenameHTML attribute, specifying the name of the browsing context. HTMLObjectElement.standby- Is a
DOMStringthat reflects thestandbyHTML attribute, specifying a message to display while the object loads. HTMLObjectElement.tabindex- Is a
longrepresenting the position of the element in the tabbing navigation order for the current document. HTMLObjectElement.type- Is a
DOMStringthat reflects thetypeHTML attribute, specifying the MIME type of the resource. HTMLObjectElement.typeMustMatch- Is a
Booleanthat reflects thetypemustmatchHTML attribute, indicating if the resource specified bydatamust only be played if it matches thetypeattribute. HTMLObjectElement.useMap- Is a
DOMStringthat reflects theusemapHTML attribute, specifying a<map>element to use. HTMLObjectElement.validationMessageRead only- Returns a
DOMStringrepresenting 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 (willValidateisfalse), or it satisfies its constraints. HTMLObjectElement.validityRead only- Returns a
ValidityStatewith the validity states that this element is in. HTMLObjectElement.vspace- Is a
longrepresenting the horizontal space in pixels around the control. HTMLObjectElement.width- Is a
DOMStringthat reflects thewidthHTML attribute, specifying the displayed width of the resource in CSS pixels. HTMLObjectElement.willValidateRead only- Returns a
Booleanthat indicates whether the element is a candidate for constraint validation. AlwaysfalseforHTMLObjectElementobjects.
Methods
Inherits methods from its parent, HTMLElement.
HTMLObjectElement.checkValidity()- Retuns a
Booleanthat always istrue, becauseobjectobjects 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>