diff --git a/docs/patterns/card/index.md b/docs/patterns/card/index.md index c41cec6f66..2b15997747 100644 --- a/docs/patterns/card/index.md +++ b/docs/patterns/card/index.md @@ -11,39 +11,9 @@ tags: ## Overview @@ -58,40 +28,164 @@ it's near. Several cards can be used together to group related information. information on how to use the card element. {% endalert %} -## Alternative color scheme - - -

- Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam eleifend - elit sed est egestas, a - sollicitudin mauris tincidunt. Pellentesque vel dapibus risus. Nullam - aliquam felis orci, eget cursus mi - lacinia quis. Vivamus at felis sem. -

- - Call to action - -
- -## Title bar - - -

Card title

-

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla vitae elit - libero, a pharetra augue. Nullam id dolor id nibh ultricies vehicula ut id - elit. Donec id elit non mi porta gravida at eget metus.

- Footer -
- -## Image title bar - - - -

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla vitae elit - libero, a pharetra augue. Nullam id dolor id nibh ultricies vehicula ut id - elit. Donec id elit non mi porta gravida at eget metus.

- Footer -
+## Patterns + +
+ +
+ + ### Alternative color scheme + + + + + + Card's color scheme can be modified using the `--rh-color-surface-*` + Tokens. However, before modifying design tokens, first determine if one of + card's [existing color palettes](/elements/card/code/#attributes) should be used instead. + + {# + Read more about color palettes and themes in the + [getting started](/get-started/color/) section. + #} + + + Call to action + + + +
+ + ### Image title bar + + + + + +

Use to add an image to the basic style above the text. + Secondary and Default calls to action may be used.

+ + Footer + +
+ +
+ + ### List + Use to display a short amount of content using various list styles. + Secondary and Default calls to action may be used. + +
+ + ### Data + Use to display quick facts or short data points under a label. A Secondary + call to action may be used or not. + +
+ + ### Logo + Use to display a customer logo in a variety of arrangements. A call to + action is required, otherwise use a logo wall. + +
+ + ### Bar + + + + + {# #} + + + +

Card title

+ + Use to add a small icon and a label group to the header section. A larger + icon or a logo may be used. + + Alternative title bar styles can be achieved by selecting [card's `header` CSS + Shadow Part](/elements/card/code/#parts). + + + Footer + +
+ +
+ + ### Icon + Use to add an icon to the basic style above the text. Secondary and Default + calls to action may be used. + +
+ + ### Asset + Use to display that an asset can be downloaded. An icon and label group or + text may be used to describe the asset. + +
+ + ### Quote + Use to display a short quote with attribution text. Logos, images, and a + Secondary call to action may be used or not. + +
+ + ### Avatars + Use to highlight a group of people who engage in an event. A label should be + included, but including text is optional. + +
+ + ### Video + Use to trigger a video that will play in a [Modal dialog](/elements/dialog). + Different layout configurations may be used. + +
+ + ### Pricing + Use to outline the pricing and benefits of something. Elements may be + removed or rearranged depending on content needs. + +
+ + ### Logo slider + Use to display more content about a company when expanded on hover or tap. A + title and text should be included. + +
+ + ### Name slider + Use to display more content about a person when the tray expands. A title + and text should be included. + +
+
## Custom Theming @@ -105,7 +199,19 @@ Examples include: For more information, please see the [card css custom properties](/elements/card/code/#css-custom-properties). -### Custom Light Theme +
+ +
+ + ### Custom Light Theme + +

Card title

@@ -115,7 +221,17 @@ For more information, please see the [card css custom properties](/elements/card Footer
-### Custom Dark Theme +
+ + ### Custom Dark Theme + +

Card title

@@ -125,6 +241,9 @@ For more information, please see the [card css custom properties](/elements/card Footer
+
+
+ {% include 'feedback.html' %} diff --git a/elements/rh-card/docs/20-guidelines.md b/elements/rh-card/docs/20-guidelines.md index a49be97c4f..3d14e24a23 100644 --- a/elements/rh-card/docs/20-guidelines.md +++ b/elements/rh-card/docs/20-guidelines.md @@ -1,69 +1,13 @@ ## Usage -### Variants -There are several card variants that can be used for a variety of use cases. +Cards are used to display basic content or long paragraphs of text. Secondary and +Default calls to action may be used. {% alert %} - For examples of how to implement these patterns, see the [card patterns page](/patterns/card). + For examples of patterns which use or modify Card, + see the [card patterns page](/patterns/card). {% endalert %} -- #### Basic - Use to display basic content or long paragraphs of text. Secondary and - Default calls to action may be used. - -- #### List - Use to display a short amount of content using various list styles. - Secondary and Default calls to action may be used. - -- #### Data - Use to display quick facts or short data points under a label. A Secondary - call to action may be used or not. - -- #### Logo - Use to display a customer logo in a variety of arrangements. A call to - action is required, otherwise use a logo wall. - -- #### Bar - Use to add a small icon and a label group to the header section. A larger - icon or a logo may be used. - -- #### Icon - Use to add an icon to the basic style above the text. Secondary and Default - calls to action may be used. - -- #### Image - Use to add an image to the basic style above the text. Secondary and Default - calls to action may be used. - -- #### Asset - Use to display that an asset can be downloaded. An icon and label group or - text may be used to describe the asset. - -- #### Quote - Use to display a short quote with attribution text. Logos, images, and a - Secondary call to action may be used or not. - -- #### Avatars - Use to highlight a group of people who engage in an event. A label should be - included, but including text is optional. - -- #### Video - Use to trigger a video that will play in a [Modal dialog]({{ - '/elements/dialog' }}). Different layout configurations may be used. - -- #### Pricing - Use to outline the pricing and benefits of something. Elements may be - removed or rearranged depending on content needs. - -- #### Logo slider - Use to display more content about a company when expanded on hover or tap. A - title and text should be included. - -- #### Name slider - Use to display more content about a person when the tray expands. A title - and text should be included. - {.multi-column--min-400-wide style="padding:0;list-style-type:none;margin-block:var(--rh-space-2xl) var(--rh-space-4xl);"} - ### Content Cards have the potential to contain lots of content, like a combination of text, links, images, multimedia, etc. Ensure content serves the use case, but