Interface HTMLInputElement

Provides special properties and methods for manipulating the options, layout, and presentation of elements.

MDN Reference

interface HTMLInputElement {
    $bindAttributes?: AttributeBindingsMap;
    $bindItemStart?: RangeBinding;
    $bindStart?: RangeBinding;
    $destroyListeners?: any[];
    ATTRIBUTE_NODE: 2;
    CDATA_SECTION_NODE: 4;
    COMMENT_NODE: 8;
    DOCUMENT_FRAGMENT_NODE: 11;
    DOCUMENT_NODE: 9;
    DOCUMENT_POSITION_CONTAINED_BY: 16;
    DOCUMENT_POSITION_CONTAINS: 8;
    DOCUMENT_POSITION_DISCONNECTED: 1;
    DOCUMENT_POSITION_FOLLOWING: 4;
    DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC: 32;
    DOCUMENT_POSITION_PRECEDING: 2;
    DOCUMENT_TYPE_NODE: 10;
    ELEMENT_NODE: 1;
    ENTITY_NODE: 6;
    ENTITY_REFERENCE_NODE: 5;
    NOTATION_NODE: 12;
    PROCESSING_INSTRUCTION_NODE: 7;
    TEXT_NODE: 3;
    accept: string;
    accessKey: string;
    accessKeyLabel: string;
    align: string;
    alt: string;
    ariaAtomic: string;
    ariaAutoComplete: string;
    ariaBusy: string;
    ariaChecked: string;
    ariaColCount: string;
    ariaColIndex: string;
    ariaColSpan: string;
    ariaCurrent: string;
    ariaDisabled: string;
    ariaExpanded: string;
    ariaHasPopup: string;
    ariaHidden: string;
    ariaInvalid: string;
    ariaKeyShortcuts: string;
    ariaLabel: string;
    ariaLevel: string;
    ariaLive: string;
    ariaModal: string;
    ariaMultiLine: string;
    ariaMultiSelectable: string;
    ariaOrientation: string;
    ariaPlaceholder: string;
    ariaPosInSet: string;
    ariaPressed: string;
    ariaReadOnly: string;
    ariaRequired: string;
    ariaRoleDescription: string;
    ariaRowCount: string;
    ariaRowIndex: string;
    ariaRowSpan: string;
    ariaSelected: string;
    ariaSetSize: string;
    ariaSort: string;
    ariaValueMax: string;
    ariaValueMin: string;
    ariaValueNow: string;
    ariaValueText: string;
    assignedSlot: HTMLSlotElement;
    attributeStyleMap: StylePropertyMap;
    attributes: NamedNodeMap;
    autocapitalize: string;
    autocomplete: string;
    autofocus: boolean;
    baseURI: string;
    capture: string;
    checked: boolean;
    childElementCount: number;
    childNodes: NodeListOf<ChildNode>;
    children: HTMLCollection;
    classList: DOMTokenList;
    className: string;
    clientHeight: number;
    clientLeft: number;
    clientTop: number;
    clientWidth: number;
    contentEditable: string;
    dataset: DOMStringMap;
    defaultChecked: boolean;
    defaultValue: string;
    dir: string;
    dirName: string;
    disabled: boolean;
    draggable: boolean;
    enterKeyHint: string;
    files: FileList;
    firstChild: ChildNode;
    firstElementChild: Element;
    form: HTMLFormElement;
    formAction: string;
    formEnctype: string;
    formMethod: string;
    formNoValidate: boolean;
    formTarget: string;
    height: number;
    hidden: boolean;
    id: string;
    indeterminate: boolean;
    inert: boolean;
    innerHTML: string;
    innerText: string;
    inputMode: string;
    isConnected: boolean;
    isContentEditable: boolean;
    labels: NodeListOf<HTMLLabelElement>;
    lang: string;
    lastChild: ChildNode;
    lastElementChild: Element;
    list: HTMLDataListElement;
    localName: string;
    max: string;
    maxLength: number;
    min: string;
    minLength: number;
    multiple: boolean;
    name: string;
    namespaceURI: string;
    nextElementSibling: Element;
    nextSibling: ChildNode;
    nodeName: string;
    nodeType: number;
    nodeValue: string;
    nonce?: string;
    offsetHeight: number;
    offsetLeft: number;
    offsetParent: Element;
    offsetTop: number;
    offsetWidth: number;
    onabort: Object;
    onanimationcancel: Object;
    onanimationend: Object;
    onanimationiteration: Object;
    onanimationstart: Object;
    onauxclick: Object;
    onbeforeinput: Object;
    onblur: Object;
    oncancel: Object;
    oncanplay: Object;
    oncanplaythrough: Object;
    onchange: Object;
    onclick: Object;
    onclose: Object;
    oncontextmenu: Object;
    oncopy: Object;
    oncuechange: Object;
    oncut: Object;
    ondblclick: Object;
    ondrag: Object;
    ondragend: Object;
    ondragenter: Object;
    ondragleave: Object;
    ondragover: Object;
    ondragstart: Object;
    ondrop: Object;
    ondurationchange: Object;
    onemptied: Object;
    onended: Object;
    onerror: OnErrorEventHandlerNonNull;
    onfocus: Object;
    onformdata: Object;
    onfullscreenchange: Object;
    onfullscreenerror: Object;
    ongotpointercapture: Object;
    oninput: Object;
    oninvalid: Object;
    onkeydown: Object;
    onkeypress: Object;
    onkeyup: Object;
    onload: Object;
    onloadeddata: Object;
    onloadedmetadata: Object;
    onloadstart: Object;
    onlostpointercapture: Object;
    onmousedown: Object;
    onmouseenter: Object;
    onmouseleave: Object;
    onmousemove: Object;
    onmouseout: Object;
    onmouseover: Object;
    onmouseup: Object;
    onpaste: Object;
    onpause: Object;
    onplay: Object;
    onplaying: Object;
    onpointercancel: Object;
    onpointerdown: Object;
    onpointerenter: Object;
    onpointerleave: Object;
    onpointermove: Object;
    onpointerout: Object;
    onpointerover: Object;
    onpointerup: Object;
    onprogress: Object;
    onratechange: Object;
    onreset: Object;
    onresize: Object;
    onscroll: Object;
    onsecuritypolicyviolation: Object;
    onseeked: Object;
    onseeking: Object;
    onselect: Object;
    onselectionchange: Object;
    onselectstart: Object;
    onslotchange: Object;
    onstalled: Object;
    onsubmit: Object;
    onsuspend: Object;
    ontimeupdate: Object;
    ontoggle: Object;
    ontouchcancel?: Object;
    ontouchend?: Object;
    ontouchmove?: Object;
    ontouchstart?: Object;
    ontransitioncancel: Object;
    ontransitionend: Object;
    ontransitionrun: Object;
    ontransitionstart: Object;
    onvolumechange: Object;
    onwaiting: Object;
    onwebkitanimationend: Object;
    onwebkitanimationiteration: Object;
    onwebkitanimationstart: Object;
    onwebkittransitionend: Object;
    onwheel: Object;
    outerHTML: string;
    outerText: string;
    ownerDocument: Document;
    parentElement: HTMLElement;
    parentNode: ParentNode;
    part: DOMTokenList;
    pattern: string;
    placeholder: string;
    prefix: string;
    previousElementSibling: Element;
    previousSibling: ChildNode;
    readOnly: boolean;
    required: boolean;
    role: string;
    scrollHeight: number;
    scrollLeft: number;
    scrollTop: number;
    scrollWidth: number;
    selectionDirection: "none" | "forward" | "backward";
    selectionEnd: number;
    selectionStart: number;
    shadowRoot: ShadowRoot;
    size: number;
    slot: string;
    spellcheck: boolean;
    src: string;
    step: string;
    style: CSSStyleDeclaration;
    tabIndex: number;
    tagName: string;
    textContent: string;
    title: string;
    translate: boolean;
    type: string;
    useMap: string;
    validationMessage: string;
    validity: ValidityState;
    value: string;
    valueAsDate: Date;
    valueAsNumber: number;
    webkitEntries: readonly FileSystemEntry[];
    webkitdirectory: boolean;
    width: number;
    willValidate: boolean;
    addEventListener<K>(type, listener, options?): void;
    addEventListener(type, listener, options?): void;
    after(...nodes): void;
    animate(keyframes, options?): Animation;
    append(...nodes): void;
    appendChild<T>(node): T;
    attachInternals(): ElementInternals;
    attachShadow(init): ShadowRoot;
    before(...nodes): void;
    blur(): void;
    checkValidity(): boolean;
    checkVisibility(options?): boolean;
    click(): void;
    cloneNode(deep?): Node;
    closest<K>(selector): HTMLElementTagNameMap[K];
    closest<K>(selector): SVGElementTagNameMap[K];
    closest<K>(selector): MathMLElementTagNameMap[K];
    closest<E>(selectors): E;
    compareDocumentPosition(other): number;
    computedStyleMap(): StylePropertyMapReadOnly;
    contains(other): boolean;
    dispatchEvent(event): boolean;
    focus(options?): void;
    getAnimations(options?): Animation[];
    getAttribute(qualifiedName): string;
    getAttributeNS(namespace, localName): string;
    getAttributeNames(): string[];
    getAttributeNode(qualifiedName): Attr;
    getAttributeNodeNS(namespace, localName): Attr;
    getBoundingClientRect(): DOMRect;
    getClientRects(): DOMRectList;
    getElementsByClassName(classNames): HTMLCollectionOf<Element>;
    getElementsByTagName<K>(qualifiedName): HTMLCollectionOf<HTMLElementTagNameMap[K]>;
    getElementsByTagName<K>(qualifiedName): HTMLCollectionOf<SVGElementTagNameMap[K]>;
    getElementsByTagName<K>(qualifiedName): HTMLCollectionOf<MathMLElementTagNameMap[K]>;
    getElementsByTagName<K>(qualifiedName): HTMLCollectionOf<HTMLElementDeprecatedTagNameMap[K]>;
    getElementsByTagName(qualifiedName): HTMLCollectionOf<Element>;
    getElementsByTagNameNS(namespaceURI, localName): HTMLCollectionOf<HTMLElement>;
    getElementsByTagNameNS(namespaceURI, localName): HTMLCollectionOf<SVGElement>;
    getElementsByTagNameNS(namespaceURI, localName): HTMLCollectionOf<MathMLElement>;
    getElementsByTagNameNS(namespace, localName): HTMLCollectionOf<Element>;
    getRootNode(options?): Node;
    hasAttribute(qualifiedName): boolean;
    hasAttributeNS(namespace, localName): boolean;
    hasAttributes(): boolean;
    hasChildNodes(): boolean;
    hasPointerCapture(pointerId): boolean;
    insertAdjacentElement(where, element): Element;
    insertAdjacentHTML(position, text): void;
    insertAdjacentText(where, data): void;
    insertBefore<T>(node, child): T;
    isDefaultNamespace(namespace): boolean;
    isEqualNode(otherNode): boolean;
    isSameNode(otherNode): boolean;
    lookupNamespaceURI(prefix): string;
    lookupPrefix(namespace): string;
    matches(selectors): boolean;
    normalize(): void;
    prepend(...nodes): void;
    querySelector<K>(selectors): HTMLElementTagNameMap[K];
    querySelector<K>(selectors): SVGElementTagNameMap[K];
    querySelector<K>(selectors): MathMLElementTagNameMap[K];
    querySelector<K>(selectors): HTMLElementDeprecatedTagNameMap[K];
    querySelector<E>(selectors): E;
    querySelectorAll<K>(selectors): NodeListOf<HTMLElementTagNameMap[K]>;
    querySelectorAll<K>(selectors): NodeListOf<SVGElementTagNameMap[K]>;
    querySelectorAll<K>(selectors): NodeListOf<MathMLElementTagNameMap[K]>;
    querySelectorAll<K>(selectors): NodeListOf<HTMLElementDeprecatedTagNameMap[K]>;
    querySelectorAll<E>(selectors): NodeListOf<E>;
    releasePointerCapture(pointerId): void;
    remove(): void;
    removeAttribute(qualifiedName): void;
    removeAttributeNS(namespace, localName): void;
    removeAttributeNode(attr): Attr;
    removeChild<T>(child): T;
    removeEventListener<K>(type, listener, options?): void;
    removeEventListener(type, listener, options?): void;
    replaceChild<T>(node, child): T;
    replaceChildren(...nodes): void;
    replaceWith(...nodes): void;
    reportValidity(): boolean;
    requestFullscreen(options?): Promise<void>;
    requestPointerLock(): void;
    scroll(options?): void;
    scroll(x, y): void;
    scrollBy(options?): void;
    scrollBy(x, y): void;
    scrollIntoView(arg?): void;
    scrollTo(options?): void;
    scrollTo(x, y): void;
    select(): void;
    setAttribute(qualifiedName, value): void;
    setAttributeNS(namespace, qualifiedName, value): void;
    setAttributeNode(attr): Attr;
    setAttributeNodeNS(attr): Attr;
    setCustomValidity(error): void;
    setPointerCapture(pointerId): void;
    setRangeText(replacement): void;
    setRangeText(replacement, start, end, selectionMode?): void;
    setSelectionRange(start, end, direction?): void;
    showPicker(): void;
    stepDown(n?): void;
    stepUp(n?): void;
    toggleAttribute(qualifiedName, force?): boolean;
    webkitMatchesSelector(selectors): boolean;
}

