Skip to content

Latest commit

 

History

History
760 lines (654 loc) · 28.8 KB

card.md

File metadata and controls

760 lines (654 loc) · 28.8 KB
layout title description group aliases toc bootstrap other_frameworks
docs
Card
Bootstrap card component provides a flexible and extensible container for displaying content. Bootstrap card is delivered with a bunch of variants and options.
components
/4.0/components/card/
/4.1/components/card/
/components/cards/
/components/bootstrap/card/
true
true
card

About

A Bootstrap card component is a content container. It incorporates options for images, headers, and footers, a wide variety of content, contextual background colors, and excellent display options. Bootstrap cards replace old Bootstrap panels, Bootstrap wells, and Bootstrap thumbnails.

Example

Cards are built with as little markup and styles as possible but still manage to deliver a bunch of control and customization. Built with flexbox, they offer easy alignment and mix well with other Bootstrap components. Cards have no top, left, and right margins by default, so use [spacing utilities]({{< docsref "/utilities/spacing" >}}) as needed. They have no fixed width to start, so they'll fill the full width of its parent.

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.

{{< example >}}

{{< placeholder width="100%" height="180" class="card-img-top" text="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
{{< /example >}}

Content types

Bootstrap card supports a wide variety of content, including images, text, list groups, links, and more. Below are examples of those elements.

Body

The main block of a card is the .card-body. Use it whenever you need a padded section within a card.

{{< example >}}

This is some text within a card body.
{{< /example >}}

Titles, text, and links

Card titles are managed by adding .card-title to a <h*> tag. Identically, links are attached and collected next to each other by adding .card-link to an <a> tag.

Subtitles are managed by adding a .card-subtitle to a <h*> tag. If the .card-title also, the .card-subtitle items are stored in a .card-body item, the card title, and subtitle are arranged rightly.

{{< example >}}

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
{{< /example >}}

Images

.card-img-top and .card-img-bottom respectively set the top and bottom corners rounded to match the card's borders. Text within .card-text can additionally be styled with the regular HTML tags.

{{< example >}}

{{< placeholder width="100%" height="180" class="card-img-top" text="Image cap" >}}

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

{{< /example >}}

List groups

Create lists of content in a card with a flush list group.

{{< example >}}

  • An item
  • A second item
  • A third item
{{< /example >}}

{{< example >}}

Featured
  • An item
  • A second item
  • A third item
{{< /example >}}

{{< example >}}

  • An item
  • A second item
  • A third item
Card footer
{{< /example >}}

Kitchen sink

Combine and match many content types to build 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 >}}

{{< placeholder width="100%" height="180" class="card-img-top" text="Image cap" >}}
Card title

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

  • An item
  • A second item
  • A third item
{{< /example >}}

Header and footer

Add an optional header and/or footer within a card.

{{< example >}}

Featured
Special title treatment

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

Go somewhere
{{< /example >}}

Card headers can be styled by adding .card-header to <h*> elements.

{{< example >}}

Featured
Special title treatment

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

Go somewhere
{{< /example >}}

{{< example >}}

Quote

A well-known quote, contained in a blockquote element.

Someone famous in Source Title
{{< /example >}}

{{< example >}}

Featured
Special title treatment

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

Go somewhere
2 days ago
{{< /example >}}

Sizing

Cards assume no specific width to start, so they'll be 100% wide unless otherwise stated. You can adjust this as required with custom CSS, grid classes, grid Sass mixins, or services.

Using grid markup

Using the grid, wrap cards in columns and rows as needed.

{{< example >}}

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
{{< /example >}}

Using utilities

Use some of [available sizing utilities]({{< docsref "/utilities/sizing" >}}) to rapidly set a card's width.

{{< example >}}

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
{{< /example >}}

Using custom CSS

Use custom CSS in your stylesheets or as inline styles to set a width.

{{< example >}}

Special title treatment

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

Go somewhere
{{< /example >}}

Text alignment

You can instantly change the text arrangement of any card—in its whole or specific parts—with [text align classes]({{< docsref "/utilities/text#text-alignment" >}}).

{{< example >}}

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
{{< /example >}}

Navigation

Add some navigation to a card's header (or block) with CoreUI for Bootstrap's [nav components]({{< docsref "/components/navs-tabs" >}}).

{{< example >}}

Special title treatment

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

Go somewhere
{{< /example >}}

{{< example >}}

Special title treatment

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

Go somewhere
{{< /example >}}

Images

Cards introduce several options for acting with images. Pick from appending "image caps" at either end of a card, overlaying images with content, or just inserting 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 >}}

