HTMLButtonElement

Базовая Широко доступная *

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

* Некоторые части этой функции могут иметь различный уровень поддержки.

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

Свойства экземпляра

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

HTMLButtonElement.disabled

Булево значение, указывающее, отключен ли элемент управления, то есть не принимает щелчки.

HTMLButtonElement.form Только для чтения

Объект HTMLFormElement, отражающий форму, к которой привязан этот элемент. Если кнопка является потомком элемента формы, то этот атрибут является ссылкой на соответствующую HTMLFormElement. Если кнопка не является потомком элемента формы, то атрибут может ссылаться на любой HTMLFormElement элемент в том же документе, к которому она относится, или на значение null, если ничего не подходит.

HTMLButtonElement.formAction

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

HTMLButtonElement.formEnctype

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

HTMLButtonElement.formMethod

Строка, отражающая HTTP-метод, используемый браузером для отправки формы. Если указано, этот атрибут переопределяет атрибут method элемента <form>, к которому принадлежит этот элемент.

HTMLButtonElement.formNoValidate

Булево значение, указывающее, что форма не должна проверяться при отправке. Если указано, этот атрибут переопределяет атрибут novalidate элемента <form>, к которому принадлежит этот элемент.

HTMLButtonElement.formTarget

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

HTMLButtonElement.labels Только для чтения

Список NodeList, представляющий список элементов <label>, которые являются метками для этой кнопки.

HTMLButtonElement.name

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

HTMLButtonElement.popoverTargetAction

Получает и устанавливает действие, которое должно быть выполнено ("hide", "show", или "toggle") над элементом всплывающей подсказки, управляемым кнопкой управления. Он отражает значение атрибута HTML popovertargetaction.

HTMLButtonElement.popoverTargetElement

Получает и устанавливает элемент всплывающей подсказки для управления кнопкой. Аналог атрибута HTML popovertarget.

HTMLButtonElement.type

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

submit: Кнопка отправляет форму. Это значение по умолчанию, если атрибут не указан или если он динамически изменён на пустое или недопустимое значение.
reset: Кнопка сбрасывает форму.
button: Кнопка ничего не делает.
menu: Кнопка отображает меню. Экспериментально

HTMLButtonElement.willValidate Только для чтения

Булево значение, указывающее, является ли кнопка кандидатом для проверки ограничений. Оно равно false , если какие-либо условия препятствуют проверке ограничений, включая: его свойство type равно reset или button; у него есть предок <datalist>; или свойство disabled установлено в true.

HTMLButtonElement.validationMessage Только для чтения

Строка, представляющая локализованное сообщение, описывающее ограничения проверки, которым элемент не удовлетворяет (если таковые имеются). Этот атрибут равен пустой строке, если элемент не является кандидатом для проверки ограничений (willValidate равно false), или удовлетворяет своим ограничениям.

HTMLButtonElement.validity Только для чтения

Объект ValidityState, представляющий состояния валидности этой кнопки.

HTMLButtonElement.value

Строка, представляющая текущее значение элемента управления формы кнопки.

Методы экземпляра

Наследует методы от родителя, HTMLElement.

HTMLButtonElement.checkValidity(): Возвращает true , если значение элемента не имеет проблем с валидностью; в противном случае возвращает false.
HTMLButtonElement.reportValidity(): Выполняет то же действие, что и checkValidity(), но также сообщает об этом пользователю, если событие invalid не было отменено.

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

Спецификация
HTML # htmlbuttonelement

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

	Настольный компьютер					Мобильный
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`HTMLButtonElement`	1	12	1	≤12.1	3	18	4	≤12.1	1	1.0	≤37
`checkValidity`	4	12	4	≤12.1	5	18	4	≤12.1	5	1.0	≤37
`command`	preview	No	preview	No	preview	No	No	No	No	No	No
`commandForElement`	preview	No	preview	No	preview	No	No	No	No	No	No
`disabled`	1	12	1	≤12.1	3	18	4	≤12.1	1	1.0	4.4
`form`	1	12	1	≤12.1	3	18	4	≤12.1	1	1.0	4.4
`formAction`	9	12	4 В Firefox 56 реализация была обновлена таким образом, что свойство `formAction` возвращает правильный URL отправки формы, согласно спецификации, когда связанная кнопка используется для отправки формы (bug 1366361).	≤12.1	5.1	18	4 В Firefox для Android 56 реализация была обновлена таким образом, что свойство `formAction` возвращает правильный URL отправки формы, согласно спецификации, когда связанная кнопка используется для отправки формы (bug 1366361).	≤12.1	5	1.0	3
`formEnctype`	9	12	4	≤12.1	5.1	18	4	≤12.1	5	1.0	3
`formMethod`	9	12	4	≤12.1	5.1	18	4	≤12.1	5	1.0	3
`formNoValidate`	4	12	4	≤12.1	5	18	4	≤12.1	4	1.0	≤37
`formTarget`	9	12	4	≤12.1	5.1	18	4	≤12.1	5	1.0	3
`labels`	6	18	56	≤12.1	5.1	18	56	≤12.1	5	1.0	3
`name`	1	12	1	≤12.1	3	18	4	≤12.1	1	1.0	4.4
`popoverTargetAction`	114	114	125	100	17	114	125	76	17	23.0	114
`popoverTargetElement`	114	114	125	100	17	114	125	76	17	23.0	114
`reportValidity`	40	17	49	27	10.1	40	64	27	10.3	4.0	40
`setCustomValidity`	4 Этот метод обновляет только всплывающее окно с ошибкой проверки, а не подсказку, которая появляется при наведении курсора мыши на элемент, см. bug 41380670.	12	4	≤12.1	5	18 Этот метод обновляет только всплывающее окно с ошибкой проверки, а не подсказку, которая появляется при наведении курсора мыши на элемент, см. bug 41380670.	4	≤12.1	5	1.0 Этот метод обновляет только всплывающее окно с ошибкой проверки, а не подсказку, которая появляется при наведении курсора мыши на элемент, см. bug 41380670.	≤37
`type`	1	12	1	≤12.1	3	18	4	≤12.1	1	1.0	4.4
`validationMessage`	5	12	4	≤12.1	5	18	4	≤12.1	4	1.0	≤37
`validity`	4	12	4	≤12.1	5	18	4	≤12.1	4	1.0	≤37
`value`	1	12	1	≤12.1	3	18	4	≤12.1	1	1.0	4.4
`willValidate`	2	12	4	≤12.1	4	18	4	≤12.1	3	1.0	≤37

См. также

HTML-элемент, реализующий этот интерфейс: <button>

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLButtonElement