就业培训     下载中心     Wiki     联络
登录   注册
  1. 首页
  2. HTML
  3. HTML 元素参考
  4. <button>: The Button element

在此页

HTML <button> element represents a clickable button, used to submit forms or anywhere in a document for accessible, standard button functionality. By default, HTML buttons are presented in a style resembling the platform the 用户代理 runs on, but you can change buttons’ appearance with CSS .

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

内容类别 流内容 , 措词内容 , Interactive content , listed , labelable ，和 submittable form-associated element, palpable content.
准许内容 措词内容 but there must be no Interactive content
Tag omission None, both the starting and ending tag are mandatory.
Permitted parents Any element that accepts 措词内容 .
Implicit ARIA role button
Permitted ARIA roles checkbox , link , menuitem , menuitemcheckbox , menuitemradio , option , radio , switch , tab
DOM 接口 HTMLButtonElement

属性

This element's attributes include the 全局属性 .

autofocus HTML5
This Boolean attribute specifies that the button should have input focus when the page loads. Only one element in a document can have this attribute.
autocomplete
This attribute on a <button> is nonstandard and Firefox-specific. Unlike other browsers, Firefox persists the dynamic disabled state 的 <button> across page loads. Setting autocomplete="off" on the button disables this feature; see bug 654072 .
被禁用

This Boolean attribute prevents the user from interacting with the button: it cannot be pressed or focused.

Firefox, unlike other browsers, persists the dynamic disabled state 的 <button> across page loads. Use the autocomplete attribute to control this feature.

form HTML5
<form> element to associate the button with (its form owner ). The value of this attribute must be the id 的 <form> in the same document. (If this attribute is not set, the <button> is associated with its ancestor <form> element, if any.)
This attribute lets you associate <button> elements to <form> s anywhere in the document, not just inside a <form> . It can also override an ancestor <form> 元素。
formaction HTML5
The URL that processes the information submitted by the button. Overrides the action attribute of the button's form owner. Does nothing if there is no form owner.
formenctype HTML5
If the button is a submit button (it's inside/associated with a <form> and doesn't have type="button" ), specifies how to encode the form data that is submitted. Possible values:
  • application/x-www-form-urlencoded : The default if the attribute is not used.
  • multipart/form-data : Use to submit <input> elements with their type attributes set to file .
  • text/plain : Specified as a debugging aid; shouldn’t be used for real form submission.

If this attribute is specified, it overrides the enctype attribute of the button's form owner.

formmethod HTML5
If the button is a submit button (it's inside/associated with a <form> and doesn't have type="button" ), this attribute specifies the HTTP method used to submit the form. Possible values:
  • post : The data from the form are included in the body of the HTTP request when sent to the server. Use when the form contains information that shouldn’t be public, like login credentials.
  • get : The form data are appended to the form's action URL, with a ? as a separator, and the resulting URL is sent to the server. Use this method when the form has no side effects , like search forms.

If specified, this attribute overrides the method attribute of the button's form owner.

formnovalidate HTML5
If the button is a submit button, this Boolean attribute specifies that the form is not to be validated when it is submitted. If this attribute is specified, it overrides the novalidate attribute of the button's form owner.
This attribute is also available on <input type="image"> and <input type="submit"> 元素。
formtarget HTML5
If the button is a submit button, this attribute is a author-defined name or standardized, underscore-prefixed keyword indicating where to display the response from submitting the form. This is the 名称 of, or keyword for, a 浏览上下文 (a tab, window, or <iframe> ). 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 is the default if the attribute is not specified.
  • _blank : Load the response into a new unnamed browsing context — usually a new tab or window, depending on the user’s browser settings.
  • _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 .
名称
The name of the button, submitted as a pair with the button’s value as part of the form data.
type
The default behavior 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 for buttons associated with a <form> , or if the attribute is an empty or invalid value.
  • reset : The button resets all the controls to their initial values, like <input type="reset"> . (This behavior tends to annoy users.)
  • button : The button has no default behavior, and does nothing when pressed by default. It can have client-side scripts listen to the element's events, which are triggered when the events occur.
