From 54fa28441c5f0bdcd9687615f4a6b7a0fab024a3 Mon Sep 17 00:00:00 2001 From: Mario Vavti Date: Fri, 7 Sep 2018 11:26:02 +0200 Subject: install bootstrap via composer --- .../bootstrap/site/docs/4.1/components/buttons.md | 164 +++++++++++++++++++++ 1 file changed, 164 insertions(+) create mode 100644 vendor/twbs/bootstrap/site/docs/4.1/components/buttons.md (limited to 'vendor/twbs/bootstrap/site/docs/4.1/components/buttons.md') diff --git a/vendor/twbs/bootstrap/site/docs/4.1/components/buttons.md b/vendor/twbs/bootstrap/site/docs/4.1/components/buttons.md new file mode 100644 index 000000000..f999fd552 --- /dev/null +++ b/vendor/twbs/bootstrap/site/docs/4.1/components/buttons.md @@ -0,0 +1,164 @@ +--- +layout: docs +title: Buttons +description: Use Bootstrap's custom button styles for actions in forms, dialogs, and more with support for multiple sizes, states, and more. +group: components +redirect_from: "/docs/4.1/components/" +toc: true +--- + +## Examples + +Bootstrap includes several predefined button styles, each serving its own semantic purpose, with a few extras thrown in for more control. + +{% capture example %} +{% for color in site.data.theme-colors %} +{% endfor %} + + +{% endcapture %} +{% include example.html content=example %} + +{% include callout-warning-color-assistive-technologies.md %} + +## Button tags + +The `.btn` classes are designed to be used with the ` + + + +{% endcapture %} +{% include example.html content=example %} + +## Outline buttons + +In need of a button, but not the hefty background colors they bring? Replace the default modifier classes with the `.btn-outline-*` ones to remove all background images and colors on any button. + +{% capture example %} +{% for color in site.data.theme-colors %} +{% endfor %} +{% endcapture %} +{% include example.html content=example %} + +## Sizes + +Fancy larger or smaller buttons? Add `.btn-lg` or `.btn-sm` for additional sizes. + +{% capture example %} + + +{% endcapture %} +{% include example.html content=example %} + +{% capture example %} + + +{% endcapture %} +{% include example.html content=example %} + +Create block level buttons—those that span the full width of a parent—by adding `.btn-block`. + +{% capture example %} + + +{% endcapture %} +{% include example.html content=example %} + +## Active state + +Buttons will appear pressed (with a darker background, darker border, and inset shadow) when active. **There's no need to add a class to ` + +{% endcapture %} +{% include example.html content=example %} + +Disabled buttons using the `` element behave a bit different: + +- ``s don't support the `disabled` attribute, so you must add the `.disabled` class to make it visually appear disabled. +- Some future-friendly styles are included to disable all `pointer-events` on anchor buttons. In browsers which support that property, you won't see the disabled cursor at all. +- Disabled buttons should include the `aria-disabled="true"` attribute to indicate the state of the element to assistive technologies. + +{% capture example %} +Primary link +Link +{% endcapture %} +{% include example.html content=example %} + +{% capture callout %} +##### Link functionality caveat + +The `.disabled` class uses `pointer-events: none` to try to disable the link functionality of ``s, but that CSS property is not yet standardized. 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, add a `tabindex="-1"` attribute on these links (to prevent them from receiving keyboard focus) and use custom JavaScript to disable their functionality. +{% endcapture %} +{% include callout.html content=callout type="warning" %} + +## Button plugin + +Do more with buttons. Control button states or create groups of buttons for more components like toolbars. + +### Toggle states + +Add `data-toggle="button"` to toggle a button's `active` state. If you're pre-toggling a button, you must manually add the `.active` class **and** `aria-pressed="true"` to the ` +{% endcapture %} +{% include example.html content=example %} + +### Checkbox and radio buttons + +Bootstrap's `.button` styles can be applied to other elements, such as `