HTMLElement

 

A interface HTMLElement representa qualquer elemento HTML. Alguns elementos implementam diretamente essa interface, outros a implementam por meio de uma interface que a herda.

Propriedades

Propriedades herdadas do elemento pai, Element, e aquelas implementadas de GlobalEventHandlers e de TouchEventHandlers.

HTMLElement.accessKey
Is a DOMString representing the access key assigned to the element.
HTMLElement.accessKeyLabel (en-US) Somente leitura
Returns a DOMString containing the element's assigned access key.
HTMLElement.contentEditable
Is a DOMString, where a value of "true" means the element is editable and a value of "false" means it isn't.
HTMLElement.isContentEditable (en-US) Somente leitura
Returns a Boolean (en-US) that indicates whether or not the content of the element can be edited.
HTMLElement.contextMenu
Is an HTMLMenuElement (en-US) representing the contextual menu associated with the element. It may be null
HTMLElement.dataset Somente leitura
Returns a DOMStringMap that allows access to read and write the element custom data attributes (data-*) .
HTMLElement.dir (en-US)
Is a DOMString, 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 Somente leitura
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 This is an experimental API that should not be used in production code.
Is a Boolean
HTMLElement.itemType Somente leitura This is an experimental API that should not be used in production code.
Returns a DOMSettableTokenList
HTMLElement.itemId This is an experimental API that should not be used in production code.
Is a DOMString
HTMLElement.itemRef Somente leitura This is an experimental API that should not be used in production code.
Returns a DOMSettableTokenList
HTMLElement.itemProp Somente leitura This is an experimental API that should not be used in production code.
Returns a DOMSettableTokenList
HTMLElement.itemValue This is an experimental API that should not be used in production code.
Returns an Object
HTMLElement.lang
Is a DOMString representing the language of an element's attributes, text, and element contents.
HTMLElement.offsetHeight Somente leitura This is an experimental API that should not be used in production code.
Returns a double containing the height of an element, relative to the layout.
HTMLElement.offsetLeftSomente leitura This is an experimental API that should not be used in production code.
Returns a double, the distance from this element's left border to its offsetParent's left border.
HTMLElement.offsetParentSomente leitura This is an experimental API that should not be used in production code.
Returns an Element that is the element from which all offset calculations are currently computed.
HTMLElement.offsetTopSomente leitura This is an experimental API that should not be used in production code.
Returns a double, the distance from this element's top border to its offsetParent's top border.
HTMLElement.offsetWidthSomente leitura This is an experimental API that should not be used in production code.
Returns a double containing the width of an element, relative to the layout.
HTMLElement.properties Somente leitura This is an experimental API that should not be used in production code.
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 containing the text that appears in a popup box when mouse is over the element.
HTMLElement.translate This is an experimental API that should not be used in production code.
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)  This API has not been standardized.
Returns the event handling code for the copy event (bug 280959).
HTMLElement.oncut (en-US)  This API has not been standardized.
Returns the event handling code for the cut event (bug 280959).
HTMLElement.onpaste (en-US) This API has not been standardized.
Returns the event handling code for the paste event (bug 280959).
TouchEventHandlers.ontouchstart This API has not been standardized.
Returns the event handling code for the touchstart (en-US) event.
TouchEventHandlers.ontouchend This API has not been standardized.
Returns the event handling code for the touchend (en-US) event.
TouchEventHandlers.ontouchmove This API has not been standardized.
Returns the event handling code for the touchmove (en-US) event.
TouchEventHandlers.ontouchenter This API has not been standardized.
Returns the event handling code for the touchenter event.
TouchEventHandlers.ontouchleave This API has not been standardized.
Returns the event handling code for the touchleave event.
TouchEventHandlers.ontouchcancel This API has not been standardized.
Returns the event handling code for the touchcancel (en-US) event.

Methods

Inherits methods from its parent, Element.

HTMLElement.blur()
Removes keyboard focus from the currently focused element.
HTMLElement.click()
Sends a mouse click event to the element.
HTMLElement.focus()
Makes the element the current keyboard focus.
HTMLElement.forceSpellCheck() (en-US) This is an experimental API that should not be used in production code.
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.
Rascunho atual Added the following properties: offsetParent, offsetTop, offsetLeft, offsetWidth, and offsetHeight.
HTML Living Standard
The definition of 'HTMLElement' in that specification.
Padrão em tempo real 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.
Recomendação 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.
Obsoleto 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.
Obsoleto Initial definition.

Browser compatibility

Estamos convertendo nossos dados de compatibilidade para o formato JSON. Esta tabela de compatibilidade ainda usa o formato antigo, pois ainda não convertemos os dados que ela contém. Descubra como você pode ajudar! (en-US)

Feature Firefox (Gecko) Chrome Internet Explorer Opera Safari
Basic support 1.0 (1.7 or earlier) ? ? ? ?
accessKey 5.0 (5.0) 17.0 ? ? (Yes)(535.10)
accessKeyLabel (en-US) 8.0 (8.0) ? ? ? Não suportadoWebKit bug 72715
blur() 5.0 (5.0) ? ? ? ?
click() 5.0 (5.0) ? ? ? (Yes)(535.24)
dataset 6.0 (6.0) 9.0 ? 11.10 5.1
focus() 5.0 (5.0) ? ? ? ?
contentEditable 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) This is an experimental API that should not be used in production code. Não suportado Não suportado Não suportado Não suportado Não suportado
dataset 6.0 (6.0) 8.0 11 11.10 6
draggable (Yes) ? ? 12.0 ?
dropzone Não suportado Não suportado Não suportado 12.0 Não suportado
offsetLeft, offsetTop, offsetParent, offsetHeight and offsetWidth This is an experimental API that should not be used in production code. (Yes) ? (Yes) ? ?
translate This is an experimental API that should not be used in production code. Não suportado Não suportado Não suportado Não suportado Não suportado
itemScope, itemType, itemRef, itemId, itemProp, and itemValue This is an experimental API that should not be used in production code. 6.0 (6.0) Não suportado Não suportado 11.60
(Removed in Opera 15)
Não suportado
properties This is an experimental API that should not be used in production code. (Yes) ? ? ? ?
HTMLElement.ontouchstart, HTMLElement.ontouchend, HTMLElement.ontouchmove, HTMLElement.ontouchenter, HTMLElement.ontouchleave, and HTMLElement.ontouchcancel (Yes) (Yes) Não suportado ? (Yes)
HTMLElement.oncopy (en-US), HTMLElement.oncut (en-US), and HTMLElement.onpaste (en-US) This API has not been standardized. 3.0 (1.9) ? ? ? ?
Feature Firefox Mobile (Gecko) Android IE Mobile Opera Mobile Safari Mobile
Basic support

1.0 (1.0)

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

See also