From 4642156cbc6da4a9e25dce2168f2fb9b726de042 Mon Sep 17 00:00:00 2001 From: Thomas Park Date: Tue, 6 Aug 2013 15:19:12 -0400 Subject: unignore bower_components --- bower_components/bootstrap/components.html | 2129 ++++++++++++++++++++++++++++ 1 file changed, 2129 insertions(+) create mode 100644 bower_components/bootstrap/components.html (limited to 'bower_components/bootstrap/components.html') diff --git a/bower_components/bootstrap/components.html b/bower_components/bootstrap/components.html new file mode 100644 index 00000000..1f685c2d --- /dev/null +++ b/bower_components/bootstrap/components.html @@ -0,0 +1,2129 @@ +--- +layout: default +title: Components +slug: components +lead: "Dozens of reusable components built to provide iconography, dropdowns, navigation, alerts, popovers, and much more." +base_url: "../" +--- + + + +
+ +

Toggleable, contextual menu for displaying lists of links. Made interactive with the dropdown JavaScript plugin.

+ + +

Wrap the dropdown's trigger and the dropdown menu within .dropdown, or another element that declares position: relative;. Then add the menu's HTML.

+ +{% highlight html %} + +{% endhighlight %} + + +

Add .pull-right to a .dropdown-menu to right align the dropdown menu.

+{% highlight html %} + +{% endhighlight %} + + +

Add a header to break up label sections of actions in any dropdown menu.

+
+ +
+{% highlight html %} + +{% endhighlight %} + + +

Add .disabled to a <li> in the dropdown to disable the link.

+ +{% highlight html %} + +{% endhighlight %} +
+ + + + +
+ +

Group a series of buttons together on a single line with the button group. Add on optional JavaScript radio and checkbox style behavior with our buttons plugin.

+ +
+

Tooltips & popovers in button groups require special setting

+

When using tooltips or popovers on elements within a .btn-group, you'll have to specify the option container: 'body' to avoid unwanted side effects (such as the element growing wider and/or losing its rounded corners when the tooltip or popover is triggered).

+
+ +

Basic button group

+

Wrap a series of buttons with .btn in .btn-group.

+
+
+ + + +
+
+{% highlight html %} +
+ + + +
+{% endhighlight %} + +

Multiple button groups

+

Combine sets of <div class="btn-group"> into a <div class="btn-toolbar"> for more complex components.

+
+
+
+ + + + +
+
+ + + +
+
+ +
+
+
+{% highlight html %} +
+
...
+
...
+
...
+
+{% endhighlight %} + +

Nested button groups

+

Place buttons groups within button groups when you want dropdown menus mixed with a series of buttons.

+
+
+ + + + +
+ + +
+
+
+ +

Vertical button groups

+

Make a set of buttons appear vertically stacked rather than horizontally.

+
+
+ + + + +
+
+{% highlight html %} +
+ ... +
+{% endhighlight %} + +

Justified button groups

+

Make a group of buttons stretch at the same size to span the entire width of its parent.

+ +
+

Element-specific usage

+

This only works with <a> elements as the <button> doesn't pick up these styles.

+
+ +
+
+ Left + Right + Middle +
+
+{% highlight html %} +
+ ... +
+{% endhighlight %} + +
+ + + + +
+ +

Use any button to trigger a dropdown menu by placing it within a .btn-group and providing the proper menu markup.

+ +
+

Plugin dependency

+

Button dropdowns require the dropdown plugin to be included in your version of Bootstrap.

+
+ +

Single button dropdowns

+

Turn a button into dropdown toggle with some basic markup changes.

+ +{% highlight html %} + + +{% endhighlight %} + +

Split button dropdowns

+

Similarly, create split button dropdowns with the same markup changes, only with a separate button.

+ +{% highlight html %} + + +{% endhighlight %} + +

Works with all button sizes

+

Button dropdowns work with buttons of all sizes.

+
+
+
+ + +
+
+ + +
+
+
+{% highlight html %} + +
+ + +
+ + +
+ + +
+
+{% endhighlight %} + +

Dropup buttons

+

Trigger dropdown menus above elements by adding .dropup to the parent.

+
+
+ +
+ + + +
+
+
+{% highlight html %} +
+ + + +
+{% endhighlight %} + + + + + + +
+ + +

Navs available in Bootstrap have shared markup, starting with the base .nav class, as well as shared states. Swap modifier classes to switch between each style.

+ + +

