Skip to main content
Deno 2 is finally here 🎉️
Learn more
Module

x/evt/lib/index.ts>dom.HTMLInputElement

💧EventEmitter's typesafe replacement
Go to Latest
interface dom.HTMLInputElement
implements HTMLElement
import { type dom } from "https://deno.land/x/evt@v2.4.16/lib/index.ts";
const { HTMLInputElement } = dom;

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

Properties

accept: string

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

deprecated
align: string
alt: string

Sets or retrieves a text alternative to the graphic.

autocomplete: string

Specifies whether autocomplete is applied to an editable text field.

checked: boolean

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

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.

dirName: string
disabled: boolean
files: FileList | null

Returns a FileList object on a file type input object.

readonly
form: HTMLFormElement | null

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.

formEnctype: string

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

formMethod: string

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

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.

formTarget: string

Overrides the target attribute on a form element.

height: number

Sets or retrieves the height of the object.

indeterminate: boolean
readonly
labels: NodeListOf<HTMLLabelElement> | null
readonly
list: HTMLElement | null

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

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.

name: string

Sets or retrieves the name of the object.

pattern: string

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

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.

readOnly: boolean
required: boolean

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

selectionDirection:
| "forward"
| "backward"
| "none"
| null
selectionEnd: number | null

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

selectionStart: number | null

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

size: number
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.

type: string

Returns the content type of the object.

deprecated
useMap: string
readonly
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.

readonly
validity: ValidityState

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

value: string

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

valueAsDate: Date | null

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.

width: number

Sets or retrieves the width of the object.

readonly
willValidate: boolean

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

Methods

checkValidity(): boolean

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

reportValidity(): boolean
select(): void

Makes the selection equal to the current object.

setCustomValidity(error: string): void

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

setRangeText(replacement: string): void
setRangeText(
replacement: string,
start: number,
end: number,
selectionMode?: SelectionMode,
): void
setSelectionRange(
start: number,
end: number,
direction?: "forward" | "backward" | "none",
): void

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

stepDown(n?: number): 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.

stepUp(n?: number): 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.

addEventListener<K extends keyof HTMLElementEventMap>(
type: K,
listener: (this: HTMLInputElement, ev: HTMLElementEventMap[K]) => any,
options?: boolean | AddEventListenerOptions,
): void
addEventListener(
type: string,
options?: boolean | AddEventListenerOptions,
): void
removeEventListener<K extends keyof HTMLElementEventMap>(
type: K,
listener: (this: HTMLInputElement, ev: HTMLElementEventMap[K]) => any,
options?: boolean | EventListenerOptions,
): void
removeEventListener(
type: string,
options?: boolean | EventListenerOptions,
): void