HTMLElement

 

The HTMLElement interface represents any HTML element. Some elements directly implement this interface, others implement it via an interface that inherits it.

Properties

Inherits properties from its parent, Element, and implements those from GlobalEventHandlers and TouchEventHandlers.

HTMLElement.accessKey (en-US)
Is a DOMString (en-US) representing the access key assigned to the element.
HTMLElement.accessKeyLabel (en-US) Read only
Returns a DOMString (en-US) containing the element's assigned access key.
HTMLElement.contentEditable (en-US)
Is a DOMString (en-US), where a value of "true" means the element is editable and a value of "false" means it isn't.
HTMLElement.isContentEditable (en-US) Read only
Returns a Boolean (en-US) that indicates whether or not the content of the element can be edited.
HTMLElement.contextMenu (en-US)
Is an HTMLMenuElement (en-US) representing the contextual menu associated with the element. It may be null
HTMLElement.dataset Read only
Returns a DOMStringMap (en-US) that allows access to read and write the element custom data attributes (data-*) .
HTMLElement.dir
Is a DOMString (en-US), reflecting the dir global attribute, representing the directionality of the element. Possible values are "ltr", "rtl", and "auto".
HTMLElement.draggable
Is a Boolean indicating if the element can be dragged.
HTMLElement.dropzone Read only
Returns a DOMSettableTokenList reflecting the dropzone global attribute and describing the behavior of the element regarding a drop operation.
HTMLElement.hidden (en-US)
Is a Boolean indicating if the element is hidden or not.
HTMLElement.itemScope
Is a Boolean
HTMLElement.itemType Read only
Returns a DOMSettableTokenList
HTMLElement.itemId
Is a DOMString (en-US)
HTMLElement.itemRef Read only
Returns a DOMSettableTokenList
HTMLElement.itemProp Read only
Returns a DOMSettableTokenList
HTMLElement.itemValue
Returns an Object
HTMLElement.lang
Is a DOMString (en-US) representing the language of an element's attributes, text, and element contents.
HTMLElement.offsetHeight Read only
Returns a double containing the height of an element, relative to the layout.
HTMLElement.offsetLeftRead only
Returns a double, the distance from this element's left border to its offsetParent's left border.
HTMLElement.offsetParentRead only
Returns an Element that is the element from which all offset calculations are currently computed.
HTMLElement.offsetTop (en-US)Read only
Returns a double, the distance from this element's top border to its offsetParent's top border.
HTMLElement.offsetWidthRead only
Returns a double containing the width of an element, relative to the layout.
HTMLElement.properties Read only
Returns an HTMLPropertiesCollection
HTMLElement.spellcheck
Is a Boolean that controls spell-checking. It is present on all HTML elements, though it hasn't an effect on all of them.
HTMLElement.style (en-US)
Is CSSStyleDeclaration (en-US), an object representing the declarations of an element's style attributes.
HTMLElement.tabIndex (en-US)
Is a long representing the position of the element in the tabbing order.
HTMLElement.title (en-US)
Is a DOMString (en-US) containing the text that appears in a popup box when mouse is over the element.
HTMLElement.translate
Is a Boolean

Event handlers

Most events properties, of the form onXYZ, are defined on the GlobalEventHandlers or TouchEventHandlers, implemented by HTMLElement. A few more are specific to HTMLElement.

HTMLElement.oncopy (en-US) 
Returns the event handling code for the copy event (błąd 280959).
HTMLElement.oncut (en-US) 
Returns the event handling code for the cut event (błąd 280959).
HTMLElement.onpaste (en-US)
Returns the event handling code for the paste event (błąd 280959).
TouchEventHandlers.ontouchstart
Returns the event handling code for the touchstart (en-US) event.
TouchEventHandlers.ontouchend
Returns the event handling code for the touchend (en-US) event.
TouchEventHandlers.ontouchmove
Returns the event handling code for the touchmove (en-US) event.
TouchEventHandlers.ontouchenter
Returns the event handling code for the touchenter event.
TouchEventHandlers.ontouchleave
Returns the event handling code for the touchleave event.
TouchEventHandlers.ontouchcancel
Returns the event handling code for the touchcancel (en-US) event.

Methods

Inherits methods from its parent, Element.