Hierarchy (view full)

Properties

$bindAttributes? $bindItemStart? $bindStart? $destroyListeners? ATTRIBUTE_NODE CDATA_SECTION_NODE COMMENT_NODE DOCUMENT_FRAGMENT_NODE DOCUMENT_NODE DOCUMENT_POSITION_CONTAINED_BY DOCUMENT_POSITION_CONTAINS DOCUMENT_POSITION_DISCONNECTED DOCUMENT_POSITION_FOLLOWING DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC DOCUMENT_POSITION_PRECEDING DOCUMENT_TYPE_NODE ELEMENT_NODE ENTITY_NODE ENTITY_REFERENCE_NODE NOTATION_NODE PROCESSING_INSTRUCTION_NODE TEXT_NODE accept accessKey accessKeyLabel align alt ariaAtomic ariaAutoComplete ariaBusy ariaChecked ariaColCount ariaColIndex ariaColSpan ariaCurrent ariaDisabled ariaExpanded ariaHasPopup ariaHidden ariaInvalid ariaKeyShortcuts ariaLabel ariaLevel ariaLive ariaModal ariaMultiLine ariaMultiSelectable ariaOrientation ariaPlaceholder ariaPosInSet ariaPressed ariaReadOnly ariaRequired ariaRoleDescription ariaRowCount ariaRowIndex ariaRowSpan ariaSelected ariaSetSize ariaSort ariaValueMax ariaValueMin ariaValueNow ariaValueText assignedSlot attributeStyleMap attributes autocapitalize autocomplete autofocus baseURI capture checked childElementCount childNodes children classList className clientHeight clientLeft clientTop clientWidth contentEditable dataset defaultChecked defaultValue dir dirName disabled draggable enterKeyHint files firstChild firstElementChild form formAction formEnctype formMethod formNoValidate formTarget height hidden id indeterminate inert innerHTML innerText inputMode isConnected isContentEditable labels lang lastChild lastElementChild list localName max maxLength min minLength multiple name namespaceURI nextElementSibling nextSibling nodeName nodeType nodeValue nonce? offsetHeight offsetLeft offsetParent offsetTop offsetWidth onabort onanimationcancel onanimationend onanimationiteration onanimationstart onauxclick onbeforeinput onblur oncancel oncanplay oncanplaythrough onchange onclick onclose oncontextmenu oncopy oncuechange oncut ondblclick ondrag ondragend ondragenter ondragleave ondragover ondragstart ondrop ondurationchange onemptied onended onerror onfocus onformdata onfullscreenchange onfullscreenerror ongotpointercapture oninput oninvalid onkeydown onkeypress onkeyup onload onloadeddata onloadedmetadata onloadstart onlostpointercapture onmousedown onmouseenter onmouseleave onmousemove onmouseout onmouseover onmouseup onpaste onpause onplay onplaying onpointercancel onpointerdown onpointerenter onpointerleave onpointermove onpointerout onpointerover onpointerup onprogress onratechange onreset onresize onscroll onsecuritypolicyviolation onseeked onseeking onselect onselectionchange onselectstart onslotchange onstalled onsubmit onsuspend ontimeupdate ontoggle ontouchcancel? ontouchend? ontouchmove? ontouchstart? ontransitioncancel ontransitionend ontransitionrun ontransitionstart onvolumechange onwaiting onwebkitanimationend onwebkitanimationiteration onwebkitanimationstart onwebkittransitionend onwheel outerHTML outerText ownerDocument parentElement parentNode part pattern placeholder prefix previousElementSibling previousSibling readOnly required role scrollHeight scrollLeft scrollTop scrollWidth selectionDirection selectionEnd selectionStart shadowRoot size slot spellcheck src step style tabIndex tagName textContent title translate type useMap validationMessage validity value valueAsDate valueAsNumber webkitEntries webkitdirectory width willValidate

