HTMLElement

 

HTMLElement 介面表示了所有的 HTML 元素。部分元素直接實作了此介面,其它則是實作繼承自 HTMLElement 的子介面。

EventTarget Node Element HTMLElement

屬性

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

HTMLElement.accessKey (en-US)
Is a DOMString representing the access key assigned to the element.
HTMLElement.accessKeyLabel (en-US) Read only
Returns a DOMString containing the element's assigned access key.
HTMLElement.contentEditable (en-US)
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) 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 a HTMLMenuElement (en-US) representing the contextual menu associated with the element. It may be null.
HTMLElement.dataset Read only
Returns a DOMStringMap (en-US) with which script can read and write the element's 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 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 Experimental
Is a Boolean representing the item scope.
HTMLElement.itemType Read only Experimental
Returns a DOMSettableTokenList
HTMLElement.itemId Experimental
Is a DOMString representing the item ID.
HTMLElement.itemRef Read only Experimental
Returns a DOMSettableTokenList
HTMLElement.itemProp Read only Experimental
Returns a DOMSettableTokenList
HTMLElement.itemValue Experimental
Returns a Object representing the item value.
HTMLElement.lang
Is a DOMString representing the language of an element's attributes, text, and element contents.
HTMLElement.offsetHeight (en-US) Read only Experimental
Returns a double containing the height of an element, relative to the layout.
HTMLElement.offsetLeft (en-US)Read only Experimental
Returns a double, the distance from this element's left border to its offsetParent's left border.
HTMLElement.offsetParent (en-US)Read only Experimental
Returns a Element that is the element from which all offset calculations are currently computed.
HTMLElement.offsetTop (en-US)Read only Experimental
Returns a double, the distance from this element's top border to its offsetParent's top border.
HTMLElement.offsetWidth (en-US)Read only Experimental
Returns a double containing the width of an element, relative to the layout.
HTMLElement.properties Read only Experimental
Returns a HTMLPropertiesCollection
HTMLElement.spellcheck
Is a Boolean that controls spell-checking. It is present on all HTML elements, though it doesn't have an effect on all of them.
HTMLElement.style
Is a CSSStyleDeclaration, 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 Experimental
Is a Boolean representing the translation.

事件處理器

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)  Non-Standard
Returns the event handling code for the copy event (bug 280959).
HTMLElement.oncut (en-US)  Non-Standard
Returns the event handling code for the cut event (bug 280959).
HTMLElement.onpaste (en-US) Non-Standard
Returns the event handling code for the paste event (bug 280959).
TouchEventHandlers.ontouchstart Non-Standard
Returns the event handling code for the touchstart (en-US) event.
TouchEventHandlers.ontouchend Non-Standard
Returns the event handling code for the touchend (en-US) event.
TouchEventHandlers.ontouchmove Non-Standard
Returns the event handling code for the touchmove (en-US) event.
TouchEventHandlers.ontouchenter Non-Standard
Returns the event handling code for the touchenter event.
TouchEventHandlers.ontouchleave Non-Standard
Returns the event handling code for the touchleave event.
TouchEventHandlers.ontouchcancel Non-Standard
Returns the event handling code for the touchcancel event.

方法

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) Experimental
Runs the spell checker on the element's contents.

規範

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.

瀏覽器相容性

BCD tables only load in the browser

參見