value
Defines the value associated with the button’s 名称 when it’s submitted with the form data. This value is passed to the server in params when the form is submitted.

注意事项

A submit button with the attribute formaction set, but without an associated form does nothing. You have to set a form owner, either by wrapping it in a <form> or set the attribute form to the id of the form.

<button> elements are much easier to style than <input> elements. You can add inner HTML content (think <i> , <br> ，或者甚至 <img> ), and use ::after and ::before pseudo-elements for complex rendering.

If your buttons are not for submitting form data to a server, be sure to set their type 属性到 button . Otherwise they will try to submit form data and to load the (nonexistent) response, possibly destroying the current state of the document.

范例 

<button name="button">Press me</button>

可访问性关注

Icon buttons

Buttons that only show an icon to represent do not have an accessible name . Accessible names provide information for assistive technology, such as screen readers, to access when they parse the document and generate an accessibility tree . Assistive technology then uses the accessibility tree to navigate and manipulate page content.

To give an icon button an accessible name, put text in the <button> element that concisely describes the button's functionality.

范例 

<button name="favorite">
  <svg aria-hidden="true" viewBox="0 0 10 10"><path d="M7 9L5 8 3 9V6L1 4h3l1-3 1 3h3L7 6z"/></svg>
  Add to favorites
</button>

If you want to visually hide the button's text, an accessible way to do so is to use a combination of CSS properties to remove it visually from the screen, but keep it parseable by assistive technology.

However, it is worth noting that leaving the button text visually apparent can aid people who may not be familiar with the icon's meaning or understand the button's purpose. This is especially relevant for people who are not technologically sophisticated, or who may have different cultural interpretations for the icon the button uses.

Size and Proximity

Size

Interactive elements such as buttons should provide an area large enough that it is easy to activate them. This helps a variety of people, including people with motor control issues and people using non-precise forms of input such as a stylus or fingers. A minimum interactive size of 44×44 CSS pixels is recommended.

Proximity

Large amounts of interactive content — including buttons — placed in close visual proximity to each other should have space separating them. This spacing is beneficial for people who are experiencing motor control issues, who may accidentally activate the wrong interactive content.

Spacing may be created using CSS properties such as margin .

Firefox

Firefox will add a small dotted border on a focused button. This border is declared through CSS in the browser stylesheet, but you can override it to add your own focused style using button::-moz-focus-inner { } .

If overridden, it is important to ensure that the state change when focus is moved to the button is high enough that people experiencing low vision conditions will be able to perceive it.

Color contrast ratio is determined by comparing the luminosity of the button text and background color values compared to the background the button is placed on. In order to meet current Web Content Accessibility Guidelines (WCAG) , a ratio of 4.5:1 is required for text content and 3:1 for large text. (Large text is defined as 18.66px and bold or larger, or 24px or larger.)

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.

Does clicking on a <button> give it focus?
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
Does tapping on a <button> give it focus?
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

规范

规范 状态 注释
HTML 实时标准
The definition of '<button>' in that specification. 		实时标准
HTML5
The definition of '<button>' in that specification. 		推荐
HTML 4.01 Specification
The definition of '<button>' in that specification. 		推荐