Methods

Properties

$bindAttributes?: AttributeBindingsMap
$bindItemStart?: RangeBinding
$bindStart?: RangeBinding
$destroyListeners?: any[]
ATTRIBUTE_NODE: 2
CDATA_SECTION_NODE: 4

node is a CDATASection node.

COMMENT_NODE: 8

node is a Comment node.

DOCUMENT_FRAGMENT_NODE: 11

node is a DocumentFragment node.

DOCUMENT_NODE: 9

node is a document.

DOCUMENT_POSITION_CONTAINED_BY: 16

Set when other is a descendant of node.

DOCUMENT_POSITION_CONTAINS: 8

Set when other is an ancestor of node.

DOCUMENT_POSITION_DISCONNECTED: 1

Set when node and other are not in the same tree.

DOCUMENT_POSITION_FOLLOWING: 4

Set when other is following node.

DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC: 32
DOCUMENT_POSITION_PRECEDING: 2

Set when other is preceding node.

DOCUMENT_TYPE_NODE: 10

node is a doctype.

ELEMENT_NODE: 1

node is an element.

ENTITY_NODE: 6
ENTITY_REFERENCE_NODE: 5
NOTATION_NODE: 12
PROCESSING_INSTRUCTION_NODE: 7

node is a ProcessingInstruction node.