Note the .nav-tabs class requires the .nav base class.

+
+ +
+{% highlight html %} + +{% endhighlight %} + + +

Take that same HTML, but use .nav-pills instead:

+
+ +
+{% highlight html %} + +{% endhighlight %} +

Pills are also vertically stackable. Just add .nav-stacked.

+
+ +
+{% highlight html %} + +{% endhighlight %} + +

Options

+ + +

Easily make tabs or pills equal widths of their parent with .nav-justified.

+
+ +
+ +
+{% highlight html %} + + +{% endhighlight %} + + +

For any nav component (tabs, pills, or list), add .disabled for gray links and no hover effects.

+ +
+

Link functionality not impacted

+

This class will only change the <a>'s appearance, not its functionality. Use custom JavaScript to disable links here.

+
+ + +{% highlight html %} + +{% endhighlight %} + + + +

To align nav links, use the .pull-left or .pull-right utility classes. Both classes will add a CSS float in the specified direction.

+ + +
+ + + +

Add dropdown menus with a little extra HTML and the dropdowns JavaScript plugin.

+ +

Tabs with dropdowns

+ +{% highlight html %} + +{% endhighlight %} + +

Pills with dropdowns

+ +{% highlight html %} + +{% endhighlight %} + +
+ + + + +
+ + + +

To start, navbars are static (not fixed to the top) and include support for a project name and basic navigation. Place one anywhere within a .container, which sets the width of your site and content.

+
+ +
+{% highlight html %} + +{% endhighlight %} + +

Navbar components

+ + +

A simple link to show your brand or project name only requires an anchor tag.

+
+ +
+{% highlight html %} +Title +{% endhighlight %} + + +

Nav items are simple to add via unordered lists.

+
+ +
+{% highlight html %} + +{% endhighlight %} + + +

To properly style and position a form within the navbar, add the appropriate classes as shown below. For a default form, include .navbar-form and either .pull-left or .pull-right to properly align it.

+
+ + + + + + + + + +
+{% highlight html %} + +{% endhighlight %} + + +

For buttons not residing in a <form>, add this class to vertically center buttons within a navbar.

+
+ +
+{% highlight html %} + +{% endhighlight %} + + +

Wrap strings of text in an element with .navbar-text, usually on a <p> tag for proper leading and color.

+
+ +
+{% highlight html %} + +{% endhighlight %} + + +

For folks using standard links that are not within the regular navbar navigation component, use the .navbar-link class to add the proper colors for the default and inverse navbar options.

+
+ +
+{% highlight html %} + +{% endhighlight %} + + +

Align nav links, forms, buttons, or text, using the .pull-left or .pull-right utility classes. Both classes will add a CSS float in the specified direction. To align nav links, put them in a separate <ul> with the respective utility class applied.

+ + +

Optional display variations

+

Fix the navbar to the top or bottom of the viewport with an additional class on the outermost div, .navbar. These will also remove rounded corners.

+ + +

Add .navbar-fixed-top.

+
+ +
+{% highlight html %} + +{% endhighlight %} + +
+

Body padding required

+

The fixed navbar will overlay your other content, unless you add padding to the top of the <body>. Try out your own values or use our snippet below. Tip: By default, the navbar is 50px high.

+{% highlight css %} +body { padding-top: 70px; } +{% endhighlight %} +

Make sure to include this after the core Bootstrap CSS.

+
+ + +

Add .navbar-fixed-bottom instead.

+
+ +
+{% highlight html %} + +{% endhighlight %} + +
+

Body padding required

+

The fixed navbar will overlay your other content, unless you add padding to the bottom of the <body>. Try out your own values or use our snippet below. Tip: By default, the navbar is 50px high.

+{% highlight css %} +body { padding-bottom: 70px; } +{% endhighlight %} +

Make sure to include this after the core Bootstrap CSS.

+
+ + +

Create a full-width navbar that scrolls away with the page by adding .navbar-static-top. Unlike the .navbar-fixed-* classes, you do not need to change any padding on the body.

+
+ +
+{% highlight html %} + +{% endhighlight %} + + + +

To implement a collapsing responsive navbar, wrap your navbar content in a containing div, .nav-collapse.collapse, and add the navbar toggle button, .navbar-toggle.

+
+ +
+{% highlight html %} + +{% endhighlight %} + +
+

Plugin dependency

+

The responsive navbar requires the collapse plugin to be included in your version of Bootstrap.

+
+ + +

Inverted variation

+