浏览器兼容性

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据
桌面 移动
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
button Chrome 完整支持 Yes Edge 完整支持 12 Firefox 完整支持 Yes IE 完整支持 Yes Opera 完整支持 Yes Safari 完整支持 Yes WebView Android 完整支持 Yes Chrome Android 完整支持 Yes Firefox Android 完整支持 Yes Opera Android 完整支持 Yes Safari iOS 完整支持 Yes Samsung Internet Android 完整支持 Yes
autocomplete 非标 Chrome 不支持 No Edge 不支持 No Firefox 完整支持 Yes IE 不支持 No Opera 不支持 No Safari 不支持 No WebView Android 不支持 No Chrome Android 不支持 No Firefox Android 完整支持 Yes Opera Android 不支持 No Safari iOS 不支持 No Samsung Internet Android 不支持 No
autofocus Chrome 完整支持 5 Edge 完整支持 12 Firefox 完整支持 4 IE 完整支持 10 Opera 完整支持 9.6 Safari 完整支持 5 WebView Android 完整支持 37 Chrome Android 完整支持 18 Firefox Android 完整支持 4 Opera Android ? Safari iOS ? Samsung Internet Android 完整支持 1.0
被禁用 Chrome 完整支持 Yes Edge 完整支持 12 Firefox 完整支持 Yes IE 完整支持 Yes Opera 完整支持 Yes Safari 完整支持 Yes WebView Android 完整支持 Yes Chrome Android 完整支持 Yes Firefox Android 完整支持 Yes Opera Android 完整支持 Yes Safari iOS 完整支持 Yes Samsung Internet Android 完整支持 Yes
form Chrome 完整支持 Yes Edge 完整支持 16 Firefox 完整支持 Yes IE 不支持 No Opera 完整支持 Yes Safari 完整支持 Yes WebView Android 完整支持 Yes Chrome Android 完整支持 Yes Firefox Android 完整支持 Yes Opera Android 完整支持 Yes Safari iOS 完整支持 Yes Samsung Internet Android 完整支持 Yes
formaction Chrome 完整支持 9 Edge 完整支持 12 Firefox 完整支持 4 IE 完整支持 10 Opera 完整支持 15 Safari 完整支持 5.1 WebView Android 完整支持 37 Chrome Android 完整支持 18 Firefox Android 完整支持 4 Opera Android ? Safari iOS 完整支持 5 Samsung Internet Android 完整支持 1.0
formenctype Chrome 完整支持 9 Edge 完整支持 12 Firefox 完整支持 4 IE 完整支持 10 Opera 完整支持 10.6 Safari ? WebView Android 完整支持 37 Chrome Android 完整支持 18 Firefox Android 完整支持 4 Opera Android ? Safari iOS ? Samsung Internet Android 完整支持 1.0
formmethod Chrome 完整支持 9 Edge 完整支持 12 Firefox 完整支持 4 IE 完整支持 10 Opera 完整支持 15 Safari ? WebView Android 完整支持 37 Chrome Android 完整支持 18 Firefox Android 完整支持 4 Opera Android ? Safari iOS ? Samsung Internet Android 完整支持 1.0
formnovalidate Chrome 完整支持 Yes Edge 完整支持 12 Firefox 完整支持 Yes IE 完整支持 Yes Opera 完整支持 Yes Safari 完整支持 Yes WebView Android 完整支持 Yes Chrome Android 完整支持 Yes Firefox Android 完整支持 Yes Opera Android 完整支持 Yes Safari iOS 完整支持 Yes Samsung Internet Android 完整支持 Yes
formtarget Chrome 完整支持 Yes Edge 完整支持 12 Firefox 完整支持 Yes IE 完整支持 Yes Opera 完整支持 Yes Safari 完整支持 Yes WebView Android 完整支持 Yes Chrome Android 完整支持 Yes Firefox Android 完整支持 Yes Opera Android 完整支持 Yes Safari iOS 完整支持 Yes Samsung Internet Android 完整支持 Yes
名称 Chrome 完整支持 Yes Edge 完整支持 12 Firefox 完整支持 Yes IE 完整支持 Yes Opera 完整支持 Yes Safari 完整支持 Yes WebView Android 完整支持 Yes Chrome Android 完整支持 Yes Firefox Android 完整支持 Yes Opera Android 完整支持 Yes Safari iOS 完整支持 Yes Samsung Internet Android 完整支持 Yes
type Chrome 完整支持 Yes Edge 完整支持 12 Firefox 完整支持 Yes IE 完整支持 Yes Opera 完整支持 Yes Safari 完整支持 Yes WebView Android 完整支持 Yes Chrome Android 完整支持 Yes Firefox Android 完整支持 Yes Opera Android 完整支持 Yes Safari iOS 完整支持 Yes Samsung Internet Android 完整支持 Yes
value Chrome 完整支持 Yes Edge 完整支持 12 Firefox 完整支持 Yes IE 完整支持 Yes Opera 完整支持 Yes Safari 完整支持 Yes WebView Android 完整支持 Yes Chrome Android 完整支持 Yes Firefox Android 完整支持 Yes Opera Android 完整支持 Yes Safari iOS 完整支持 Yes Samsung Internet Android 完整支持 Yes