TEXT_NODE: 3

node is a Text node.

accept: string

Sets or retrieves a comma-separated list of content types.

accessKey: string
accessKeyLabel: string
align: string

Sets or retrieves how the object is aligned with adjacent text.

Deprecated

alt: string

Sets or retrieves a text alternative to the graphic.

ariaAtomic: string
ariaAutoComplete: string
ariaBusy: string
ariaChecked: string
ariaColCount: string
ariaColIndex: string
ariaColSpan: string
ariaCurrent: string
ariaDisabled: string
ariaExpanded: string
ariaHasPopup: string
ariaHidden: string
ariaInvalid: string
ariaKeyShortcuts: string
ariaLabel: string
ariaLevel: string
ariaLive: string
ariaModal: string
ariaMultiLine: string
ariaMultiSelectable: string
ariaOrientation: string
ariaPlaceholder: string
ariaPosInSet: string
ariaPressed: string
ariaReadOnly: string
ariaRequired: string
ariaRoleDescription: string
ariaRowCount: string
ariaRowIndex: string
ariaRowSpan: string
ariaSelected: string
ariaSetSize: string
ariaSort: string
ariaValueMax: string
ariaValueMin: string
ariaValueNow: string
ariaValueText: string
assignedSlot: HTMLSlotElement
attributeStyleMap: StylePropertyMap
attributes: NamedNodeMap
autocapitalize: string
autocomplete: string

Specifies whether autocomplete is applied to an editable text field.

MDN Reference

autofocus: boolean
baseURI: string

Returns node's node document's document base URL.

MDN Reference

capture: string
checked: boolean

Sets or retrieves the state of the check box or radio button.

childElementCount: number
childNodes: NodeListOf<ChildNode>

Returns the children.

MDN Reference

children: HTMLCollection

Returns the child elements.

MDN Reference

classList: DOMTokenList

Allows for manipulation of element's class content attribute as a set of whitespace-separated tokens through a DOMTokenList object.

MDN Reference

className: string

Returns the value of element's class content attribute. Can be set to change it.