Modify the look of the navbar by adding .navbar-inverse.

+
+ +
+{% highlight html %} + +{% endhighlight %} + +
+ + + + +
+ +

Indicate the current page's location within a navigational hierarchy.

+

Separators are automatically added in CSS through :before and content.

+
+ + + +
+{% highlight html %} + +{% endhighlight %} +
+ + + + +
+ +

Provide pagination links for your site or app with the multi-page pagination component, or the simpler pager alternative.

+ +

Standard pagination

+

Simple pagination inspired by Rdio, great for apps and search results. The large block is hard to miss, easily scalable, and provides large click areas.

+
+ +
+{% highlight html %} + +{% endhighlight %} + +

Disabled and active states

+

Links are customizable for different circumstances. Use .disabled for unclickable links and .active to indicate the current page.

+
+ +
+{% highlight html %} + +{% endhighlight %} +

You can optionally swap out active or disabled anchors for <span> to remove click functionality while retaining intended styles.

+{% highlight html %} + +{% endhighlight %} + + +

Sizes

+

Fancy larger or smaller pagination? Add .pagination-large or .pagination-small for additional sizes.

+
+
+ +
+
+ +
+
+ +
+
+{% highlight html %} + + + +{% endhighlight %} + + +

Pager

+

Quick previous and next links for simple pagination implementations with light markup and styles. It's great for simple sites like blogs or magazines.

+ +

Default example

+

By default, the pager centers links.

+
+ +
+{% highlight html %} + +{% endhighlight %} + +

Aligned links

+

Alternatively, you can align each link to the sides:

+
+ +
+{% highlight html %} + +{% endhighlight %} + + +

Optional disabled state

+

Pager links also use the general .disabled utility class from the pagination.

+
+ +
+{% highlight html %} + +{% endhighlight %} +
+ + + + +
+ +

+ +

Example

+
+

Example heading New

+

Example heading New

+

Example heading New

+

Example heading New

+
Example heading New
+
Example heading New
+
+{% highlight html %} +

Example heading New

+{% endhighlight %} + +

Available variations

+

Add any of the below mentioned modifier classes to change the appearance of a label.

+
+ Default + Success + Warning + Danger + Info +
+{% highlight html %} +Default +Success +Warning +Danger +Info +{% endhighlight %} + +
+ + + + +
+ +

Easily highlight new or unread items by adding a <span class="badge"> to links, Bootstrap navs, and more.

+ +
+ Inbox 42 +
+{% highlight html %} +Inbox 42 +{% endhighlight %} + +

Self collapsing

+

