<button>
Описание
HTML-элемент <button>
создаёт кликабельную кнопку, которая может быть использована в формах или в любом другом месте документа, который требует простой, стандартной кнопки. По умолчанию, кнопки HTML обычно представлены в стиле, аналогичном стилю хост-платформы, на которой работает user agent, но вы можете изменить внешний вид кнопки, используя CSS.
Категории контента | Общий поток, текстовый контент, интерактивный контент, listed, labelable, и submittable form-associated элемент, очевидный контент. |
---|---|
Разрешённый контент | Текстовый контент. |
Tag omission | Нет, открывающий и закрывающий теги обязательны. |
Разрешённый родительский контент | Любой элемент с поддержкой текстового контента. |
Разрешённые роли ARIA |
|
DOM interface | HTMLButtonElement |
Тип | Строчный |
Атрибуты
Элемент поддерживает глобальные атрибуты.
autofocus
HTML5- Данный булевый атрибут позволяет указать, будет ли кнопка автоматически сфокусирована после загрузки страницы, до тех пор, пока пользователь не изменит фокус в ручную, например выбрав другой элемент. Только один связанный с формой элемент в документе может иметь данный атрибут.
autocomplete
- Использование данного атрибута на элементе
<button>
не описано в стандарте и используется только в Firefox браузере. По умолчанию, в отличие от прочих браузеров, Firefox сохраняет назначенное динамически отключённое состояние для элемента<button>
при последующих загрузках страницы. Установка для данного атрибута значенияoff
отключает подобное поведение. Смотрите баг 654072. disabled
-
Булевый атрибут, указывающий, что пользователь не может взаимодействовать с кнопкой. Если атрибут не установлен, то кнопка наследует его от элемента-контейнера, в котором она расположена, например от
<fieldset>
; если отсутствует элемент-контейнер, с установленным атрибутом disabled, то кнопка доступна для взаимодействия.Firefox по умолчанию, в отличие от прочих браузеров, сохраняет назначенное динамически отключённое состояние для элемента
<button>
, даже при обновлении страницы. Чтобы изменить поведение браузера в этом случае, используйте атрибутautocomplete
. form
HTML5- Атрибут form позволяет указать элемент
<form>
, с которым связана кнопка. Данный атрибут должен хранить значение id элемента<form>
. Если данный атрибут не установлен, то элемент<button>
будет связан с родительским элементом<form>
, если последний существует. - Атрибут работает независимо от расположения элементов в документе, поэтому он позволяет связать элемент
<button>
с формой, даже в случае, если<button>
не является наследником элемента<form>
. formaction
HTML5- Ссылка на обработчик формы. Если атрибут определён — он переопределит атрибут
action
у формы-родителя. formenctype
HTML5- Если
button
имеет типsubmit
, то этот атрибут определяет тип контента, отправляемого на сервер. Возможные значения данного атрибута:application/x-www-form-urlencoded
: значение по умолчанию, если атрибут не указан.multipart/form-data
: следует использовать это значение, если форма содержит элемент<input>
со значением атрибутаtype
file
.text/plain
Если этот атрибут определён, он переопределяет атрибут
enctype
у формы-родителя. formmethod
HTML5- Если
button
имеет типsubmit
, то этот атрибут определяет метод HTTP-запроса для отправки данных на сервер. Возможные варианты:post
: данные формы включаются в тело сообщения и отправляются на сервер.get
: данные формы отправляются на сервер в виде ссылки, состоящей из URI атрибутаaction
и непосредственно данных, отделённых знаком '?'. Данные формы будут иметь вид ключ/значение и разделены амперсандом, например name=Name&id=35. Следует использовать этот метод только если нет побочных эффектов и данные формы содержат лишь ASCII-символы.
Если этот атрибут определён, он переопределяет атрибут
method
у формы-родителя. formnovalidate
HTML5- Булевый атрибут. Указывает, что данные формы не будут валидироваться при отправке.
- Если этот атрибут определён, он переопределяет атрибут
novalidate
у формы-родителя. formtarget
HTML5- Если
button
имеет типsubmit
, этот атрибут является именем или ключевым словом,указывающим, где отображать ответ, полученный после отправки формы. This is a name of, or keyword for, a browsing context (for example, tab, window, or inline frame). If this attribute is specified, it overrides the
target
attribute of the button's form owner. The following keywords have special meanings:_self
: Load the response into the same browsing context as the current one. This value is the default if the attribute is not specified._blank
: Load the response into a new unnamed browsing context._parent
: Load the response into the parent browsing context of the current one. If there is no parent, this option behaves the same way as_self
._top
: Load the response into the top-level browsing context (that is, the browsing context that is an ancestor of the current one, and has no parent). If there is no parent, this option behaves the same way as_self
.
name
- The name of the button, which is submitted with the form data.
type
- The type of the button. Possible values are:
submit
: The button submits the form data to the server. This is the default if the attribute is not specified, or if the attribute is dynamically changed to an empty or invalid value.reset
: The button resets all the controls to their initial values.button
: The button has no default behavior. It can have client-side scripts associated with the element's events, which are triggered when the events occur.- menu: The button opens a popup menu defined via its designated
<menu>
element.
value
- The initial value of the button.
Пример
<button name="button">Тык!</button>
Clicking and focus
Whether clicking on a <button>
causes it to (by default) become focused varies by browser and OS. The results for <input>
of type="button"
and type="submit"
are the same.
Desktop Browsers | Windows 8.1 | OS X 10.X |
---|---|---|
Firefox | Yes - Firefox 30.0 | No (even with a tabindex ) Firefox 63 |
Chrome | Yes - Chrome 35 | Yes - Chrome 65 |
Safari | N/A | No (even with a tabindex ) Safari 12 (bug 22261) |
Internet Explorer | Yes - Internet Explorer 11 | N/A |
Presto | Yes - Opera 12 | Yes - Opera 12 |
Mobile Browsers | iOS 7.1.2 | Android 4.4.4 |
---|---|---|
Safari Mobile | No (even with a tabindex ) |
N/A |
Chrome 35 | No (even with a tabindex ) |
Yes |
Спецификации
Specification |
---|
HTML Standard (HTML) # the-button-element |
Browser compatibility
BCD tables only load in the browser