MDN Reference

clientHeight: number
clientLeft: number
clientTop: number
clientWidth: number
contentEditable: string
dataset: DOMStringMap
defaultChecked: boolean

Sets or retrieves the state of the check box or radio button.

defaultValue: string

Sets or retrieves the initial contents of the object.

dir: string
dirName: string
disabled: boolean
draggable: boolean
enterKeyHint: string
files: FileList

Returns a FileList object on a file type input object.

MDN Reference

firstChild: ChildNode

Returns the first child.

MDN Reference

firstElementChild: Element

Returns the first child that is an element, and null otherwise.

MDN Reference

Retrieves a reference to the form that the object is embedded in.

formAction: string

Overrides the action attribute (where the data on a form is sent) on the parent form element.

MDN Reference

formEnctype: string

Used to override the encoding (formEnctype attribute) specified on the form element.

MDN Reference

formMethod: string

Overrides the submit method attribute previously specified on a form element.

MDN Reference

formNoValidate: boolean

Overrides any validation or required attributes on a form or form elements to allow it to be submitted without validation. This can be used to create a "save draft"-type submit option.

MDN Reference

formTarget: string

Overrides the target attribute on a form element.

MDN Reference

height: number

Sets or retrieves the height of the object.

MDN Reference

hidden: boolean
id: string

Returns the value of element's id content attribute. Can be set to change it.

MDN Reference

indeterminate: boolean

When set, overrides the rendering of checkbox controls so that the current value is not visible.

MDN Reference

inert: boolean
innerHTML: string
innerText: string
inputMode: string
isConnected: boolean

Returns true if node is connected and false otherwise.

MDN Reference

isContentEditable: boolean
lang: string
lastChild: ChildNode

Returns the last child.

MDN Reference

lastElementChild: Element

Returns the last child that is an element, and null otherwise.

MDN Reference

Specifies the ID of a pre-defined datalist of options for an input element.

MDN Reference

localName: string

Returns the local name.

MDN Reference

max: string

Defines the maximum acceptable value for an input element with type="number".When used with the min and step attributes, lets you control the range and increment (such as only even numbers) that the user can enter into an input field.

maxLength: number

Sets or retrieves the maximum number of characters that the user can enter in a text control.

min: string

Defines the minimum acceptable value for an input element with type="number". When used with the max and step attributes, lets you control the range and increment (such as even numbers only) that the user can enter into an input field.

minLength: number
multiple: boolean

Sets or retrieves the Boolean value indicating whether multiple items can be selected from a list.

MDN Reference

name: string

Sets or retrieves the name of the object.

namespaceURI: string

Returns the namespace.

MDN Reference

nextElementSibling: Element

Returns the first following sibling that is an element, and null otherwise.

MDN Reference

nextSibling: ChildNode

Returns the next sibling.

MDN Reference

nodeName: string

Returns a string appropriate for the type of node.

MDN Reference

nodeType: number

Returns the type of node.

MDN Reference

nodeValue: string
nonce?: string
offsetHeight: number
offsetLeft: number
offsetParent: Element
offsetTop: number
offsetWidth: number
onabort: Object

Fires when the user aborts the download.

Param: ev

The event.

MDN Reference

onanimationcancel: Object
onanimationend: Object
onanimationiteration: Object
onanimationstart: Object
onauxclick: Object
onbeforeinput: Object
onblur: Object

Fires when the object loses the input focus.

Param: ev

The focus event.

MDN Reference

oncancel: Object
oncanplay: Object

Occurs when playback is possible, but would require further buffering.

Param: ev

The event.

MDN Reference

oncanplaythrough: Object
onchange: Object

Fires when the contents of the object or selection have changed.

Param: ev

The event.

MDN Reference

onclick: Object

Fires when the user clicks the left mouse button on the object

Param: ev

The mouse event.

MDN Reference

onclose: Object
oncontextmenu: Object

Fires when the user clicks the right mouse button in the client area, opening the context menu.

Param: ev

The mouse event.

MDN Reference

oncopy: Object
oncuechange: Object
oncut: Object
ondblclick: Object

Fires when the user double-clicks the object.

Param: ev

The mouse event.

MDN Reference

ondrag: Object

Fires on the source object continuously during a drag operation.

Param: ev

The event.

MDN Reference

ondragend: Object

Fires on the source object when the user releases the mouse at the close of a drag operation.

Param: ev

The event.

MDN Reference

ondragenter: Object

Fires on the target element when the user drags the object to a valid drop target.

Param: ev

The drag event.

MDN Reference

ondragleave: Object

Fires on the target object when the user moves the mouse out of a valid drop target during a drag operation.

Param: ev

The drag event.

MDN Reference

ondragover: Object

Fires on the target element continuously while the user drags the object over a valid drop target.

Param: ev

The event.

MDN Reference

ondragstart: Object

Fires on the source object when the user starts to drag a text selection or selected object.

Param: ev

The event.

MDN Reference

ondrop: Object
ondurationchange: Object

Occurs when the duration attribute is updated.

Param: ev

The event.

MDN Reference

onemptied: Object

Occurs when the media element is reset to its initial state.

Param: ev

The event.

MDN Reference

onended: Object

Occurs when the end of playback is reached.

