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.

  <div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 20%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 120" preserveAspectRatio="xMinYMin meet"><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/EventTarget" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25  121,20  121,30  111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/Node" target="_top"><rect x="151" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="188.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Node</text></a><polyline points="226,25  236,20  236,30  226,25" stroke="#D4DDE4" fill="none"/><line x1="236" y1="25" x2="266" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/Element" target="_top"><rect x="266" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="303.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Element</text></a><polyline points="341,25  351,20  351,30  341,25" stroke="#D4DDE4" fill="none"/><line x1="351" y1="25" x2="381" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement" target="_top"><rect x="381" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="436" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLElement</text></a><polyline points="491,25  501,20  501,30  491,25" stroke="#D4DDE4" fill="none"/><line x1="501" y1="25" x2="509" y2="25" stroke="#D4DDE4"/><line x1="509" y1="25" x2="509" y2="90" stroke="#D4DDE4"/><line x1="509" y1="90" x2="492" y2="90" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/HTMLObjectElement" target="_top"><rect x="321" y="65" width="170" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text  x="406" y="94" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLObjectElement</text></a></svg></div>

  a:hover text { fill: #0095DD; pointer-events: all;}

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

Browser compatibility

[1] Starting with Chrome 58/Opera 45, this interface can no longer be called as a function.

See also

• The HTML element implementing this interface: <object>