HTMLButtonElement

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Интерфейс HTMLButtonElement предоставляет свойства и методы для управления элементами <button> (помимо обычного интерфейса HTMLElement, он также доступен - по наследованию) .

Свойства

Наследует свойства от его родителя, HTMLElement.

Имя Тип Описание
accessKey DOMString Определённая кнопка клавиатуры, дающая доступ к кнопке.
autofocus Boolean Управление должно получить фокус ввода при загрузки страницы, пока пользователь не отменяет его, например, набирая на клавиатуре в другом контроле. Только один форма-ассоциированный элемент в документе может иметь указанный атрибут.
disabled Boolean Контроль выключен, что означает, он не принимает любых кликов.
form Только для чтения HTMLFormElement Форма этой кнопки связана с ней. Если кнопка потомок элемента формы, то этот атрибут ID этого элемента формы.
Если форма не связана с формой элемента, то атрибут может быть ID любой формы элемента в том же документе, или значение null если нет совпадений.
formAction DOMString

URI ресурса, обрабатывающего информацию, отправленную кнопкой. Если задан, то переопределяет action атрибут <form> элемента, который является его владельцем.

formEncType DOMString Тип содержимого, используемый для отправки формы на сервер. Если указан этот атрибут, то он переопределяет enctype атрибут элемента <form>, который является владельцем этого элемента.
formMethod DOMString

HTTP метод, который браузер использует для отправки формы. Если задан, тогда он переопределяет method атрибут <form> своего владельца.

formNoValidate Boolean

Показывает что форма не будет проверена при отправке. Если задано, тогда переопределяет novalidate атрибут <form> своего владельца.

formTarget DOMString

Имя или ключевое слово, указывающее, где должен отображаться ответ, полученный после отправки формы. Если задано, тогда переопределяет target атрибут <form> своего владельца.

labels Только для чтения NodeList Список элементов <label>, которые являются метками для этой кнопки.
menu HTMLMenuElement Элемент меню, который будет отображаться, если кнопка нажата и имеет тип type="menu".
name DOMString

Имя объекта отправляемое с формой. Если задано, не должно быть пустой строкой.

tabIndex long

Номер, представляющий последовательность перехода между полями при нажатии на Tab

type DOMString

Указывает поведение кнопки. Это перечисляемый атрибут со следующими возможными значениями:

  • "submit": Кнопка отправки формы. Это значение по умолчанию, если атрибут не определён, или если он динамически изменяется на пустое или недопустимое значение.
  • "reset": Кнопка сброса формы.
  • "button": Кнопка с неопределённым действием.
  • "menu": Кнопка показывающая меню (экспериментальная).
validationMessage Только для чтения DOMString

A localized message that describes the validation constraints that the control does not satisfy (if any). This attribute is the empty string if the control is not a candidate for constraint validation (willValidate is false), or it satisfies its constraints.

validity Только для чтения ValidityState The validity states that this button is in.
value DOMString The current form control value of the button.
willValidate Boolean Indicates whether the button is a candidate for constraint validation. It is false if any conditions bar it from constraint validation.

Methods

Наследует свойства от его родителя, HTMLElement.

Name Return Type Description
checkValidity() Boolean Not supported for button elements.
setCustomValidity(in DOMString error) void Not supported for button elements.

WIth Gecko-based browser, use the :-moz-submit-invalid pseudo-class to style submit buttons based on the validation of a form.

Спецификации

Specification
HTML Standard
# htmlbuttonelement

Совместимость с браузерами

BCD tables only load in the browser

Смотрите также

  • HTML element implementing this interface: <button>