HTMLObjectElement

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 the archive HTML attribute, containing a list of archives for resources for this object.
HTMLObjectElement.border
Is a DOMString that reflects the border 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 the codebase HTML attribute, specifying the base path to use to resolve relative URIs.
HTMLObjectElement.codeType
Is a DOMString that reflects the codetype 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; otherwise null.
HTMLObjectElement.contentWindow Read only
Returns a WindowProxy representing the window proxy of the object element's nested browsing context, if any; otherwise null.
HTMLObjectElement.data
Is a DOMString that reflects the data HTML attribute, specifying the address of a resource's data.
HTMLObjectElement.declare
Is a Boolean that reflects the declare 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 the height 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 the name HTML attribute, specifying the name of the browsing context.
HTMLObjectElement.standby
Is a DOMString that reflects the standby 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 the type HTML attribute, specifying the MIME type of the resource.
HTMLObjectElement.typeMustMatch
Is a Boolean that reflects the typemustmatch HTML attribute, indicating if the resource specified by data must only be played if it matches the type attribute.
HTMLObjectElement.useMap
Is a DOMString that reflects the usemap 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 is false), 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 the width 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. Always false for HTMLObjectElement objects.

Methods

Inherits methods from its parent, HTMLElement.

HTMLObjectElement.checkValidity()
Retuns a Boolean that always is true, because object 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>

Document Tags and Contributors

Contributors to this page: fscholz, teoli, kscarfone, Sheppy, ethertank, trevorh, Dikrib, jswisher
Last updated by: fscholz,
Hide Sidebar