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.

* Some parts of this feature may have varying levels of support.

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

must be a string

Свойства

Наследует свойства от его родителя, 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
# htmlbuttonelement

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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
HTMLButtonElement
checkValidity
command
Experimental
commandForElement
Experimental
disabled
form
formAction
formEnctype
formMethod
formNoValidate
formTarget
labels
name
popoverTargetAction
popoverTargetElement
Implicit anchor reference via popoverTargetElement
Experimental
reportValidity
setCustomValidity
type
validationMessage
validity
value
willValidate

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
In development. Supported in a pre-release version.
In development. Supported in a pre-release version.
No support
No support
Experimental. Expect behavior to change in the future.
See implementation notes.
User must explicitly enable this feature.

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

  • HTML element implementing this interface: <button>