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>