HTMLElement.blur() (en-US)
Removes keyboard focus from the currently focused element.
HTMLElement.click()
Sends a mouse click event to the element.
HTMLElement.focus() (en-US)
Makes the element the current keyboard focus.
HTMLElement.forceSpellCheck() (en-US)
Makes the spell checker runs on the element.

Specifications

Specification Status Comment
CSS Object Model (CSSOM) View Module
The definition of 'HTMLElement' in that specification.
Working Draft Added the following properties: offsetParent, offsetTop, offsetLeft, offsetWidth, and offsetHeight.
HTML Living Standard
The definition of 'HTMLElement' in that specification.
Living Standard Added the following properties: translate, itemScope, itemType, itemId, itemRef, itemProp, properties, and itemValue.
Added the following method: forceSpellcheck().
Moved the onXYZ attributes to the GlobalEventHandlers interface and added an inheritance from it.
HTML5
The definition of 'HTMLElement' in that specification.
Recommendation Added the following properties: dataset, hidden, tabindex, accessKey, accessKeyLabel, draggable, dropzone, contentEditable, isContentEditable, contextMenu, spellcheck, commandType, commandLabel, commandIcon, commandHidden, commandDisabled, commandChecked, style, and all the onXYZ properties.
Moved the id and className properties to the Element interface.
Document Object Model (DOM) Level 2 HTML Specification
The definition of 'HTMLElement' in that specification.
Obsolete No change from Document Object Model (DOM) Level 2 HTML Specification
Document Object Model (DOM) Level 1 Specification
The definition of 'HTMLElement' in that specification.
Obsolete Initial definition.

Browser compatibility

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help! (en-US)

Feature Firefox (Gecko) Chrome Internet Explorer Opera Safari
Basic support 1.0 (1.7 or earlier) ? ? ? ?
accessKey (en-US) 5.0 (5.0) 17.0 ? ? (Yes)(535.10)
accessKeyLabel (en-US) 8.0 (8.0) ? ? ? No supportWebKit błąd 72715
blur() (en-US) 5.0 (5.0) ? ? ? ?
click() 5.0 (5.0) ? ? ? (Yes)(535.24)
dataset 6.0 (6.0) 9.0 ? 11.10 5.1
focus() (en-US) 5.0 (5.0) ? ? ? ?
contentEditable (en-US) 3.0 (1.9) (Yes) 5.5 9 (Yes)
spellcheck 2.0 (1.8.1) ? ? ? ?
style (en-US) (Yes) (returns a CSS2Properties, rather than a CSSStyleDeclaration (en-US)) (Yes) (Yes) (Yes) (Yes)
forceSpellCheck() (en-US) No support No support No support No support No support
dataset 6.0 (6.0) 8.0 11 11.10 6
draggable (Yes) ? ? 12.0 ?
dropzone No support No support No support 12.0 No support
offsetLeft, offsetTop (en-US), offsetParent, offsetHeight and offsetWidth (Yes) ? (Yes) ? ?
translate No support No support No support No support No support
itemScope, itemType, itemRef, itemId, itemProp, and itemValue 6.0 (6.0) No support No support 11.60
(Removed in Opera 15)
No support
properties (Yes) ? ? ? ?
HTMLElement.ontouchstart, HTMLElement.ontouchend, HTMLElement.ontouchmove, HTMLElement.ontouchenter, HTMLElement.ontouchleave, and HTMLElement.ontouchcancel (Yes) (Yes) No support ? (Yes)
HTMLElement.oncopy (en-US), HTMLElement.oncut (en-US), and HTMLElement.onpaste (en-US) 3.0 (1.9) ? ? ? ?
Feature Firefox Mobile (Gecko) Android IE Mobile Opera Mobile Safari Mobile
Basic support

1.0 (1.0)

? ? ? ?
accessKey (en-US) 5.0 (5.0)
accessKeyLabel (en-US) 8.0 (8.0)
blur() (en-US) 5.0 (5.0)
click() 5.0 (5.0)
dataset 6.0 (6.0)
focus() (en-US) 5.0 (5.0)
HTMLElement.oncopy (en-US), HTMLElement.oncut (en-US), and HTMLElement.onpaste (en-US) 1.0 (1.9) ? ? ? ?

See also