From 3ec4ca17ba1f954871fe99100c7137d4977b5dbf Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Wed, 9 Jul 2014 21:17:10 -0700 Subject: rewrite helpers in markdown --- docs/_includes/css/buttons.md | 241 +++++++++++++++++------------------------- 1 file changed, 96 insertions(+), 145 deletions(-) (limited to 'docs/_includes/css/buttons.md') diff --git a/docs/_includes/css/buttons.md b/docs/_includes/css/buttons.md index dbfc35610..c02e74e1f 100644 --- a/docs/_includes/css/buttons.md +++ b/docs/_includes/css/buttons.md @@ -1,17 +1,10 @@ -
-

Buttons

-

Use any of the available button classes to quickly create a styled button.

-
-

- - - - - - -

-
-{% highlight html %} + + +# Buttons + +Use any of the available button classes to quickly create a styled button. + +{% example html %} @@ -29,146 +22,104 @@ -{% endhighlight %} - -

Sizes

-

Fancy larger or smaller buttons? Add .btn-lg, .btn-sm, or .btn-xs for additional sizes.

-
-

- - -

-

- - -

-

- - -

-

- - -

-
-{% highlight html %} -

- - -

-

- - -

-

- - -

-

- - -

-{% endhighlight %} - -

Create block level buttons—those that span the full width of a parent— by adding .btn-block.

-
-
- - -
-
-{% highlight html %} +{% endexample %} + + + + + +## Sizes + +Fancy larger or smaller buttons? Add `.btn-lg`, `.btn-sm`, or `.btn-xs` for additional sizes. + +{% example html %} + + +{% endexample %} + +{% example html %} + + +{% endexample %} + +{% example html %} + + +{% endexample %} + +Create block level buttons—those that span the full width of a parent—by adding `.btn-block`. + +{% example html %} -{% endhighlight %} - - -

Active state

-

Buttons will appear pressed (with a darker background, darker border, and inset shadow) when active. For <button> elements, this is done via :active. For <a> elements, it's done with .active. However, you may use .active on <button>s should you need to replicate the active state programmatically.

- -

Button element

-

No need to add :active as it's a pseudo-class, but if you need to force the same appearance, go ahead and add .active.

-

- - -

-{% highlight html %} - - -{% endhighlight %} - -

Anchor element

-

Add the .active class to <a> buttons.

-

- Primary link - Link -

-{% highlight html %} +{% endexample %} + + + + + +## 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 ` - -

-{% highlight html %} - - -{% endhighlight %} - -
-

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.

-
- -

Anchor element

-

Add the .disabled class to <a> buttons.

-

- Primary link - Link -

-{% highlight html %} +{% endexample %} + + + + + +## Disabled state + +Make buttons look unclickable by adding the `disabled` boolean attribute to any ` + +{% endexample %} + +As `` elements don't support the `disabled` attribute, you must add the `.disabled` class to fake it. + +{% example html %} Primary link Link -{% endhighlight %} -

- We use .disabled as a utility class here, similar to the common .active class, so no prefix is required. -

-
-

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. So to be safe, use custom JavaScript to disable such links.

-
-
-

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.

-
- - -

Button tags

-

Use the button classes on an <a>, <button>, or <input> element.

-
- Link - - - -
-{% highlight html %} +{% endexample %} + +
+

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.

+
+ +
+

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. So to be safe, use custom JavaScript to disable such links.

+
+ +
+

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.

+
+ + + + + +## Button tags + +Use the button classes on an ``, ` -{% endhighlight %} +{% endexample %} + -
-

Cross-browser rendering

-

As a best practice, we highly recommend using the <button> element whenever possible to ensure matching cross-browser rendering.

-

Among other things, there's a bug in Firefox <30 that prevents us from setting the line-height of <input>-based buttons, causing them to not exactly match the height of other buttons on Firefox.

-
+
+

Cross-browser rendering

+

As a best practice, we highly recommend using the <button> element whenever possible to ensure matching cross-browser rendering.

+

Among other things, there's a bug in Firefox <30 that prevents us from setting the line-height of <input>-based buttons, causing them to not exactly match the height of other buttons on Firefox.

-- cgit v1.2.3