Param: ev

The event

MDN Reference

Fires when an error occurs during object loading.

Param: ev

The event.

MDN Reference

onfocus: Object

Fires when the object receives focus.

Param: ev

The event.

MDN Reference

onformdata: Object
onfullscreenchange: Object
onfullscreenerror: Object
ongotpointercapture: Object
oninput: Object
oninvalid: Object
onkeydown: Object

Fires when the user presses a key.

Param: ev

The keyboard event

MDN Reference

onkeypress: Object

Fires when the user presses an alphanumeric key.

Param: ev

The event.

Deprecated

MDN Reference

onkeyup: Object

Fires when the user releases a key.

Param: ev

The keyboard event

MDN Reference

onload: Object

Fires immediately after the browser loads the object.

Param: ev

The event.

MDN Reference

onloadeddata: Object

Occurs when media data is loaded at the current playback position.

Param: ev

The event.

MDN Reference

onloadedmetadata: Object

Occurs when the duration and dimensions of the media have been determined.

Param: ev

The event.

MDN Reference

onloadstart: Object

Occurs when Internet Explorer begins looking for media data.

Param: ev

The event.

MDN Reference

onlostpointercapture: Object
onmousedown: Object

Fires when the user clicks the object with either mouse button.

Param: ev

The mouse event.

MDN Reference

onmouseenter: Object
onmouseleave: Object
onmousemove: Object

Fires when the user moves the mouse over the object.

Param: ev

The mouse event.

MDN Reference

onmouseout: Object

Fires when the user moves the mouse pointer outside the boundaries of the object.

Param: ev

The mouse event.

MDN Reference

onmouseover: Object

Fires when the user moves the mouse pointer into the object.

Param: ev

The mouse event.

MDN Reference

onmouseup: Object

Fires when the user releases a mouse button while the mouse is over the object.

Param: ev

The mouse event.

MDN Reference

onpaste: Object
onpause: Object

Occurs when playback is paused.

Param: ev

The event.

MDN Reference

onplay: Object

Occurs when the play method is requested.

Param: ev

The event.

MDN Reference

onplaying: Object

Occurs when the audio or video has started playing.

Param: ev

The event.

MDN Reference

onpointercancel: Object
onpointerdown: Object
onpointerenter: Object
onpointerleave: Object
onpointermove: Object
onpointerout: Object
onpointerover: Object
onpointerup: Object
onprogress: Object

Occurs to indicate progress while downloading media data.

Param: ev

The event.

MDN Reference

onratechange: Object

Occurs when the playback rate is increased or decreased.

Param: ev

The event.

MDN Reference

onreset: Object

Fires when the user resets a form.

Param: ev

The event.

MDN Reference

onresize: Object
onscroll: Object

Fires when the user repositions the scroll box in the scroll bar on the object.

Param: ev

The event.

MDN Reference

onsecuritypolicyviolation: Object
onseeked: Object

Occurs when the seek operation ends.

Param: ev

The event.

MDN Reference

onseeking: Object

Occurs when the current playback position is moved.

Param: ev

The event.

MDN Reference

onselect: Object

Fires when the current selection changes.

Param: ev

The event.

MDN Reference

onselectionchange: Object
onselectstart: Object
onslotchange: Object
onstalled: Object

Occurs when the download has stopped.

Param: ev

The event.

MDN Reference

onsubmit: Object
onsuspend: Object

Occurs if the load operation has been intentionally halted.

Param: ev

The event.

MDN Reference

ontimeupdate: Object

Occurs to indicate the current playback position.

Param: ev

The event.

MDN Reference

ontoggle: Object
ontouchcancel?: Object
ontouchend?: Object
ontouchmove?: Object
ontouchstart?: Object
ontransitioncancel: Object
ontransitionend: Object
ontransitionrun: Object
ontransitionstart: Object
onvolumechange: Object

Occurs when the volume is changed, or playback is muted or unmuted.

Param: ev

The event.

MDN Reference

onwaiting: Object

Occurs when playback stops because the next frame of a video resource is not available.

Param: ev

The event.

MDN Reference

onwebkitanimationend: Object

Deprecated

This is a legacy alias of onanimationend.

MDN Reference

onwebkitanimationiteration: Object

Deprecated

This is a legacy alias of onanimationiteration.

MDN Reference

onwebkitanimationstart: Object

Deprecated

This is a legacy alias of onanimationstart.

MDN Reference

onwebkittransitionend: Object

Deprecated

This is a legacy alias of ontransitionend.

MDN Reference

onwheel: Object
outerHTML: string
outerText: string
ownerDocument: Document

Returns the node document. Returns null for documents.

MDN Reference

parentElement: HTMLElement

Returns the parent element.

MDN Reference

parentNode: ParentNode

Returns the parent.

MDN Reference

pattern: string

Gets or sets a string containing a regular expression that the user's input must match.

MDN Reference

placeholder: string

Gets or sets a text string that is displayed in an input field as a hint or prompt to users as the format or type of information they need to enter.The text appears in an input field until the user puts focus on the field.

MDN Reference

prefix: string

Returns the namespace prefix.

MDN Reference

previousElementSibling: Element

Returns the first preceding sibling that is an element, and null otherwise.

