HTMLButtonElement

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

Свойства

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

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

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

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

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

Имя или ключевое слово, указывающее, где должен отображаться ответ, полученный после отправки формы. Если задано, тогда  переопределяет target атрибут <form> своего владельца.
labels Только для чтения NodeList Список элементов <label>, которые являются метками для этой кнопки.
menu  Это экспериментальное API, которое не должно использоваться в рабочем коде. HTMLMenuElement (en-US) Элемент меню, который будет отображаться, если кнопка нажата и имеет тип type="menu".
name DOMString

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

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

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

  • "submit": Кнопка отправки формы. Это значение по умолчанию, если атрибут не определён, HTML5 или если он динамически изменяется на пустое или недопустимое значение.
  • "reset": Кнопка сброса формы.
  • "button": Кнопка с неопределённым действием.
  • "menu":  Кнопка показывающая меню (экспериментальная). Это экспериментальное API, которое не должно использоваться в рабочем коде.
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 (en-US) The validity states that this button is in.
value DOMString The current form control value of the button.
willValidate Boolean (en-US) 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 (en-US) Not supported for button elements.
setCustomValidity(in DOMString error) void Not supported for button elements.

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

Specifications

Specification Status Comment
HTML Living Standard
Определение 'HTMLAnchorElement' в этой спецификации.		 Живой стандарт The following attribute has been added: menu.
The type attribute can take one more value, "menu".
HTML5
Определение 'HTMLAnchorElement' в этой спецификации.		 Рекомендация The attributes tabindex and accesskey, are now defined on HTMLElement.
The following attributes have been added: autofocus, formAction, formEncType, formMethod, formNoValidate, formTarget, labels, validity, validationMessage, and willValidate.
The following methods have been added: checkValidity(), setCustomValidity().
The type attribute is no more read-only.
Document Object Model (DOM) Level 2 HTML Specification
Определение 'HTMLAnchorElement' в этой спецификации.		 Устаревшая No change from Document Object Model (DOM) Level 1 Specification.
Document Object Model (DOM) Level 1 Specification
Определение 'HTMLAnchorElement' в этой спецификации.		 Устаревшая Initial definition.

Browser compatibility

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help! (en-US)

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support (Да) 1.0 (1.7 или ранее) (Да) (Да) (Да)
Form-related attributes (Да) 4.0 (2.0) (Да) (Да) (Да)
labels (Да) Нет Не реализовано (смотрите баг 556743) ? ? ?
menu & type="menu"  Это экспериментальное API, которое не должно использоваться в рабочем коде. Нет Нет Нет Нет Нет
Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support (Да) 1.0 (1.0) (Да) (Да) (Да)
Form-related attributes (Да) 4.0 (2.0) (Да) (Да) (Да)
labels (Да) НетНе реализовано (смотрите баг 556743) ? ? ?
menu & type="menu"  Это экспериментальное API, которое не должно использоваться в рабочем коде. Нет Нет Нет Нет Нет

See also

  • HTML element implementing this interface: <button>