From 5f3473258e5e9f3d2d9da165312e8374c55250e6 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Sat, 18 Mar 2017 16:49:55 -0700 Subject: add header and footer to example --- docs/components/card.md | 2 ++ 1 file changed, 2 insertions(+) (limited to 'docs/components/card.md') diff --git a/docs/components/card.md b/docs/components/card.md index b45d13463..dc8a921b8 100644 --- a/docs/components/card.md +++ b/docs/components/card.md @@ -376,11 +376,13 @@ You can also use `.card-inverse` with the [contextual backgrounds variants](#bac {% example html %}
+
Header

Special title treatment

With supporting text below as a natural lead-in to additional content.

Go somewhere
+
Footer
{% endexample %} -- cgit v1.2.3 From fe3acc097ac9def6569f471ef25d444020c30057 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Mon, 27 Mar 2017 22:52:24 -0700 Subject: Card image fixes (#22288) * fix image stretching due to flexbox * fix broke text-muted on dark bg * no img-fluid needed --- docs/components/card.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) (limited to 'docs/components/card.md') diff --git a/docs/components/card.md b/docs/components/card.md index dc8a921b8..74debae44 100644 --- a/docs/components/card.md +++ b/docs/components/card.md @@ -359,7 +359,7 @@ Turn an image into a card background and overlay your card's text. Depending on

Card title

This is a wider card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.

-

Last updated 3 mins ago

+

Last updated 3 mins ago

{% endexample %} @@ -644,7 +644,7 @@ Cards can be organized into [Masonry](http://masonry.desandro.com)-like columns {% example html %}
- Card image cap + Card image cap

Card title that wraps to a new line

This is a longer card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.

@@ -661,7 +661,7 @@ Cards can be organized into [Masonry](http://masonry.desandro.com)-like columns
- Card image cap + Card image cap

Card title

This card has supporting text below as a natural lead-in to additional content.

@@ -686,7 +686,7 @@ Cards can be organized into [Masonry](http://masonry.desandro.com)-like columns
- Card image + Card image
-- cgit v1.2.3 From c72cc98bd56fb50259c84a1fced38751009eb930 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Sat, 27 May 2017 23:01:14 -0700 Subject: update components docs --- docs/components/card.md | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) (limited to 'docs/components/card.md') diff --git a/docs/components/card.md b/docs/components/card.md index 74debae44..ff3096ec2 100644 --- a/docs/components/card.md +++ b/docs/components/card.md @@ -3,17 +3,15 @@ layout: docs title: Cards description: Bootstrap's cards provide a flexible and extensible content container with multiple variants and options. group: components +toc: true --- +## About + A **card** is a flexible and extensible content container. It includes options for headers and footers, a wide variety of content, contextual background colors, and powerful display options. If you're familiar with Bootstrap 3, cards replace our old panels, wells, and thumbnails. Similar functionality to those components is available as modifier classes for cards. -## Contents - -* Will be replaced with the ToC, excluding the "Contents" header -{:toc} - ## Example Cards are built with as little markup and styles as possible, but still manage to deliver a ton of control and customization. Built with flexbox, they offer easy alignment and mix well with other Bootstrap components. -- cgit v1.2.3 From 3e76d6565603fafa2c85ad81d7b6345c4e279c72 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Sun, 28 May 2017 22:50:57 -0700 Subject: Rearrange all the docs to allow for a docs/major.minor/ setup --- docs/components/card.md | 720 ------------------------------------------------ 1 file changed, 720 deletions(-) delete mode 100644 docs/components/card.md (limited to 'docs/components/card.md') diff --git a/docs/components/card.md b/docs/components/card.md deleted file mode 100644 index ff3096ec2..000000000 --- a/docs/components/card.md +++ /dev/null @@ -1,720 +0,0 @@ ---- -layout: docs -title: Cards -description: Bootstrap's cards provide a flexible and extensible content container with multiple variants and options. -group: components -toc: true ---- - -## About - -A **card** is a flexible and extensible content container. It includes options for headers and footers, a wide variety of content, contextual background colors, and powerful display options. - -If you're familiar with Bootstrap 3, cards replace our old panels, wells, and thumbnails. Similar functionality to those components is available as modifier classes for cards. - -## Example - -Cards are built with as little markup and styles as possible, but still manage to deliver a ton of control and customization. Built with flexbox, they offer easy alignment and mix well with other Bootstrap components. - -Below is an example of a basic card with mixed content and a fixed width. Cards have no fixed width to start, so they'll naturally fill the full width of its parent element. This is easily customized with our various [sizing options](#sizing). - -{% example html %} -
- Card image cap -
-

Card title

-

Some quick example text to build on the card title and make up the bulk of the card's content.

- Go somewhere -
-
-{% endexample %} - -## Content types - -Cards support a wide variety of content, including images, text, list groups, links, and more. Below are examples of what's supported. - -### Blocks - -The building block of a card is the `.card-block`. Use it whenever you need a padded section within a card. - -{% example html %} -
-
- This is some text within a card block. -
-
-{% endexample %} - -### Titles, text, and links - -Card titles are used by adding `.card-title` to a `` tag. In the same way, links are added and placed next to each other by adding `.card-link` to a `` tag. - -Subtitles are used by adding a `.card-subtitle` to a `` tag. If the `.card-title` and the `.card-subtitle` items are placed in a `.card-block` item, the card title and subtitle are aligned nicely. - -{% example html %} -
-
-

Card title

-
Card subtitle
-

Some quick example text to build on the card title and make up the bulk of the card's content.

- Card link - Another link -
-
-{% endexample %} - -### Images - -`.card-img-top` places an image to the top of the card. With `.card-text`, text can be added to the card. Text within `.card-text` can also be styled with the standard HTML tags. - -{% example html %} -
- Card image cap -
-

Some quick example text to build on the card title and make up the bulk of the card's content.

-
-
-{% endexample %} - -### List groups - -Create lists of content in a card with a flush list group. - -{% example html %} -
-
    -
  • Cras justo odio
    • -
  • Dapibus ac facilisis in
    • -
  • Vestibulum at eros
    • -
-
-{% endexample %} - -### Kitchen sink - -Mix and match multiple content types to create the card you need, or throw everything in there. Shown below are image styles, blocks, text styles, and a list group—all wrapped in a fixed-width card. - -{% example html %} -
- Card image cap -
-

Card title

-

Some quick example text to build on the card title and make up the bulk of the card's content.

-
-
    -
  • Cras justo odio
    • -
  • Dapibus ac facilisis in
    • -
  • Vestibulum at eros
    • -
-
- Card link - Another link -
-
-{% endexample %} - -### Header and footer - -Add an optional header and/or footer within a card. - -{% example html %} -
-
- Featured -
-
-

Special title treatment

-

With supporting text below as a natural lead-in to additional content.

- Go somewhere -
-
-{% endexample %} - -Card headers can be styled by adding `.card-header` to `` elements. - -{% example html %} -
-

Featured

-
-

Special title treatment

-

With supporting text below as a natural lead-in to additional content.

- Go somewhere -
-
-{% endexample %} - -{% example html %} -
-
- Quote -
-
-
-

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.

-
Someone famous in Source Title
-
-
-
-{% endexample %} - -{% example html %} -
-
- Featured -
-
-

Special title treatment

-

With supporting text below as a natural lead-in to additional content.

- Go somewhere -
-
- 2 days ago -
-
-{% endexample %} - -## Sizing - -Cards assume no specific `width` to start, so they'll be 100% wide unless otherwise stated. You can change this as needed with custom CSS, grid classes, grid Sass mixins, or utilities. - -### Using grid markup - -Using the grid, wrap cards in columns and rows as needed. - -{% example html %} -
-
-
-
-

Special title treatment

-

With supporting text below as a natural lead-in to additional content.

- Go somewhere -
-
-
-
-
-
-

Special title treatment

-

With supporting text below as a natural lead-in to additional content.

- Go somewhere -
-
-
-
-{% endexample %} - -### Using utilities - -Use our handful of [available sizing utilities]({{ site.baseurl }}/utilities/sizing/) to quickly set a card's width. - -{% example html %} -
-
-

Card title

-

With supporting text below as a natural lead-in to additional content.

- Button -
-
- -
-
-

Card title

-

With supporting text below as a natural lead-in to additional content.

- Button -
-
-{% endexample %} - -### Using custom CSS - -Use custom CSS in your stylesheets or as inline styles to set a width. - -{% example html %} -
-
-

Special title treatment

-

With supporting text below as a natural lead-in to additional content.

- Go somewhere -
-
-{% endexample %} - -## Text alignment - -You can quickly change the text alignment of any card—in its entirety or specific parts—with our [text align classes]({{ site.baseurl }}/utilities/typography/#text-alignment). - -{% example html %} -
-
-

Special title treatment

-

With supporting text below as a natural lead-in to additional content.

- Go somewhere -
-
- -
-
-

Special title treatment

-

With supporting text below as a natural lead-in to additional content.

- Go somewhere -
-
- -
-
-

Special title treatment

-

With supporting text below as a natural lead-in to additional content.

- Go somewhere -
-
-{% endexample %} - -## Navigation - -Add some navigation to a card's header (or block) with Bootstrap's [nav components]({{ site.baseurl }}/components/navs/). - -{% example html %} -
-
- -
-
-

Special title treatment

-

With supporting text below as a natural lead-in to additional content.

- Go somewhere -
-
-{% endexample %} - -{% example html %} -
-
- -
-
-

Special title treatment

-

With supporting text below as a natural lead-in to additional content.

- Go somewhere -
-
-{% endexample %} - -## Images - -Cards include a few options for working with images. Choose from appending "image caps" at either end of a card, overlaying images with card content, or simply embedding the image in a card. - -### Image caps - -Similar to headers and footers, cards can include top and bottom "image caps"—images at the top or bottom of a card. - -{% example html %} -
- Card image cap -
-

Card title

-

This is a wider card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.

-

Last updated 3 mins ago

-
-
-
-
-

Card title

-

This is a wider card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.

-

Last updated 3 mins ago

-
- Card image cap -
-{% endexample %} - -### Image overlays - -Turn an image into a card background and overlay your card's text. Depending on the image, you may or may not need `.card-inverse` (see below). - -{% example html %} -
- Card image -
-

Card title

-

This is a wider card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.

-

Last updated 3 mins ago

-
-
-{% endexample %} - -## Card styles - -Cards include various options for customizing their backgrounds, borders, and color. - -### Inverted text - -By default, cards use dark text and assume a light background. You can reverse that by toggling the `color` of text within, as well as that of the card's subcomponents, with `.card-inverse`. Then, specify a dark `background-color` and `border-color` to go with it. - -You can also use `.card-inverse` with the [contextual backgrounds variants](#background-variants). - -{% example html %} -
-
Header
-
-

Special title treatment

-

With supporting text below as a natural lead-in to additional content.

- Go somewhere -
-
Footer
-
-{% endexample %} - -### Background variants - -Cards include their own variant classes for quickly changing the `background-color` and `border-color` of a card. **Darker colors require the use of `.card-inverse`.** - -{% example html %} -
-
-
-

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.

-
Someone famous in Source Title
-
-
-
-
-
-
-

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.

-
Someone famous in Source Title
-
-
-
-
-
-
-

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.

-
Someone famous in Source Title
-
-
-
-
-
-
-

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.

-
Someone famous in Source Title
-
-
-
-
-
-
-

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.

-
Someone famous in Source Title
-
-
-
-{% endexample %} - -{% capture callout-include %}{% include callout-warning-color-assistive-technologies.md %}{% endcapture %} -{{ callout-include | markdownify }} - -### Outline cards - -In need of a colored card, but not the hefty background colors they bring? Replace the default modifier classes with the `.card-outline-*` ones to style just the `border-color` of a card. - -{% example html %} -
-
-
-

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.

-
Someone famous in Source Title
-
-
-
-
-
-
-

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.

-
Someone famous in Source Title
-
-
-
-
-
-
-

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.

-
Someone famous in Source Title
-
-
-
-
-
-
-

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.

-
Someone famous in Source Title
-
-
-
-
-
-
-

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.

-
Someone famous in Source Title
-
-
-
-
-
-
-

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.

-
Someone famous in Source Title
-
-
-
-{% endexample %} - -## Card layout - -In addition to styling the content within cards, Bootstrap includes a few options for laying out series of cards. For the time being, **these layout options are not yet responsive**. - -### Card groups - -Use card groups to render cards as a single, attached element with equal width and height columns. Card groups use `display: flex;` to achieve their uniform sizing. - -{% example html %} -
-
- Card image cap -
-

Card title

-

This is a wider card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.

-

Last updated 3 mins ago

-
-
-
- Card image cap -
-

Card title

-

This card has supporting text below as a natural lead-in to additional content.

-

Last updated 3 mins ago

-
-
-
- Card image cap -
-

Card title

-

This is a wider card with supporting text below as a natural lead-in to additional content. This card has even longer content than the first to show that equal height action.

-

Last updated 3 mins ago

-
-
-
-{% endexample %} - -When using card groups with footers, their content will automatically line up. - -{% example html %} -
-
- Card image cap -
-

Card title

-

This is a wider card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.

-
-
- Last updated 3 mins ago -
-
-
- Card image cap -
-

Card title

-

This card has supporting text below as a natural lead-in to additional content.

-
-
- Last updated 3 mins ago -
-
-
- Card image cap -
-

Card title

-

This is a wider card with supporting text below as a natural lead-in to additional content. This card has even longer content than the first to show that equal height action.

-
-
- Last updated 3 mins ago -
-
-
-{% endexample %} - -### Card decks - -Need a set of equal width and height cards that aren't attached to one another? Use card decks. - -{% example html %} -
-
- Card image cap -
-

Card title

-

This is a longer card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.

-

Last updated 3 mins ago

-
-
-
- Card image cap -
-

Card title

-

This card has supporting text below as a natural lead-in to additional content.

-

Last updated 3 mins ago

-
-
-
- Card image cap -
-

Card title

-

This is a wider card with supporting text below as a natural lead-in to additional content. This card has even longer content than the first to show that equal height action.

-

Last updated 3 mins ago

-
-
-
-{% endexample %} - -Just like with card groups, card footers in decks will automatically line up. - -{% example html %} -
-
- Card image cap -
-

Card title

-

This is a wider card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.

-
-
- Last updated 3 mins ago -
-
-
- Card image cap -
-

Card title

-

This card has supporting text below as a natural lead-in to additional content.

-
-
- Last updated 3 mins ago -
-
-
- Card image cap -
-

Card title

-

This is a wider card with supporting text below as a natural lead-in to additional content. This card has even longer content than the first to show that equal height action.

-
-
- Last updated 3 mins ago -
-
-
-{% endexample %} - -### Card columns - -Cards can be organized into [Masonry](http://masonry.desandro.com)-like columns with just CSS by wrapping them in `.card-columns`. Cards are built with CSS `column` properties instead of flexbox for easier alignment. Cards are ordered from top to bottom and left to right. - -**Heads up!** Your mileage with card columns may vary. To prevent cards breaking across columns, we must set them to `display: inline-block` as `column-break-inside: avoid` isn't a bulletproof solution yet. - -{% example html %} -
-
- Card image cap -
-

Card title that wraps to a new line

-

This is a longer card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.

-
-
-
-
-

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.

-
- - Someone famous in Source Title - -
-
-
-
- Card image cap -
-

Card title

-

This card has supporting text below as a natural lead-in to additional content.

-

Last updated 3 mins ago

-
-
-
-
-

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat.

-
- - Someone famous in Source Title - -
-
-
-
-
-

Card title

-

This card has supporting text below as a natural lead-in to additional content.

-

Last updated 3 mins ago

-
-
-
- Card image -
-
-
-

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.

-
- - Someone famous in Source Title - -
-
-
-
-
-

Card title

-

This is a wider card with supporting text below as a natural lead-in to additional content. This card has even longer content than the first to show that equal height action.

-

Last updated 3 mins ago

-
-
-
-{% endexample %} - -Card columns can also be extended and customized with some additional code. Shown below is an extension of the `.card-columns` class using the same CSS we use—CSS columns— to generate a set of responsive tiers for changing the number of columns. - -{% highlight scss %} -.card-columns { - @include media-breakpoint-only(lg) { - column-count: 4; - } - @include media-breakpoint-only(xl) { - column-count: 5; - } -} -{% endhighlight %} -- cgit v1.2.3