Movatterモバイル変換


[0]ホーム

URL:


  1. Веб-технологии для разработчиков
  2. HTML
  3. Справка по HTML
  4. Элемент
  5. <button>

This page was translated from English by the community.Learn more and join the MDN Web Docs community.

View in EnglishAlways switch to English

<button> - элемент кнопки

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨июль 2015 г.⁩.

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

Описание

HTML-элемент<button> создаёт кликабельную кнопку, которая может быть использована в формах или в любом другом месте документа, который требует простой, стандартной кнопки. По умолчанию, кнопки HTML обычно представлены в стиле, аналогичном стилю хост-платформы, на которой работаетuser agent, но вы можете изменить внешний вид кнопки, используя CSS.

Категории контентаОбщий поток,текстовый контент,интерактивный контент,listed,labelable, иsubmittableform-associated элемент, очевидный контент.
Допустимое содержимоеТекстовый контент.
Пропуск теговНет, открывающий и закрывающий теги обязательны.
Допустимые родителиЛюбой элемент с поддержкойтекстового контента.
Допустимые ARIA-ролиcheckbox,link,menuitem,menuitemcheckbox,menuitemradio,radio,switch,tab
DOM-интерфейсHTMLButtonElement

Атрибуты

Элемент поддерживаетглобальные атрибуты.

autofocus

Данный булевый атрибут позволяет указать, будет ли кнопка автоматически сфокусирована после загрузки страницы, до тех пор, пока пользователь не изменит фокус в ручную, например выбрав другой элемент. Только один связанный с формой элемент в документе может иметь данный атрибут.

autocompleteНе стандартно

Использование данного атрибута на элементе<button> не описано в стандарте и используется только в Firefox браузере. По умолчанию, в отличие от прочих браузеров,Firefox сохраняет назначенное динамически отключённое состояние для элемента<button> при последующих загрузках страницы. Установка для данного атрибута значенияoff отключает подобное поведение. СмотритеFirefox bug 654072.

disabled

Булевый атрибут, указывающий, что пользователь не может взаимодействовать с кнопкой. Если атрибут не установлен, то кнопка наследует его от элемента-контейнера, в котором она расположена, например от<fieldset>; если отсутствует элемент-контейнер, с установленным атрибутомdisabled, то кнопка доступна для взаимодействия.Firefox по умолчанию, в отличие от прочих браузеров,сохраняет назначенное динамически отключённое состояние для элемента<button>, даже при обновлении страницы. Чтобы изменить поведение браузера в этом случае, используйте атрибутautocomplete.

form

Атрибутform позволяет указать элемент<form>, с которым связана кнопка. Данный атрибут должен хранить значениеid элемента<form>. Если данный атрибут не установлен, то элемент<button> будет связан с родительским элементом<form>, если последний существует.Атрибут работает независимо от расположения элементов в документе, поэтому он позволяет связать элемент<button> с формой, даже в случае, если<button> не является наследником элемента<form>.

formaction

Ссылка на обработчик формы. Если атрибут определён — он переопределит атрибутaction у формы-родителя.

formenctype

Еслиbutton имеет типsubmit, то этот атрибут определяет тип контента, отправляемого на сервер. Возможные значения данного атрибута:

  • application/x-www-form-urlencoded: значение по умолчанию, если атрибут не указан.
  • multipart/form-data: следует использовать это значение, если форма содержит элемент<input> со значением атрибутаtypefile.
  • text/plain Если этот атрибут определён, он переопределяет атрибутenctype у формы-родителя.
formmethod

Еслиbutton имеет типsubmit, то этот атрибут определяет метод HTTP-запроса для отправки данных на сервер. Возможные варианты:

  • post: данные формы включаются в тело сообщения и отправляются на сервер.
  • get: данные формы отправляются на сервер в виде ссылки, состоящей из URI атрибутаaction и непосредственно данных, отделённых знаком '?'. Данные формы будут иметь вид ключ/значение и разделены амперсандом, например name=Name&id=35. Следует использовать этот метод только если нет побочных эффектов и данные формы содержат лишь ASCII-символы.Если этот атрибут определён, он переопределяет атрибутmethod у формы-родителя.
formnovalidate

Булевый атрибут. Указывает, что данные формы не будут валидироваться при отправке.Если этот атрибут определён, он переопределяет атрибутnovalidate у формы-родителя.

formtarget

Еслиbutton имеет типsubmit, этот атрибут является именем или ключевым словом,указывающим, где отображать ответ, полученный после отправки формы. This is a name of, or keyword for, abrowsing context (for example, tab, window, or inline frame). If this attribute is specified, it overrides thetarget 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

Название кнопки, которая отправляется вместе с данными формы.

type

Устанавливает тип кнопки. Доступные значения:

  • submit: Кнопка отправляет данные формы на сервер. Это значение по умолчанию, если атрибут не указан или если атрибут динамически изменен на пустое или недопустимое значение.
  • reset: Кнопка сбрасывает все элементы управления к их начальным значениям. Удаляет данные, введенные в форму.
  • button: Кнопка не имеет поведения по умолчанию. При этом на странице могут быть скрипты, активируемые при возникновении определённых событий на кнопке.
  • menu: Кнопка открывает всплывающее меню, определяемое с помощью соответствующего<menu> элемента.
value

Начальное значение кнопки.

Пример

html
<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> oftype="button" andtype="submit" are the same.

Desktop BrowsersWindows 8.1OS X 10.X
FirefoxYes - Firefox 30.0No (even with atabindex) Firefox 63
ChromeYes - Chrome 35Yes - Chrome 65
SafariN/ANo (even with atabindex) Safari 12 (bug 22261)
Internet ExplorerYes - Internet Explorer 11N/A
PrestoYes - Opera 12Yes - Opera 12
Mobile BrowsersiOS 7.1.2Android 4.4.4
Safari MobileNo (even with atabindex)N/A
Chrome 35No (even with atabindex)Yes

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

Specification
HTML
# the-button-element

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

Help improve MDN

Learn how to contribute

This page was last modified on byMDN contributors.


[8]ページ先頭

©2009-2025 Movatter.jp