0
0
mirror of https://github.com/twbs/bootstrap.git synced 2024-12-13 01:08:58 +01:00
Bootstrap/site/docs/4.5/components/card.md

862 lines
35 KiB
Markdown
Raw Normal View History

2014-08-06 02:12:24 +02:00
---
layout: docs
2014-08-06 02:12:24 +02:00
title: Cards
description: Bootstrap's cards provide a flexible and extensible content container with multiple variants and options.
group: components
2017-05-28 08:01:14 +02:00
toc: true
2014-08-06 02:12:24 +02:00
---
2017-05-28 08:01:14 +02:00
## About
2017-10-23 04:31:59 +02:00
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.
2014-08-06 02:12:24 +02:00
2015-05-28 23:07:34 +02:00
## Example
2014-08-06 02:12:24 +02:00
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. They have no `margin` by default, so use [spacing utilities]({{ site.baseurl }}/docs/{{ site.docs_version }}/utilities/spacing/) as needed.
2016-12-23 01:41:56 +01:00
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).
2014-08-06 02:12:24 +02:00
2018-03-14 16:44:38 +01:00
{% capture example %}
<div class="card" style="width: 18rem;">
{% include icons/placeholder.svg width="100%" height="180" class="card-img-top" text="Image cap" %}
<div class="card-body">
<h5 class="card-title">Card title</h5>
2015-05-28 23:07:34 +02:00
<p class="card-text">Some quick example text to build on the card title and make up the bulk of the card's content.</p>
<a href="#" class="btn btn-primary">Go somewhere</a>
2015-05-28 23:07:34 +02:00
</div>
2014-08-06 02:12:24 +02:00
</div>
2018-03-14 16:44:38 +01:00
{% endcapture %}
{% include example.html content=example %}
2014-08-06 02:12:24 +02:00
2015-05-28 23:07:34 +02:00
## Content types
2015-04-23 10:33:19 +02:00
Cards support a wide variety of content, including images, text, list groups, links, and more. Below are examples of what's supported.
2015-04-23 10:33:19 +02:00
### Body
2015-05-28 04:00:11 +02:00
The building block of a card is the `.card-body`. Use it whenever you need a padded section within a card.
2018-03-14 16:44:38 +01:00
{% capture example %}
<div class="card">
<div class="card-body">
This is some text within a card body.
2015-05-28 23:07:34 +02:00
</div>
2015-05-28 04:00:11 +02:00
</div>
2018-03-14 16:44:38 +01:00
{% endcapture %}
{% include example.html content=example %}
2015-05-28 23:07:34 +02:00
### Titles, text, and links
2017-10-04 11:46:36 +02:00
Card titles are used by adding `.card-title` to a `<h*>` tag. In the same way, links are added and placed next to each other by adding `.card-link` to an `<a>` tag.
2015-05-28 23:07:34 +02:00
Subtitles are used by adding a `.card-subtitle` to a `<h*>` tag. If the `.card-title` and the `.card-subtitle` items are placed in a `.card-body` item, the card title and subtitle are aligned nicely.
2018-03-14 16:44:38 +01:00
{% capture example %}
<div class="card" style="width: 18rem;">
<div class="card-body">
<h5 class="card-title">Card title</h5>
<h6 class="card-subtitle mb-2 text-muted">Card subtitle</h6>
2015-05-28 23:07:34 +02:00
<p class="card-text">Some quick example text to build on the card title and make up the bulk of the card's content.</p>
<a href="#" class="card-link">Card link</a>
<a href="#" class="card-link">Another link</a>
</div>
2015-04-23 10:33:19 +02:00
</div>
2018-03-14 16:44:38 +01:00
{% endcapture %}
{% include example.html content=example %}
2015-04-23 10:33:19 +02:00
### Images
2015-05-28 23:07:34 +02:00
`.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.
2015-05-28 04:00:11 +02:00
2018-03-14 16:44:38 +01:00
{% capture example %}
<div class="card" style="width: 18rem;">
{% include icons/placeholder.svg width="100%" height="180" class="card-img-top" text="Image cap" %}
<div class="card-body">
<p class="card-text">Some quick example text to build on the card title and make up the bulk of the card's content.</p>
2015-04-23 10:33:19 +02:00
</div>
</div>
2018-03-14 16:44:38 +01:00
{% endcapture %}
{% include example.html content=example %}
2015-04-23 10:33:19 +02:00
### List groups
Create lists of content in a card with a flush list group.
2015-05-28 04:00:11 +02:00
2018-03-14 16:44:38 +01:00
{% capture example %}
<div class="card" style="width: 18rem;">
<ul class="list-group list-group-flush">
<li class="list-group-item">Cras justo odio</li>
<li class="list-group-item">Dapibus ac facilisis in</li>
<li class="list-group-item">Vestibulum at eros</li>
</ul>
2015-05-28 04:00:11 +02:00
</div>
2018-03-14 16:44:38 +01:00
{% endcapture %}
{% include example.html content=example %}
2015-05-28 04:00:11 +02:00
2018-03-14 16:44:38 +01:00
{% capture example %}
<div class="card" style="width: 18rem;">
<div class="card-header">
Featured
</div>
<ul class="list-group list-group-flush">
<li class="list-group-item">Cras justo odio</li>
<li class="list-group-item">Dapibus ac facilisis in</li>
<li class="list-group-item">Vestibulum at eros</li>
</ul>
</div>
2018-03-14 16:44:38 +01:00
{% endcapture %}
{% include example.html content=example %}
### Kitchen sink
2014-08-06 02:12:24 +02:00
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.
2014-08-06 02:12:24 +02:00
2018-03-14 16:44:38 +01:00
{% capture example %}
<div class="card" style="width: 18rem;">
{% include icons/placeholder.svg width="100%" height="180" class="card-img-top" text="Image cap" %}
<div class="card-body">
<h5 class="card-title">Card title</h5>
<p class="card-text">Some quick example text to build on the card title and make up the bulk of the card's content.</p>
</div>
<ul class="list-group list-group-flush">
<li class="list-group-item">Cras justo odio</li>
<li class="list-group-item">Dapibus ac facilisis in</li>
<li class="list-group-item">Vestibulum at eros</li>
</ul>
<div class="card-body">
<a href="#" class="card-link">Card link</a>
<a href="#" class="card-link">Another link</a>
</div>
2014-08-06 02:12:24 +02:00
</div>
2018-03-14 16:44:38 +01:00
{% endcapture %}
{% include example.html content=example %}
2014-08-06 02:12:24 +02:00
### Header and footer
2014-08-06 02:12:24 +02:00
Add an optional header and/or footer within a card.
2018-03-14 16:44:38 +01:00
{% capture example %}
2014-08-06 02:12:24 +02:00
<div class="card">
<div class="card-header">
Featured
</div>
<div class="card-body">
<h5 class="card-title">Special title treatment</h5>
2015-05-28 23:07:34 +02:00
<p class="card-text">With supporting text below as a natural lead-in to additional content.</p>
<a href="#" class="btn btn-primary">Go somewhere</a>
</div>
</div>
2018-03-14 16:44:38 +01:00
{% endcapture %}
{% include example.html content=example %}
Card headers can be styled by adding `.card-header` to `<h*>` elements.
2018-03-14 16:44:38 +01:00
{% capture example %}
<div class="card">
<h5 class="card-header">Featured</h5>
<div class="card-body">
<h5 class="card-title">Special title treatment</h5>
<p class="card-text">With supporting text below as a natural lead-in to additional content.</p>
2015-05-28 23:07:34 +02:00
<a href="#" class="btn btn-primary">Go somewhere</a>
</div>
2014-08-06 02:12:24 +02:00
</div>
2018-03-14 16:44:38 +01:00
{% endcapture %}
{% include example.html content=example %}
2014-08-06 02:12:24 +02:00
2018-03-14 16:44:38 +01:00
{% capture example %}
2014-08-06 02:12:24 +02:00
<div class="card">
<div class="card-header">
Quote
</div>
<div class="card-body">
2017-07-01 00:15:24 +02:00
<blockquote class="blockquote mb-0">
2015-05-28 23:07:34 +02:00
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.</p>
2017-07-01 00:15:24 +02:00
<footer class="blockquote-footer">Someone famous in <cite title="Source Title">Source Title</cite></footer>
2015-05-28 23:07:34 +02:00
</blockquote>
</div>
2014-08-06 02:12:24 +02:00
</div>
2018-03-14 16:44:38 +01:00
{% endcapture %}
{% include example.html content=example %}
2014-08-06 02:12:24 +02:00
2018-03-14 16:44:38 +01:00
{% capture example %}
<div class="card text-center">
2014-08-06 02:12:24 +02:00
<div class="card-header">
Featured
</div>
<div class="card-body">
<h5 class="card-title">Special title treatment</h5>
2015-05-28 23:07:34 +02:00
<p class="card-text">With supporting text below as a natural lead-in to additional content.</p>
<a href="#" class="btn btn-primary">Go somewhere</a>
</div>
2014-08-06 02:12:24 +02:00
<div class="card-footer text-muted">
2 days ago
</div>
</div>
2018-03-14 16:44:38 +01:00
{% endcapture %}
{% include example.html content=example %}
2014-08-06 02:12:24 +02:00
## Sizing
2016-01-18 03:55:24 +01:00
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.
2018-03-14 16:44:38 +01:00
{% capture example %}
<div class="row">
<div class="col-sm-6">
<div class="card">
<div class="card-body">
<h5 class="card-title">Special title treatment</h5>
<p class="card-text">With supporting text below as a natural lead-in to additional content.</p>
<a href="#" class="btn btn-primary">Go somewhere</a>
</div>
</div>
</div>
<div class="col-sm-6">
<div class="card">
<div class="card-body">
<h5 class="card-title">Special title treatment</h5>
<p class="card-text">With supporting text below as a natural lead-in to additional content.</p>
<a href="#" class="btn btn-primary">Go somewhere</a>
</div>
</div>
</div>
</div>
2018-03-14 16:44:38 +01:00
{% endcapture %}
{% include example.html content=example %}
### Using utilities
2017-05-29 20:38:06 +02:00
Use our handful of [available sizing utilities]({{ site.baseurl }}/docs/{{ site.docs_version }}/utilities/sizing/) to quickly set a card's width.
2018-03-14 16:44:38 +01:00
{% capture example %}
<div class="card w-75">
<div class="card-body">
<h5 class="card-title">Card title</h5>
<p class="card-text">With supporting text below as a natural lead-in to additional content.</p>
<a href="#" class="btn btn-primary">Button</a>
</div>
</div>
<div class="card w-50">
<div class="card-body">
<h5 class="card-title">Card title</h5>
<p class="card-text">With supporting text below as a natural lead-in to additional content.</p>
<a href="#" class="btn btn-primary">Button</a>
</div>
</div>
2018-03-14 16:44:38 +01:00
{% endcapture %}
{% include example.html content=example %}
### Using custom CSS
Use custom CSS in your stylesheets or as inline styles to set a width.
2018-03-14 16:44:38 +01:00
{% capture example %}
<div class="card" style="width: 18rem;">
<div class="card-body">
<h5 class="card-title">Special title treatment</h5>
<p class="card-text">With supporting text below as a natural lead-in to additional content.</p>
<a href="#" class="btn btn-primary">Go somewhere</a>
</div>
</div>
2018-03-14 16:44:38 +01:00
{% endcapture %}
{% include example.html content=example %}
2016-01-18 03:55:24 +01:00
2016-12-23 01:44:33 +01:00
## 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 }}/docs/{{ site.docs_version }}/utilities/text/#text-alignment).
2016-12-23 01:44:33 +01:00
2018-03-14 16:44:38 +01:00
{% capture example %}
<div class="card" style="width: 18rem;">
<div class="card-body">
<h5 class="card-title">Special title treatment</h5>
2016-12-23 01:44:33 +01:00
<p class="card-text">With supporting text below as a natural lead-in to additional content.</p>
<a href="#" class="btn btn-primary">Go somewhere</a>
</div>
</div>
<div class="card text-center" style="width: 18rem;">
<div class="card-body">
<h5 class="card-title">Special title treatment</h5>
2016-12-23 01:44:33 +01:00
<p class="card-text">With supporting text below as a natural lead-in to additional content.</p>
<a href="#" class="btn btn-primary">Go somewhere</a>
</div>
</div>
<div class="card text-right" style="width: 18rem;">
<div class="card-body">
<h5 class="card-title">Special title treatment</h5>
2016-12-23 01:44:33 +01:00
<p class="card-text">With supporting text below as a natural lead-in to additional content.</p>
<a href="#" class="btn btn-primary">Go somewhere</a>
</div>
</div>
2018-03-14 16:44:38 +01:00
{% endcapture %}
{% include example.html content=example %}
2016-12-23 01:44:39 +01:00
## Navigation
2017-05-29 20:38:06 +02:00
Add some navigation to a card's header (or block) with Bootstrap's [nav components]({{ site.baseurl }}/docs/{{ site.docs_version }}/components/navs/).
2016-12-23 01:44:39 +01:00
2018-03-14 16:44:38 +01:00
{% capture example %}
<div class="card text-center">
2016-01-18 03:55:24 +01:00
<div class="card-header">
<ul class="nav nav-tabs card-header-tabs">
2016-01-18 03:55:24 +01:00
<li class="nav-item">
<a class="nav-link active" href="#">Active</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#">Link</a>
</li>
<li class="nav-item">
<a class="nav-link disabled" href="#" tabindex="-1" aria-disabled="true">Disabled</a>
2016-01-18 03:55:24 +01:00
</li>
</ul>
</div>
<div class="card-body">
<h5 class="card-title">Special title treatment</h5>
2016-01-18 03:55:24 +01:00
<p class="card-text">With supporting text below as a natural lead-in to additional content.</p>
<a href="#" class="btn btn-primary">Go somewhere</a>
</div>
</div>
2018-03-14 16:44:38 +01:00
{% endcapture %}
{% include example.html content=example %}
2016-01-18 03:55:24 +01:00
2018-03-14 16:44:38 +01:00
{% capture example %}
<div class="card text-center">
2016-01-18 03:55:24 +01:00
<div class="card-header">
<ul class="nav nav-pills card-header-pills">
2016-01-18 03:55:24 +01:00
<li class="nav-item">
<a class="nav-link active" href="#">Active</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#">Link</a>
</li>
<li class="nav-item">
<a class="nav-link disabled" href="#" tabindex="-1" aria-disabled="true">Disabled</a>
2016-01-18 03:55:24 +01:00
</li>
</ul>
</div>
<div class="card-body">
<h5 class="card-title">Special title treatment</h5>
2016-01-18 03:55:24 +01:00
<p class="card-text">With supporting text below as a natural lead-in to additional content.</p>
<a href="#" class="btn btn-primary">Go somewhere</a>
</div>
</div>
2018-03-14 16:44:38 +01:00
{% endcapture %}
{% include example.html content=example %}
2016-01-18 03:55:24 +01:00
## Images
2014-08-06 02:12:24 +02:00
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.
2014-08-06 02:12:24 +02:00
<div class="bd-example">
<div class="card mb-3">
{% include icons/placeholder.svg width="100%" height="180" class="card-img-top" text="Image cap" %}
<div class="card-body">
<h5 class="card-title">Card title</h5>
<p class="card-text">This is a wider card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.</p>
<p class="card-text"><small class="text-muted">Last updated 3 mins ago</small></p>
</div>
</div>
<div class="card">
<div class="card-body">
<h5 class="card-title">Card title</h5>
<p class="card-text">This is a wider card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.</p>
<p class="card-text"><small class="text-muted">Last updated 3 mins ago</small></p>
</div>
{% include icons/placeholder.svg width="100%" height="180" class="card-img-bottom" text="Image cap" %}
</div>
</div>
{% highlight html %}
<div class="card mb-3">
<img src="..." class="card-img-top" alt="...">
<div class="card-body">
<h5 class="card-title">Card title</h5>
2015-05-28 23:07:34 +02:00
<p class="card-text">This is a wider card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.</p>
<p class="card-text"><small class="text-muted">Last updated 3 mins ago</small></p>
</div>
2014-08-06 02:12:24 +02:00
</div>
<div class="card">
<div class="card-body">
<h5 class="card-title">Card title</h5>
2015-05-28 23:07:34 +02:00
<p class="card-text">This is a wider card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.</p>
<p class="card-text"><small class="text-muted">Last updated 3 mins ago</small></p>
</div>
<img src="..." class="card-img-bottom" alt="...">
2014-08-06 02:12:24 +02:00
</div>
{% endhighlight %}
2014-08-06 02:12:24 +02:00
### Image overlays
2014-08-06 02:12:24 +02:00
2017-07-01 00:26:40 +02:00
Turn an image into a card background and overlay your card's text. Depending on the image, you may or may not need additional styles or utilities.
2014-08-06 02:12:24 +02:00
2018-03-14 16:44:38 +01:00
{% capture example %}
2017-07-01 00:28:50 +02:00
<div class="card bg-dark text-white">
{% include icons/placeholder.svg width="100%" height="270" class="bd-placeholder-img-lg card-img" text="Card image" %}
2014-08-06 02:12:24 +02:00
<div class="card-img-overlay">
<h5 class="card-title">Card title</h5>
2014-08-06 02:12:24 +02:00
<p class="card-text">This is a wider card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.</p>
<p class="card-text">Last updated 3 mins ago</p>
2014-08-06 02:12:24 +02:00
</div>
</div>
2018-03-14 16:44:38 +01:00
{% endcapture %}
{% include example.html content=example %}
{% capture callout %}
Note that content should not be larger than the height of the image. If content is larger than the image the content will be displayed outside the image.
{% endcapture %}
{% include callout.html content=callout type="info" %}
2014-08-06 02:12:24 +02:00
2018-12-23 14:00:51 +01:00
## Horizontal
Using a combination of grid and utility classes, cards can be made horizontal in a mobile-friendly and responsive way. In the example below, we remove the grid gutters with `.no-gutters` and use `.col-md-*` classes to make the card horizontal at the `md` breakpoint. Further adjustments may be needed depending on your card content.
{% capture example %}
<div class="card mb-3" style="max-width: 540px;">
<div class="row no-gutters">
<div class="col-md-4">
{% include icons/placeholder.svg width="100%" height="250" class="" text="Image" %}
</div>
<div class="col-md-8">
<div class="card-body">
<h5 class="card-title">Card title</h5>
<p class="card-text">This is a wider card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.</p>
<p class="card-text"><small class="text-muted">Last updated 3 mins ago</small></p>
</div>
</div>
</div>
</div>
{% endcapture %}
{% include example.html content=example %}
2016-12-23 01:45:48 +01:00
## Card styles
Cards include various options for customizing their backgrounds, borders, and color.
### Background and color
2014-08-06 02:12:24 +02:00
Use [text and background utilities]({{ site.baseurl }}/docs/{{ site.docs_version }}/utilities/colors/) to change the appearance of a card.
2014-08-06 02:12:24 +02:00
2018-03-14 16:44:38 +01:00
{% capture example %}
{% for color in site.data.theme-colors %}
<div class="card{% unless color.name == "light" %} text-white{% endunless %} bg-{{ color.name }} mb-3" style="max-width: 18rem;">
2017-03-19 00:49:55 +01:00
<div class="card-header">Header</div>
<div class="card-body">
<h5 class="card-title">{{ color.name | capitalize }} card title</h5>
<p class="card-text">Some quick example text to build on the card title and make up the bulk of the card's content.</p>
2015-05-28 23:07:34 +02:00
</div>
</div>{% endfor %}
2018-03-14 16:44:38 +01:00
{% endcapture %}
{% include example.html content=example %}
2014-08-06 02:12:24 +02:00
{% include callout-warning-color-assistive-technologies.md %}
2014-08-06 02:12:24 +02:00
### Border
Use [border utilities]({{ site.baseurl }}/docs/{{ site.docs_version }}/utilities/borders/) to change just the `border-color` of a card. Note that you can put `.text-{color}` classes on the parent `.card` or a subset of the card's contents as shown below.
2014-08-06 02:12:24 +02:00
2018-03-14 16:44:38 +01:00
{% capture example %}
{% for color in site.data.theme-colors %}
<div class="card border-{{ color.name }} mb-3" style="max-width: 18rem;">
<div class="card-header">Header</div>
<div class="card-body{% unless color.name == "light" %} text-{{ color.name }}{% endunless %}">
<h5 class="card-title">{{ color.name | capitalize }} card title</h5>
<p class="card-text">Some quick example text to build on the card title and make up the bulk of the card's content.</p>
2015-12-09 10:02:04 +01:00
</div>
</div>{% endfor %}
2018-03-14 16:44:38 +01:00
{% endcapture %}
{% include example.html content=example %}
2015-12-09 10:02:04 +01:00
### Mixins utilities
You can also change the borders on the card header and footer as needed, and even remove their `background-color` with `.bg-transparent`.
2015-12-09 10:02:04 +01:00
2018-03-14 16:44:38 +01:00
{% capture example %}
<div class="card border-success mb-3" style="max-width: 18rem;">
<div class="card-header bg-transparent border-success">Header</div>
<div class="card-body text-success">
<h5 class="card-title">Success card title</h5>
<p class="card-text">Some quick example text to build on the card title and make up the bulk of the card's content.</p>
2015-05-28 23:07:34 +02:00
</div>
<div class="card-footer bg-transparent border-success">Footer</div>
2014-08-06 02:12:24 +02:00
</div>
2018-03-14 16:44:38 +01:00
{% endcapture %}
{% include example.html content=example %}
2014-08-06 02:12:24 +02:00
## Card layout
2014-08-06 02:12:24 +02:00
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**.
2014-08-06 02:12:24 +02:00
### Card groups
Use card groups to render cards as a single, attached element with equal width and height columns. Card groups start off stacked and use `display: flex;` to become attached with uniform dimensions starting at the `sm` breakpoint.
2018-03-14 16:44:38 +01:00
{% capture example %}
2014-08-06 02:12:24 +02:00
<div class="card-group">
<div class="card">
{% include icons/placeholder.svg width="100%" height="180" class="card-img-top" text="Image cap" %}
<div class="card-body">
<h5 class="card-title">Card title</h5>
2015-05-28 23:07:34 +02:00
<p class="card-text">This is a wider card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.</p>
<p class="card-text"><small class="text-muted">Last updated 3 mins ago</small></p>
</div>
2014-08-06 02:12:24 +02:00
</div>
<div class="card">
{% include icons/placeholder.svg width="100%" height="180" class="card-img-top" text="Image cap" %}
<div class="card-body">
<h5 class="card-title">Card title</h5>
2015-05-28 23:07:34 +02:00
<p class="card-text">This card has supporting text below as a natural lead-in to additional content.</p>
<p class="card-text"><small class="text-muted">Last updated 3 mins ago</small></p>
</div>
2014-08-06 02:12:24 +02:00
</div>
<div class="card">
{% include icons/placeholder.svg width="100%" height="180" class="card-img-top" text="Image cap" %}
<div class="card-body">
<h5 class="card-title">Card title</h5>
2015-05-28 23:07:34 +02:00
<p class="card-text">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.</p>
<p class="card-text"><small class="text-muted">Last updated 3 mins ago</small></p>
</div>
2014-08-06 02:12:24 +02:00
</div>
</div>
2018-03-14 16:44:38 +01:00
{% endcapture %}
{% include example.html content=example %}
2014-08-06 02:12:24 +02:00
When using card groups with footers, their content will automatically line up.
2014-08-06 02:12:24 +02:00
2018-03-14 16:44:38 +01:00
{% capture example %}
2016-12-23 01:46:29 +01:00
<div class="card-group">
<div class="card">
{% include icons/placeholder.svg width="100%" height="180" class="card-img-top" text="Image cap" %}
<div class="card-body">
<h5 class="card-title">Card title</h5>
2016-12-23 01:46:29 +01:00
<p class="card-text">This is a wider card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.</p>
</div>
<div class="card-footer">
<small class="text-muted">Last updated 3 mins ago</small>
</div>
</div>
<div class="card">
{% include icons/placeholder.svg width="100%" height="180" class="card-img-top" text="Image cap" %}
<div class="card-body">
<h5 class="card-title">Card title</h5>
2016-12-23 01:46:29 +01:00
<p class="card-text">This card has supporting text below as a natural lead-in to additional content.</p>
</div>
<div class="card-footer">
<small class="text-muted">Last updated 3 mins ago</small>
</div>
</div>
<div class="card">
{% include icons/placeholder.svg width="100%" height="180" class="card-img-top" text="Image cap" %}
<div class="card-body">
<h5 class="card-title">Card title</h5>
2016-12-23 01:46:29 +01:00
<p class="card-text">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.</p>
</div>
<div class="card-footer">
<small class="text-muted">Last updated 3 mins ago</small>
</div>
</div>
</div>
2018-03-14 16:44:38 +01:00
{% endcapture %}
{% include example.html content=example %}
2016-12-23 01:47:10 +01:00
### Card decks
Need a set of equal width and height cards that aren't attached to one another? Use card decks.
2018-03-14 16:44:38 +01:00
{% capture example %}
2016-12-22 05:26:17 +01:00
<div class="card-deck">
<div class="card">
{% include icons/placeholder.svg width="100%" height="200" class="card-img-top" text="Image cap" %}
<div class="card-body">
<h5 class="card-title">Card title</h5>
2016-12-22 05:26:17 +01:00
<p class="card-text">This is a longer card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.</p>
<p class="card-text"><small class="text-muted">Last updated 3 mins ago</small></p>
2014-08-06 02:12:24 +02:00
</div>
2016-12-22 05:26:17 +01:00
</div>
<div class="card">
{% include icons/placeholder.svg width="100%" height="200" class="card-img-top" text="Image cap" %}
<div class="card-body">
<h5 class="card-title">Card title</h5>
2016-12-22 05:26:17 +01:00
<p class="card-text">This card has supporting text below as a natural lead-in to additional content.</p>
<p class="card-text"><small class="text-muted">Last updated 3 mins ago</small></p>
2014-08-06 02:12:24 +02:00
</div>
2016-12-22 05:26:17 +01:00
</div>
<div class="card">
{% include icons/placeholder.svg width="100%" height="200" class="card-img-top" text="Image cap" %}
<div class="card-body">
<h5 class="card-title">Card title</h5>
2016-12-22 05:26:17 +01:00
<p class="card-text">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.</p>
<p class="card-text"><small class="text-muted">Last updated 3 mins ago</small></p>
2014-08-06 02:12:24 +02:00
</div>
</div>
</div>
2018-03-14 16:44:38 +01:00
{% endcapture %}
{% include example.html content=example %}
2014-08-06 02:12:24 +02:00
2016-12-23 01:47:10 +01:00
Just like with card groups, card footers in decks will automatically line up.
2014-08-06 02:12:24 +02:00
2018-03-14 16:44:38 +01:00
{% capture example %}
2016-12-23 01:47:10 +01:00
<div class="card-deck">
<div class="card">
{% include icons/placeholder.svg width="100%" height="180" class="card-img-top" text="Image cap" %}
<div class="card-body">
<h5 class="card-title">Card title</h5>
2016-12-23 01:47:10 +01:00
<p class="card-text">This is a wider card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.</p>
</div>
<div class="card-footer">
<small class="text-muted">Last updated 3 mins ago</small>
</div>
</div>
<div class="card">
{% include icons/placeholder.svg width="100%" height="180" class="card-img-top" text="Image cap" %}
<div class="card-body">
<h5 class="card-title">Card title</h5>
2016-12-23 01:47:10 +01:00
<p class="card-text">This card has supporting text below as a natural lead-in to additional content.</p>
</div>
<div class="card-footer">
<small class="text-muted">Last updated 3 mins ago</small>
</div>
</div>
<div class="card">
{% include icons/placeholder.svg width="100%" height="180" class="card-img-top" text="Image cap" %}
<div class="card-body">
<h5 class="card-title">Card title</h5>
2016-12-23 01:47:10 +01:00
<p class="card-text">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.</p>
</div>
<div class="card-footer">
<small class="text-muted">Last updated 3 mins ago</small>
</div>
</div>
</div>
2018-03-14 16:44:38 +01:00
{% endcapture %}
{% include example.html content=example %}
### Grid cards
Use the Bootstrap grid system and its [`.row-cols` classes]({{ site.baseurl }}/docs/{{ site.docs_version }}/layout/grid/#row-columns) to control how many grid columns (wrapped around your cards) you show per row. For example, here's `.row-cols-1` laying out the cards on one column, and `.row-cols-md-2` splitting four cards to equal width across multiple rows, from the medium breakpoint up.
{% capture example %}
<div class="row row-cols-1 row-cols-md-2">
<div class="col mb-4">
<div class="card">
{% include icons/placeholder.svg width="100%" height="180" class="card-img-top" text="Image cap" %}
<div class="card-body">
<h5 class="card-title">Card title</h5>
<p class="card-text">This is a longer card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.</p>
</div>
</div>
</div>
<div class="col mb-4">
<div class="card">
{% include icons/placeholder.svg width="100%" height="180" class="card-img-top" text="Image cap" %}
<div class="card-body">
<h5 class="card-title">Card title</h5>
<p class="card-text">This is a longer card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.</p>
</div>
</div>
</div>
<div class="col mb-4">
<div class="card">
{% include icons/placeholder.svg width="100%" height="180" class="card-img-top" text="Image cap" %}
<div class="card-body">
<h5 class="card-title">Card title</h5>
<p class="card-text">This is a longer card with supporting text below as a natural lead-in to additional content.</p>
</div>
</div>
</div>
<div class="col mb-4">
<div class="card">
{% include icons/placeholder.svg width="100%" height="180" class="card-img-top" text="Image cap" %}
<div class="card-body">
<h5 class="card-title">Card title</h5>
<p class="card-text">This is a longer card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.</p>
</div>
</div>
</div>
</div>
{% endcapture %}
{% include example.html content=example %}
Change it to `.row-cols-3` and you'll see the fourth card wrap.
{% capture example %}
<div class="row row-cols-1 row-cols-md-3">
<div class="col mb-4">
<div class="card">
{% include icons/placeholder.svg width="100%" height="180" class="card-img-top" text="Image cap" %}
<div class="card-body">
<h5 class="card-title">Card title</h5>
<p class="card-text">This is a longer card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.</p>
</div>
</div>
</div>
<div class="col mb-4">
<div class="card">
{% include icons/placeholder.svg width="100%" height="180" class="card-img-top" text="Image cap" %}
<div class="card-body">
<h5 class="card-title">Card title</h5>
<p class="card-text">This is a longer card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.</p>
</div>
</div>
</div>
<div class="col mb-4">
<div class="card">
{% include icons/placeholder.svg width="100%" height="180" class="card-img-top" text="Image cap" %}
<div class="card-body">
<h5 class="card-title">Card title</h5>
<p class="card-text">This is a longer card with supporting text below as a natural lead-in to additional content.</p>
</div>
</div>
</div>
<div class="col mb-4">
<div class="card">
{% include icons/placeholder.svg width="100%" height="180" class="card-img-top" text="Image cap" %}
<div class="card-body">
<h5 class="card-title">Card title</h5>
<p class="card-text">This is a longer card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.</p>
</div>
</div>
</div>
</div>
{% endcapture %}
{% include example.html content=example %}
2019-10-03 09:21:40 +02:00
When you need equal height, add `.h-100` to the cards. If you want equal heights by default, you can set `$card-height: 100%` in Sass.
{% capture example %}
<div class="row row-cols-1 row-cols-md-3">
<div class="col mb-4">
<div class="card h-100">
{% include icons/placeholder.svg width="100%" height="180" class="card-img-top" text="Image cap" %}
<div class="card-body">
<h5 class="card-title">Card title</h5>
<p class="card-text">This is a longer card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.</p>
</div>
</div>
</div>
<div class="col mb-4">
<div class="card h-100">
{% include icons/placeholder.svg width="100%" height="180" class="card-img-top" text="Image cap" %}
<div class="card-body">
<h5 class="card-title">Card title</h5>
<p class="card-text">This is a short card.</p>
</div>
</div>
</div>
<div class="col mb-4">
<div class="card h-100">
{% include icons/placeholder.svg width="100%" height="180" class="card-img-top" text="Image cap" %}
<div class="card-body">
<h5 class="card-title">Card title</h5>
<p class="card-text">This is a longer card with supporting text below as a natural lead-in to additional content.</p>
</div>
</div>
</div>
<div class="col mb-4">
<div class="card h-100">
{% include icons/placeholder.svg width="100%" height="180" class="card-img-top" text="Image cap" %}
<div class="card-body">
<h5 class="card-title">Card title</h5>
<p class="card-text">This is a longer card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.</p>
</div>
</div>
</div>
</div>
{% endcapture %}
{% include example.html content=example %}
### Card columns
Cards can be organized into [Masonry](https://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.
2018-03-14 16:44:38 +01:00
{% capture example %}
2014-08-06 02:12:24 +02:00
<div class="card-columns">
<div class="card">
{% include icons/placeholder.svg width="100%" height="160" class="card-img-top" text="Image cap" %}
<div class="card-body">
<h5 class="card-title">Card title that wraps to a new line</h5>
<p class="card-text">This is a longer card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.</p>
</div>
2014-08-06 02:12:24 +02:00
</div>
<div class="card p-3">
2017-07-01 00:15:24 +02:00
<blockquote class="blockquote mb-0 card-body">
2014-08-06 02:12:24 +02:00
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.</p>
2017-07-01 00:15:24 +02:00
<footer class="blockquote-footer">
<small class="text-muted">
Someone famous in <cite title="Source Title">Source Title</cite>
</small>
</footer>
2014-08-06 02:12:24 +02:00
</blockquote>
</div>
<div class="card">
{% include icons/placeholder.svg width="100%" height="160" class="card-img-top" text="Image cap" %}
<div class="card-body">
<h5 class="card-title">Card title</h5>
<p class="card-text">This card has supporting text below as a natural lead-in to additional content.</p>
<p class="card-text"><small class="text-muted">Last updated 3 mins ago</small></p>
</div>
2014-08-06 02:12:24 +02:00
</div>
<div class="card bg-primary text-white text-center p-3">
2017-07-01 00:15:24 +02:00
<blockquote class="blockquote mb-0">
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat.</p>
<footer class="blockquote-footer text-white">
<small>
Someone famous in <cite title="Source Title">Source Title</cite>
</small>
</footer>
2014-08-06 02:12:24 +02:00
</blockquote>
</div>
<div class="card text-center">
<div class="card-body">
<h5 class="card-title">Card title</h5>
<p class="card-text">This card has a regular title and short paragraphy of text below it.</p>
<p class="card-text"><small class="text-muted">Last updated 3 mins ago</small></p>
</div>
2014-08-06 02:12:24 +02:00
</div>
<div class="card">
{% include icons/placeholder.svg width="100%" height="260" class="card-img" text="Card image" %}
</div>
<div class="card p-3 text-right">
2017-07-01 00:15:24 +02:00
<blockquote class="blockquote mb-0">
2014-08-06 02:12:24 +02:00
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.</p>
2017-07-01 00:15:24 +02:00
<footer class="blockquote-footer">
<small class="text-muted">
Someone famous in <cite title="Source Title">Source Title</cite>
</small>
</footer>
2014-08-06 02:12:24 +02:00
</blockquote>
</div>
<div class="card">
<div class="card-body">
<h5 class="card-title">Card title</h5>
<p class="card-text">This is another card with title and supporting text below. This card has some additional content to make it slightly taller overall.</p>
<p class="card-text"><small class="text-muted">Last updated 3 mins ago</small></p>
</div>
2014-08-06 02:12:24 +02:00
</div>
</div>
2018-03-14 16:44:38 +01:00
{% endcapture %}
{% include example.html content=example %}
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 %}