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
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 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.
Obsolete The contentDocument property has been added.
Document Object Model (DOM) Level 1 Specification
The definition of 'HTMLObjectElement' in that specification.
Obsolete Initial definition.

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support Yes Yes1 Yes Yes Yes
align Yes Yes1 Yes Yes Yes
archive Yes Yes1 Yes Yes Yes
border Yes Yes1 Yes Yes Yes
code Yes Yes1 Yes Yes Yes
codeBase Yes Yes1 Yes Yes Yes
codeType Yes Yes1 Yes Yes Yes
contentDocument Yes Yes1 Yes Yes Yes
contentWindow Yes No No No No No
data Yes Yes1 Yes Yes Yes
declare Yes Yes1 Yes Yes Yes
form Yes Yes1 Yes Yes Yes
height Yes Yes1 Yes Yes Yes
hspace Yes Yes1 Yes Yes Yes
name Yes Yes1 Yes Yes Yes
standby Yes Yes1 Yes Yes Yes
type Yes Yes1 Yes Yes Yes
typeMustMatch No No27 No No No
useMap Yes Yes1 Yes Yes Yes
validationMessage Yes Yes1 Yes Yes Yes
validity Yes Yes1 Yes Yes Yes
vspace Yes Yes1 Yes Yes Yes
width Yes Yes1 Yes Yes Yes
willValidate Yes Yes1 Yes Yes Yes
checkValidity Yes Yes1 Yes Yes Yes
getSVGDocument Yes Yes Yes No Yes Yes
reportValidity Yes Yes1 Yes Yes Yes
setCustomValidity Yes Yes1 Yes Yes Yes
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support Yes Yes Yes4 Yes Yes ?
align Yes Yes Yes4 Yes Yes ?
archive Yes Yes Yes4 Yes Yes ?
border Yes Yes Yes4 Yes Yes ?
code Yes Yes Yes4 Yes Yes ?
codeBase Yes Yes Yes4 Yes Yes ?
codeType Yes Yes Yes4 Yes Yes ?
contentDocument Yes Yes Yes4 Yes Yes ?
contentWindow Yes Yes No No No No ?
data Yes Yes Yes4 Yes Yes ?
declare Yes Yes Yes4 Yes Yes ?
form Yes Yes Yes4 Yes Yes ?
height Yes Yes Yes4 Yes Yes ?
hspace Yes Yes Yes4 Yes Yes ?
name Yes Yes Yes4 Yes Yes ?
standby Yes Yes Yes4 Yes Yes ?
type Yes Yes Yes4 Yes Yes ?
typeMustMatch No No No27 No No ?
useMap Yes Yes Yes4 Yes Yes ?
validationMessage Yes Yes Yes4 Yes Yes ?
validity Yes Yes Yes4 Yes Yes ?
vspace Yes Yes Yes4 Yes Yes ?
width Yes Yes Yes4 Yes Yes ?
willValidate Yes Yes Yes4 Yes Yes ?
checkValidity Yes Yes Yes4 Yes Yes ?
getSVGDocument Yes Yes Yes Yes Yes Yes ?
reportValidity Yes Yes Yes4 Yes Yes ?
setCustomValidity Yes Yes Yes4 Yes Yes ?

See also

  • The HTML element implementing this interface: <object>

Document Tags and Contributors

Last updated by: connorshea,