图例

完整支持

完整支持

不支持

不支持

兼容性未知 ?

兼容性未知

非标。预期跨浏览器支持较差。

非标。预期跨浏览器支持较差。

元数据

  • 最后修改：
  1. <button>
  2. <datalist>
  3. <fieldset>
  4. <form>
  5. <input>
  6. <label>
  7. <legend>
  8. <meter>
  9. <optgroup>
  10. <option>
  11. <output>
  12. <progress>
  13. <select>
  14. <textarea>
  15. HTML 元素
    1. A
      1. <a>
      2. <abbr>
      3. <acronym>
      4. <address>
      5. <applet>
      6. <area>
      7. <article>
      8. <aside>
      9. <audio>
    2. B
      1. <b>
      2. <base>
      3. <basefont>
      4. <bdi>
      5. <bdo>
      6. <bgsound>
      7. <big>
      8. <blink>
      9. <blockquote>
      10. <body>
      11. <br>
      12. <button>
    3. C
      1. <canvas>
      2. <caption>
      3. <center>
      4. <cite>
      5. <code>
      6. <col>
      7. <colgroup>
      8. <content>
    4. D
      1. <data>
      2. <datalist>
      3. <dd>
      4. <del>
      5. <details>
      6. <dfn>
      7. <dialog>
      8. <dir>
      9. <div>
      10. <dl>
      11. <dt>
    5. E
      1. <em>
      2. <embed>
    6. F
      1. <fieldset>
      2. <figcaption>
      3. <figure>
      4. <font>
      5. <footer>
      6. <form>
      7. <frame>
      8. <frameset>
    7. G H
      1. <h1>
      2. <h2>
      3. <h3>
      4. <h4>
      5. <h5>
      6. <h6>
      7. <head>
      8. <header>
      9. <hgroup>
      10. <hr>
      11. <html>
    8. I
      1. <i>
      2. <iframe>
      3. <img>
      4. <input>
      5. <ins>
      6. <isindex>
    9. J K
      1. <kbd>
      2. <keygen>
    10. L
      1. <label>
      2. <legend>
      3. <li>
      4. <link>
      5. <listing>
    11. M
      1. <main>
      2. <map>
      3. <mark>
      4. <marquee>
      5. <menu>
      6. <menuitem>
      7. <meta>
      8. <meter>
    12. N
      1. <nav>
      2. <nobr>
      3. <noframes>
      4. <noscript>
    13. O
      1. <object>
      2. <ol>
      3. <optgroup>
      4. <option>
      5. <output>
    14. P
      1. <p>
      2. <param>
      3. <picture>
      4. <plaintext>
      5. <pre>
      6. <progress>
    15. Q
      1. <q>
    16. R
      1. <rp>
      2. <rt>
      3. <rtc>
      4. <ruby>
    17. S
      1. <s>
      2. <samp>
      3. <script>
      4. <section>
      5. <select>
      6. <shadow>
      7. <slot>
      8. <small>
      9. <source>
      10. <spacer>
      11. <span>
      12. <strike>
      13. <strong>
      14. <style>
      15. <sub>
      16. <summary>
      17. <sup>
    18. T
      1. <table>
      2. <tbody>
      3. <td>
      4. <template>
      5. <textarea>
      6. <tfoot>
      7. <th>
      8. <thead>
      9. <time>
      10. <title>
      11. <tr>
      12. <track>
      13. <tt>
    19. U
      1. <u>
      2. <ul>
    20. V
      1. <var>
      2. <video>
    21. W
      1. <wbr>
    22. X Y Z
      1. <xmp>

版权所有  © 2014-2026 乐数软件    

工业和信息化部： 粤ICP备14079481号-1