rooty/Bootstrap
0
0
Fork 0
mirror of https://github.com/twbs/bootstrap.git synced 2024-12-10 22:24:19 +01:00
Code Issues Actions Packages Releases Activity

simplify some button docs copy

Browse Source
This commit is contained in:
Mark Otto 2015-08-10 16:11:44 -07:00
parent c78965b47d
commit 03c91b83bd
1 changed files with 6 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
docs/components/buttons.md
View File

@ -4,7 +4,7 @@ title: Buttons
group: components group: components
--- ---
Buttons are used to execute actions in forms, dialogs, and more. Use any of the available button classes to quickly create a styled button. Use Bootstrap's custom button styles for actions in forms, dialogs, and more. Includes support for a handful of contextual variations, sizes, states, and more.
## Contents ## Contents
@ -104,7 +104,11 @@ Buttons will appear pressed (with a darker background, darker border, and inset
## Disabled state ## Disabled state
Make buttons look unclickable by adding the `disabled` boolean attribute to any `<button>` element. Make buttons look inactive by adding the `disabled` boolean attribute to any `<button>` element.
{% callout info %}
**Heads up!** IE9 and below render disabled buttons with gray, shadowed text that we can't override.
{% endcallout %}
{% example html %} {% example html %}
<button type="button" class="btn btn-lg btn-primary" disabled>Primary button</button> <button type="button" class="btn btn-lg btn-primary" disabled>Primary button</button>
@ -118,24 +122,12 @@ As `<a>` elements don't support the `disabled` attribute, you must add the `.dis
<a href="#" class="btn btn-secondary btn-lg disabled" role="button">Link</a> <a href="#" class="btn btn-secondary btn-lg disabled" role="button">Link</a>
{% endexample %} {% endexample %}
{% callout warning %}
#### Cross-browser compatibility
If you add the `disabled` attribute to a `<button>`, Internet Explorer 9 and below will render text gray with a nasty text-shadow that we cannot fix.
{% endcallout %}
{% callout warning %} {% callout warning %}
#### Link functionality caveat #### Link functionality caveat
This class uses `pointer-events: none` to try to disable the link functionality of `<a>`s, but that CSS property is not yet standardized and isn't fully supported in Opera 18 and below, or in Internet Explorer 11\. In addition, even in browsers that do support `pointer-events: none`, keyboard navigation remains unaffected, meaning that sighted keyboard users and users of assistive technologies will still be able to activate these links. So to be safe, use custom JavaScript to disable such links. This class uses `pointer-events: none` to try to disable the link functionality of `<a>`s, but that CSS property is not yet standardized and isn't fully supported in Opera 18 and below, or in Internet Explorer 11\. In addition, even in browsers that do support `pointer-events: none`, keyboard navigation remains unaffected, meaning that sighted keyboard users and users of assistive technologies will still be able to activate these links. So to be safe, use custom JavaScript to disable such links.
{% endcallout %} {% endcallout %}
{% callout warning %}
#### Context-specific usage
While button classes can be used on `<a>` and `<button>` elements, only `<button>` elements are supported within our nav and navbar components.
{% endcallout %}
## Button plugin ## Button plugin
Do more with buttons. Control button states or create groups of buttons for more components like toolbars. Do more with buttons. Control button states or create groups of buttons for more components like toolbars.