MDN Reference

previousSibling: ChildNode

Returns the previous sibling.

MDN Reference

readOnly: boolean
required: boolean

When present, marks an element that can't be submitted without a value.

MDN Reference

role: string
scrollHeight: number
scrollLeft: number
scrollTop: number
scrollWidth: number
selectionDirection: "none" | "forward" | "backward"
selectionEnd: number

Gets or sets the end position or offset of a text selection.

selectionStart: number

Gets or sets the starting position or offset of a text selection.

shadowRoot: ShadowRoot

Returns element's shadow root, if any, and if shadow root's mode is "open", and null otherwise.

MDN Reference

size: number
slot: string

Returns the value of element's slot content attribute. Can be set to change it.

MDN Reference

spellcheck: boolean
src: string

The address or URL of the a media resource that is to be considered.

step: string

Defines an increment or jump between values that you want to allow the user to enter. When used with the max and min attributes, lets you control the range and increment (for example, allow only even numbers) that the user can enter into an input field.

tabIndex: number
tagName: string

Returns the HTML-uppercased qualified name.

MDN Reference

textContent: string
title: string
translate: boolean
type: string

Returns the content type of the object.

useMap: string

Sets or retrieves the URL, often with a bookmark extension (#name), to use as a client-side image map.

Deprecated

validationMessage: string

Returns the error message that would be displayed if the user submits the form, or an empty string if no error message. It also triggers the standard error message, such as "this is a required field". The result is that the user sees validation messages without actually submitting.

MDN Reference

validity: ValidityState

Returns a ValidityState object that represents the validity states of an element.

MDN Reference

value: string

Returns the value of the data at the cursor's current position.

valueAsDate: Date

Returns a Date object representing the form control's value, if applicable; otherwise, returns null. Can be set, to change the value. Throws an "InvalidStateError" DOMException if the control isn't date- or time-based.

valueAsNumber: number

Returns the input field value as a number.

webkitEntries: readonly FileSystemEntry[]
webkitdirectory: boolean
width: number

Sets or retrieves the width of the object.

MDN Reference

willValidate: boolean

Returns whether an element will successfully validate based on forms validation rules and constraints.

MDN Reference

Methods

  • Appends an event listener for events whose type attribute value is type. The callback argument sets the callback that will be invoked when the event is dispatched.

    The options argument sets listener-specific options. For compatibility this can be a boolean, in which case the method behaves exactly as if the value was specified as options's capture.

    When set to true, options's capture prevents callback from being invoked when the event's eventPhase attribute value is BUBBLING_PHASE. When false (or not present), callback will not be invoked when event's eventPhase attribute value is CAPTURING_PHASE. Either way, callback will be invoked if event's eventPhase attribute value is AT_TARGET.

    When set to true, options's passive indicates that the callback will not cancel the event by invoking preventDefault(). This is used to enable performance optimizations described in § 2.8 Observing event listeners.

    When set to true, options's once indicates that the callback will only be invoked once after which the event listener will be removed.

    If an AbortSignal is passed for options's signal, then the event listener will be removed when signal is aborted.

    The event listener is appended to target's event listener list and is not appended if it has the same type, callback, and capture.

    MDN Reference

    Type Parameters

    Parameters

    Returns void

  • Parameters

    Returns void

  • Inserts nodes just after node, while replacing strings in nodes with equivalent Text nodes.

    Throws a "HierarchyRequestError" DOMException if the constraints of the node tree are violated.

    MDN Reference

    Parameters

    • Rest ...nodes: (string | Node)[]

    Returns void

  • Inserts nodes after the last child of node, while replacing strings in nodes with equivalent Text nodes.

    Throws a "HierarchyRequestError" DOMException if the constraints of the node tree are violated.

    MDN Reference

    Parameters

    • Rest ...nodes: (string | Node)[]

    Returns void

  • Inserts nodes just before node, while replacing strings in nodes with equivalent Text nodes.

    Throws a "HierarchyRequestError" DOMException if the constraints of the node tree are violated.

    MDN Reference

    Parameters

    • Rest ...nodes: (string | Node)[]

    Returns void

  • Returns whether a form will validate when it is submitted, without having to submit it.

    MDN Reference

    Returns boolean

  • Returns a copy of node. If deep is true, the copy also includes the node's descendants.

    MDN Reference

    Parameters

    • Optional deep: boolean

    Returns Node

  • Returns a bitmask indicating the position of other relative to node.

    MDN Reference

    Parameters

    Returns number

  • Returns true if other is an inclusive descendant of node, and false otherwise.

    MDN Reference

    Parameters

    Returns boolean

  • Dispatches a synthetic event event to target and returns true if either event's cancelable attribute value is false or its preventDefault() method was not invoked, and false otherwise.

    MDN Reference

    Parameters

    Returns boolean

  • Returns element's first attribute whose qualified name is qualifiedName, and null if there is no such attribute otherwise.

    MDN Reference

    Parameters

    • qualifiedName: string

    Returns string

  • Returns element's attribute whose namespace is namespace and local name is localName, and null if there is no such attribute otherwise.

    MDN Reference

    Parameters

    • namespace: string
    • localName: string

    Returns string

  • Returns the qualified names of all element's attributes. Can contain duplicates.

    MDN Reference

    Returns string[]

  • Returns a HTMLCollection of the elements in the object on which the method was invoked (a document or an element) that have all the classes given by classNames. The classNames argument is interpreted as a space-separated list of classes.

    MDN Reference

    Parameters

    • classNames: string

    Returns HTMLCollectionOf<Element>

  • Returns true if element has an attribute whose qualified name is qualifiedName, and false otherwise.

    MDN Reference

    Parameters

    • qualifiedName: string

    Returns boolean

  • Returns true if element has an attribute whose namespace is namespace and local name is localName.

    MDN Reference

    Parameters

    • namespace: string
    • localName: string

    Returns boolean

  • Returns true if element has attributes, and false otherwise.

    MDN Reference

    Returns boolean

  • Returns whether node has children.

    MDN Reference

    Returns boolean

  • Returns whether node and otherNode have the same properties.

    MDN Reference

    Parameters

    Returns boolean

  • Parameters

    • namespace: string

    Returns string

  • Returns true if matching selectors against element's root yields element, and false otherwise.

    MDN Reference

    Parameters

    • selectors: string

    Returns boolean

  • Removes empty exclusive Text nodes and concatenates the data of remaining contiguous exclusive Text nodes into the first of their nodes.

    MDN Reference

    Returns void

  • Inserts nodes before the first child of node, while replacing strings in nodes with equivalent Text nodes.

    Throws a "HierarchyRequestError" DOMException if the constraints of the node tree are violated.

    MDN Reference

    Parameters

    • Rest ...nodes: (string | Node)[]

    Returns void

  • Removes element's first attribute whose qualified name is qualifiedName.

    MDN Reference

    Parameters

    • qualifiedName: string

    Returns void

  • Removes element's attribute whose namespace is namespace and local name is localName.

    MDN Reference

    Parameters

    • namespace: string
    • localName: string

    Returns void

  • Replace all children of node with nodes, while replacing strings in nodes with equivalent Text nodes.

    Throws a "HierarchyRequestError" DOMException if the constraints of the node tree are violated.

    MDN Reference

    Parameters

    • Rest ...nodes: (string | Node)[]

    Returns void

  • Replaces node with nodes, while replacing strings in nodes with equivalent Text nodes.

    Throws a "HierarchyRequestError" DOMException if the constraints of the node tree are violated.

    MDN Reference

    Parameters

    • Rest ...nodes: (string | Node)[]

    Returns void

  • Returns boolean

  • Displays element fullscreen and resolves promise when done.

    When supplied, options's navigationUI member indicates whether showing navigation UI while in fullscreen is preferred or not. If set to "show", navigation simplicity is preferred over screen space, and if set to "hide", more screen space is preferred. User agents are always free to honor user preference over the application's. The default value "auto" indicates no application preference.

    MDN Reference

    Parameters

    Returns Promise<void>

  • Parameters

    Returns void

  • Parameters

    • x: number
    • y: number

    Returns void

  • Parameters

    Returns void

  • Parameters

    • x: number
    • y: number

    Returns void

  • Parameters

    Returns void

  • Parameters

    • x: number
    • y: number

    Returns void

  • Makes the selection equal to the current object.

    MDN Reference

    Returns void

  • Sets the value of element's first attribute whose qualified name is qualifiedName to value.

    MDN Reference

    Parameters

    • qualifiedName: string
    • value: string

    Returns void

  • Sets the value of element's attribute whose namespace is namespace and local name is localName to value.

    MDN Reference

    Parameters

    • namespace: string
    • qualifiedName: string
    • value: string

    Returns void

  • Sets a custom error message that is displayed when a form is submitted.

    Parameters

    • error: string

      Sets a custom error message that is displayed when a form is submitted.

      MDN Reference

    Returns void

  • Parameters

    • replacement: string

    Returns void

  • Parameters

    • replacement: string
    • start: number
    • end: number
    • Optional selectionMode: SelectionMode

    Returns void

  • Sets the start and end positions of a selection in a text field.

    Parameters

    • start: number

      The offset into the text field for the start of the selection.

    • end: number

      The offset into the text field for the end of the selection.

    • Optional direction: "none" | "forward" | "backward"

      The direction in which the selection is performed.

      MDN Reference

    Returns void

  • Returns void

  • Decrements a range input control's value by the value given by the Step attribute. If the optional parameter is used, it will decrement the input control's step value multiplied by the parameter's value.

    Parameters

    • Optional n: number

      Value to decrement the value by.

      MDN Reference

    Returns void

  • Increments a range input control's value by the value given by the Step attribute. If the optional parameter is used, will increment the input control's value by that value.

    Parameters

    • Optional n: number

      Value to increment the value by.

      MDN Reference

    Returns void

  • If force is not given, "toggles" qualifiedName, removing it if it is present and adding it if it is not present. If force is true, adds qualifiedName. If force is false, removes qualifiedName.

    Returns true if qualifiedName is now present, and false otherwise.

    MDN Reference

    Parameters

    • qualifiedName: string
    • Optional force: boolean

    Returns boolean

  • Parameters

    • selectors: string

    Returns boolean

    Deprecated

    This is a legacy alias of matches.

    MDN Reference