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.

EventTarget

Node

Element

HTMLElement

HTMLObjectElementInstance properties
-------------------

*Inherits properties from its parent, `HTMLElement`.*

`HTMLObjectElement.align` 
Deprecated

A string 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` 
Deprecated

A string that reflects the `archive` HTML attribute, containing a list of archives for resources for this object.

`HTMLObjectElement.border` 
Deprecated

A string that reflects the `border` HTML attribute, specifying the width of a border around the object.

`HTMLObjectElement.code` 
Deprecated

A string 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` 
Deprecated

A string that reflects the `codebase` HTML attribute, specifying the base path to use to resolve relative URIs.

`HTMLObjectElement.codeType` 
Deprecated

A string 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`

Returns a string that reflects the `data` HTML attribute, specifying the address of a resource's data.

`HTMLObjectElement.declare` 
Deprecated

A boolean value that reflects the `declare` HTML attribute, indicating that this is a declaration, not an instantiation, of the object.

`HTMLObjectElement.form` Read only 

Returns a `HTMLFormElement` representing the object element's form owner, or null if there isn't one.

`HTMLObjectElement.height`

Returns a string that reflects the `height` HTML attribute, specifying the displayed height of the resource in CSS pixels.

`HTMLObjectElement.hspace` 
Deprecated

A `long` representing the horizontal space in pixels around the control.

`HTMLObjectElement.name`

Returns a string that reflects the `name` HTML attribute, specifying the name of the browsing context.

`HTMLObjectElement.standby` 
Deprecated

A string that reflects the `standby` HTML attribute, specifying a message to display while the object loads.

`HTMLObjectElement.type`

A string that reflects the `type` HTML attribute, specifying the MIME type of the resource.

`HTMLObjectElement.useMap`

A string that reflects the `usemap` HTML attribute, specifying a `<map>` element to use.

`HTMLObjectElement.validationMessage` Read only 

Returns a string 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` 
Deprecated

A `long` representing the horizontal space in pixels around the control.

`HTMLObjectElement.width`

A string that reflects the `width` HTML attribute, specifying the displayed width of the resource in CSS pixels.

`HTMLObjectElement.willValidate` Read only 

Returns a boolean value that indicates whether the element is a candidate for constraint validation. Always `false` for `HTMLObjectElement` objects.

Instance methods
----------------

*Inherits methods from its parent, `HTMLElement`.*

`HTMLObjectElement.checkValidity()`

Returns a boolean value 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 |
| --- |
| HTML Standard # htmlobjectelement |

Browser compatibility
---------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

See also
--------

* The HTML element implementing this interface: `<object>`