{{< placeholder width="100%" height="180" class="card-img-top" text="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

{{< placeholder width="100%" height="180" class="card-img-bottom" text="Image cap" >}}
{{< /example >}}

Image overlays

Adapt an image into a background and overlay your text. Depending on the image, you may need additional styles or utilities.

{{< example >}}

{{< placeholder width="100%" height="270" class="docs-placeholder-img-lg card-img" text="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

{{< /example >}}

{{< callout info >}} 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. {{< /callout >}}

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 .g-0 and use .col-md-* classes to make the card horizontal at the md breakpoint. Further adjustments may be needed depending on your card content.

{{< example >}}

{{< placeholder width="100%" height="250" text="Image" class="img-fluid rounded-start" >}}
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

{{< /example >}}

Card styles

Cards include various options for customizing their backgrounds, borders, and color.

Background and color

{{< added-in "4.2.6" >}}

Set a background-color with contrasting foreground color with [our .text-bg-{color} helpers]({{< docsref "helpers/color-background" >}}). Previously it was required to manually pair your choice of [.text-{color}]({{< docsref "/utilities/colors" >}}) and [.bg-{color}]({{< docsref "/utilities/background" >}}) utilities for styling, which you still may use if you prefer.

{{< example >}} {{< card.inline >}} {{- range (index $.Site.Data "theme-colors") }}

Header
{{ .name | title }} card title

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

{{- end -}} {{< /card.inline >}} {{< /example >}}

{{< callout info >}} {{< partial "callouts/warning-color-assistive-technologies.md" >}} {{< /callout >}}

Border

Use [border utilities]({{< docsref "/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.

{{< example >}} {{< card.inline >}} {{- range (index $.Site.Data "theme-colors") }}

Header
{{ .name | title }} card title

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

{{- end -}} {{< /card.inline >}} {{< /example >}}

Top border

Use [border utilities]({{< docsref "/utilities/borders" >}}) to change just the border-top-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.

{{< example >}} {{< card.inline >}} {{- range (index $.Site.Data "theme-colors") }}

Header
{{ .name | title }} card title

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

{{- end -}} {{< /card.inline >}} {{< /example >}}

Mixins utilities

You are able to adjust the borders on the card elements as needed, and even exclude their background-color with .bg-transparent.

{{< example >}}

Header
Success card title

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

Footer
{{< /example >}}

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 start off stacked and use display: flex; to become attached with uniform dimensions starting at the sm breakpoint.

{{< example >}}

{{< placeholder width="100%" height="180" class="card-img-top" text="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

{{< placeholder width="100%" height="180" class="card-img-top" text="Image cap" >}}
Card title

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

Last updated 3 mins ago

{{< placeholder width="100%" height="180" class="card-img-top" text="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

{{< /example >}}

When using card groups with footers, their content will automatically line up.

{{< example >}}

{{< placeholder width="100%" height="180" class="card-img-top" text="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
{{< placeholder width="100%" height="180" class="card-img-top" text="Image cap" >}}
Card title

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

Last updated 3 mins ago
{{< placeholder width="100%" height="180" class="card-img-top" text="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
{{< /example >}}

Grid cards

Use the Bootstrap grid system and its [.row-cols classes]({{< docsref "/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.

{{< example >}}

{{< placeholder width="100%" height="140" class="card-img-top" text="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.

{{< placeholder width="100%" height="140" class="card-img-top" text="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.

{{< placeholder width="100%" height="140" class="card-img-top" text="Image cap" >}}
Card title

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

{{< placeholder width="100%" height="140" class="card-img-top" text="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.

{{< /example >}}

Change it to .row-cols-3 and you'll see the fourth card wrap.

{{< example >}}

{{< placeholder width="100%" height="140" class="card-img-top" text="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.

{{< placeholder width="100%" height="140" class="card-img-top" text="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.

{{< placeholder width="100%" height="140" class="card-img-top" text="Image cap" >}}
Card title

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

{{< placeholder width="100%" height="140" class="card-img-top" text="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.

{{< /example >}}

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.

{{< example >}}

{{< placeholder width="100%" height="140" class="card-img-top" text="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.

{{< placeholder width="100%" height="140" class="card-img-top" text="Image cap" >}}
Card title

This is a short card.

{{< placeholder width="100%" height="140" class="card-img-top" text="Image cap" >}}
Card title

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

{{< placeholder width="100%" height="140" class="card-img-top" text="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.

{{< /example >}}

Just like with card groups, card footers will automatically line up.

{{< example >}}

{{< placeholder width="100%" height="180" class="card-img-top" text="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
{{< placeholder width="100%" height="180" class="card-img-top" text="Image cap" >}}
Card title

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

Last updated 3 mins ago
{{< placeholder width="100%" height="180" class="card-img-top" text="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
{{< /example >}}

Customizing

CSS variables

Cards use local CSS variables on .card for enhanced real-time customization. Values for the CSS variables are set via Sass, so Sass customization is still supported, too.

{{< scss-docs name="card-css-vars" file="scss/_card.scss" >}}

SASS variables

{{< scss-docs name="card-variables" file="scss/_variables.scss" >}}