When there are no new or unread items, badges will simply collapse (via CSS's :empty selector) provided no content exists within.

+ +
+

Cross-browser compatibility

+

Badges won't self collapse in Internet Explorer 8 because it lacks support for the :empty selector.

+
+ +

Adapts to active nav states

+

Built-in styles are included for placing badges in active states in pill and list navigations.

+ +{% highlight html %} + +{% endhighlight %} +
+ + + + +
+ + +

Jumbotron

+

A lightweight, flexible component to showcase key content on your site. It works well on marketing and content-heavy sites.

+
+
+

Hello, world!

+

This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.

+

Learn more

+
+
+{% highlight html %} +
+

Hello, world!

+

...

+

Learn more

+
+{% endhighlight %} + +

Page header

+

A simple shell for an h1 to appropriately space out and segment sections of content on a page. It can utilize the h1's default small element, as well as most other components (with additional styles).

+
+ +
+{% highlight html %} + +{% endhighlight %} +
+ + + + +
+ +

Extend Bootstrap's grid system with the thumbnail component to easily display grids of images, videos, text, and more.

+ +

Default thumbnails

+

By default, Bootstrap's thumbnails are designed to showcase linked images with minimal required markup.

+
+
+
+ + + +
+
+ + + +
+
+ + + +
+
+ + + +
+
+
+{% highlight html %} +
+
+ + + +
+ ... +
+{% endhighlight %} + +

Custom content thumbnails

+

With a bit of extra markup, it's possible to add any kind of HTML content like headings, paragraphs, or buttons into thumbnails.

+
+
+
+
+ +
+

Thumbnail label

+

Cras justo odio, dapibus ac facilisis in, egestas eget quam. Donec id elit non mi porta gravida at eget metus. Nullam id dolor id nibh ultricies vehicula ut id elit.

+

Action Action

+
+
+
+
+
+ +
+

Thumbnail label

+

Cras justo odio, dapibus ac facilisis in, egestas eget quam. Donec id elit non mi porta gravida at eget metus. Nullam id dolor id nibh ultricies vehicula ut id elit.

+

Action Action

+
+
+
+
+
+ +
+

Thumbnail label

+

Cras justo odio, dapibus ac facilisis in, egestas eget quam. Donec id elit non mi porta gravida at eget metus. Nullam id dolor id nibh ultricies vehicula ut id elit.

+

Action Action

+
+
+
+
+
+{% highlight html %} +
+
+
+ +
+

Thumbnail label

+

...

+

Action Action

+
+
+
+
+{% endhighlight %} +
+ + + + + +
+ +

Provide contextual feedback messages for typical user actions with the handful of available and flexible alert messages. For inline dismissal, use the alerts jQuery plugin.

+ +

Default alert

+

Wrap any text and an optional dismiss button in .alert for a basic warning alert message.

+ +
+

Ensure proper behavior across all devices

+

Be sure to use the <button> element with the data-dismiss="alert" data attribute.

+
+ +
+
+ + Warning! Best check yo self, you're not looking too good. +
+
+{% highlight html %} +
+ + Warning! Best check yo self, you're not looking too good. +
+{% endhighlight %} + +

Block alerts

+

For longer messages, increase the padding on the top and bottom of the alert wrapper by adding .alert-block.

+
+
+ +

Warning!

+

Best check yo self, you're not looking too good. Nulla vitae elit libero, a pharetra augue. Praesent commodo cursus magna, vel scelerisque nisl consectetur et.

+
+
+{% highlight html %} +
+ +

Warning!

+

...

+
+{% endhighlight %} + +

Contextual alternatives

+

Add optional classes to change an alert's connotation.

+
+
+ + Oh snap! Change a few things up and try submitting again. +
+
+ + Well done! You successfully read this important alert message. +
+
+ + Heads up! This alert needs your attention, but it's not super important. +
+
+{% highlight html %} +
...
+
...
+
...
+{% endhighlight %} + + +

Use the .alert-link utility class to quickly provide matching colored links within any alert.

+
+
+ + Oh snap! Change a few things up and try submitting again. +
+
+ + Well done! You successfully read this important alert message. +
+
+ + Heads up! This alert needs your attention, but it's not super important. +
+
+{% highlight html %} +
+ ... +
+
+ ... +
+
+ ... +
+{% endhighlight %} +
+ + + + + +
+ +

Provide up-to-date feedback on the progress of a workflow or action with simple yet flexible progress bars.

+ +
+

Cross-browser compatibility

+

Progress bars use CSS3 transitions and animations to achieve some of their effects. These features are not supported in Internet Explorer 9 and below or older versions of Firefox. Opera 12 does not support animations.

+
+ +

Basic

+

Default progress bar with a vertical gradient.

+
+
+
+
+
+{% highlight html %} +
+
+
+{% endhighlight %} + +

Contextual alternatives

+

Progress bars use some of the same button and alert classes for consistent styles.

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+{% highlight html %} +
+
+
+
+
+
+
+
+
+
+
+
+{% endhighlight %} + +

Striped

+

Uses a gradient to create a striped effect. Not available in IE8.

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+{% highlight html %} +
+
+
+
+
+
+
+
+
+
+
+
+{% endhighlight %} + +

Animated

+

Add .active to .progress-striped to animate the stripes right to left. Not available in all versions of IE.

+
+
+
+
+
+{% highlight html %} +
+
+
+{% endhighlight %} + +

Stacked

+

Place multiple bars into the same .progress to stack them.

+
+
+
+
+
+
+
+{% highlight html %} +
+
+
+
+
+{% endhighlight %} +
+ + + + + +
+ +

Abstract object styles for building various types of components (like blog comments, Tweets, etc) that feature a left- or right-aligned image alongside textual content.

+ +

Default example

+

The default media allow to float a media object (images, video, audio) to the left or right of a content block.

+
+
+ + + +
+

Media heading

+ Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus. +
+
+
+ + + +
+

Media heading

+ Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus. +
+ + + +
+

Media heading

+ Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus. +
+
+
+
+
+{% highlight html %} +
+ + + +
+

Media heading

+ ... +
+
+{% endhighlight %} + +

Media list

+

With a bit of extra markup, you can use media inside list (useful for comment threads or articles lists).

+
+
    +
  • + + + +
    +

    Media heading

    +

    Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis.

    + +
    + + + +
    +

    Nested media heading

    + Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. + +
    + + + +
    +

    Nested media heading

    + Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. +
    +
    +
    +
    + +
    + + + +
    +

    Nested media heading

    + Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. +
    +
    +
    +
  • +
  • + + + +
    +

    Media heading

    + Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. +
    +
  • +
+
+{% highlight html %} + +{% endhighlight %} +
+ + + + + + +
+ +

List groups are a flexible and powerful component for displaying not only simple lists of elements, but complex ones with custom content.

+ +

Basic list group

+

The most basic list group is simply an unordered list with list items, and the proper classes. Build upon it with the options that follow, or your own CSS as needed.

+
+
    +
  • Cras justo odio
  • +
  • Dapibus ac facilisis in
  • +
  • Morbi leo risus
  • +
  • Porta ac consectetur ac
  • +
  • Vestibulum at eros
  • +
+
+{% highlight html %} + +{% endhighlight %} + +

With badges

+

Add the badges component to any list group item and it will automatically be positioned on the right.

+
+
    +
  • + 14 + Cras justo odio +
  • +
  • + 2 + Dapibus ac facilisis in +
  • +
  • + 1 + Morbi leo risus +
  • +
+
+{% highlight html %} + +{% endhighlight %} + +

Linked list group

+

Linkify list group items by using anchor tags instead of list items (that also means a parent <div> instead of an <ul>). No need for individual parents around each element.

+ +{% highlight html %} + +{% endhighlight %} + +

Custom content

+

Add nearly any HTML within, even for linked list groups like the one below.

+ +{% highlight html %} + +{% endhighlight %} +
+ + + + + +
+ +

While not always necessary, sometimes you need to put your DOM in a box. For those situations, try the panel component.

+ +

Basic panel

+

By default, all the .panel does is apply some basic border and padding to contain some content.

+
+
+ Basic panel example +
+
+{% highlight html %} +
+ Basic panel example +
+{% endhighlight %} + +

Panel with heading

+

Easily add a heading container to your panel with .panel-heading. You may also include any <h1>-<h6> with a .panel-title class to add a pre-styled heading.

+
+
+
Panel heading
+ Panel content +
+
+
+

Panel title

+
+ Panel content +
+
+{% highlight html %} +
+
Panel heading
+ Panel content +
+ +
+
+

Panel title

+
+ Panel content +
+{% endhighlight %} + + +

Wrap buttons or secondary text in .panel-footer.

+
+
+ Panel content + +
+
+{% highlight html %} +
+ Panel content + +
+{% endhighlight %} + +

Contextual alternatives

+

Like other components, easily make a panel more meaningful to a particular context by adding any of the contextual state classes.

+
+
+
+

Panel title

+
+ Panel content +
+
+
+

Panel title

+
+ Panel content +
+
+
+

Panel title

+
+ Panel content +
+
+
+

Panel title

+
+ Panel content +
+
+
+

Panel title

+
+ Panel content +
+
+{% highlight html %} +
...
+
...
+
...
+
...
+
...
+{% endhighlight %} + +

With list groups

+

Easily include full-width list groups within any panel.

+
+
+ +
Panel heading
+

Some default panel content here. Nulla vitae elit libero, a pharetra augue. Aenean lacinia bibendum nulla sed consectetur. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Nullam id dolor id nibh ultricies vehicula ut id elit.

+ + +
    +
  • Cras justo odio
  • +
  • Dapibus ac facilisis in
  • +
  • Morbi leo risus
  • +
  • Porta ac consectetur ac
  • +
  • Vestibulum at eros
  • +
+
+
+{% highlight html %} +
+ +
Panel heading
+

...

+ + +
    +
  • Cras justo odio
  • +
  • Dapibus ac facilisis in
  • +
  • Morbi leo risus
  • +
  • Porta ac consectetur ac
  • +
  • Vestibulum at eros
  • +
+
+{% endhighlight %} + +
+ + + + + + +
+ + +

Default well

+

Use the well as a simple effect on an element to give it an inset effect.

+
+
+ Look, I'm in a well! +
+
+{% highlight html %} +
...
+{% endhighlight %} +

Optional classes

+

Control padding and rounded corners with two optional modifier classes.

+
+
+ Look, I'm in a well! +
+
+{% highlight html %} +
...
+{% endhighlight %} + +
+
+ Look, I'm in a well! +
+
+{% highlight html %} +
...
+{% endhighlight %} +
-- cgit v1.2.3