Pluma

Theme

Overview

About

MCP server

CLI

Codemods

3.0.0

Button Variant Rename

2.170.0

Banner Description Prop

FormattedRelativeTime

tooltip-custom-interactive

no-banned-imports

enforce-pluma-elements

no-deprecated-apis

no-deprecated-icons

no-raw-pluma-classnames

no-raw-pluma-css-variables

require-form-control-label

prefer-managed-modals

Componentsv2.189.0

Iconsv1.19.0

MCPv0.8.61

Tokensv0.34.3

DescriptionList

Github

Storybook

Organize and explain a group of terms and their descriptions.

Importing

A description list consists of three components:

DescriptionList - wraps the description list (a dl tag)
DescriptionListTerm - the term (a dt tag)
DescriptionListDetails - the details (a dd tag)

The components can be imported via:

import { 
	DescriptionList, 
	DescriptionListTerm, 
	DescriptionListDetails 
} from '@customerio/pluma-components/react';

Usage

Use the DescriptionList component as the container, and place DescriptionListTerm components and their DescriptionListDetails components inside:

Loading editor

Layout

The list can also be rendered in a horizontal layout by setting the layout prop to "horizontal":

Loading editor

Additionally, the terms can be right aligned (only in the horizontal layout), with the termAlignment prop:

Loading editor

API

`PlumaDescriptionList` `extends Text`

`color` `"critical" | "caution" | "success" | "bold" | "accent" | "active" | "base" | "code" | "information" | "invert" | "minimal" | "placeholder" | "subtle" | "white" | "disabled" | "inherit" | undefined`

The text color. _{^{(See text color tokens)}}

`family` `"mono" | "sans" | undefined`

The font family. _{^{(See font family tokens)}}

`fontStyle` `"normal" | "italic" | undefined`

The font style. _{^{(See MDN font-style)}}

`layout` `"horizontal" | "vertical" | undefined`

Default:'vertical'

Whether the description list should render in a vertical or horizontal layout.

`size` `"m" | "l" | "s" | "button" | "xl" | "xs" | "xxl" | "xxs" | "xxxl" | undefined`

The text size. _{^{(See font size tokens)}}

`termAlignment` `"left" | "right" | undefined`

Default:'vertical'

Whether the terms (titles) should be left or right aligned when in a horizontal layout.

`text` `"product-code" | "product-h1" | "product-h2" | "product-h3" | "product-h4" | "product-label" | "product-label-secondary" | "product-link" | "product-link-secondary" | "product-p" | "product-p-active" | "product-p-secondary" | "product-ps" | "product-ps-active" | "product-pxs" | "product-pxs-active" | "product-pxs-secondary" | undefined`

A predefined typography style. _{^{(See text tokens)}}

`weight` `"bold" | "heavy" | "light" | "medium" | "regular" | "semibold" | undefined`

The font weight. _{^{(See font weight tokens)}}

`PlumaDescriptionListTerm` `extends Text`

`color` `"critical" | "caution" | "success" | "bold" | "accent" | "active" | "base" | "code" | "information" | "invert" | "minimal" | "placeholder" | "subtle" | "white" | "disabled" | "inherit" | undefined`

The text color. _{^{(See text color tokens)}}

`family` `"mono" | "sans" | undefined`

The font family. _{^{(See font family tokens)}}

`fontStyle` `"normal" | "italic" | undefined`

The font style. _{^{(See MDN font-style)}}

`size` `"m" | "l" | "s" | "button" | "xl" | "xs" | "xxl" | "xxs" | "xxxl" | undefined`

The text size. _{^{(See font size tokens)}}

`text` `"product-code" | "product-h1" | "product-h2" | "product-h3" | "product-h4" | "product-label" | "product-label-secondary" | "product-link" | "product-link-secondary" | "product-p" | "product-p-active" | "product-p-secondary" | "product-ps" | "product-ps-active" | "product-pxs" | "product-pxs-active" | "product-pxs-secondary" | undefined`

A predefined typography style. _{^{(See text tokens)}}

`weight` `"bold" | "heavy" | "light" | "medium" | "regular" | "semibold" | undefined`

The font weight. _{^{(See font weight tokens)}}

`PlumaDescriptionListDetails` `extends Text`

`color` `"critical" | "caution" | "success" | "bold" | "accent" | "active" | "base" | "code" | "information" | "invert" | "minimal" | "placeholder" | "subtle" | "white" | "disabled" | "inherit" | undefined`

The text color. _{^{(See text color tokens)}}

`family` `"mono" | "sans" | undefined`

The font family. _{^{(See font family tokens)}}

`fontStyle` `"normal" | "italic" | undefined`

The font style. _{^{(See MDN font-style)}}

`size` `"m" | "l" | "s" | "button" | "xl" | "xs" | "xxl" | "xxs" | "xxxl" | undefined`

The text size. _{^{(See font size tokens)}}

`text` `"product-code" | "product-h1" | "product-h2" | "product-h3" | "product-h4" | "product-label" | "product-label-secondary" | "product-link" | "product-link-secondary" | "product-p" | "product-p-active" | "product-p-secondary" | "product-ps" | "product-ps-active" | "product-pxs" | "product-pxs-active" | "product-pxs-secondary" | undefined`

A predefined typography style. _{^{(See text tokens)}}

`weight` `"bold" | "heavy" | "light" | "medium" | "regular" | "semibold" | undefined`

The font weight. _{^{(See font weight tokens)}}

DescriptionList

Importing

Usage

Layout

API

PlumaDescriptionList extends Text

color "critical" | "caution" | "success" | "bold" | "accent" | "active" | "base" | "code" | "information" | "invert" | "minimal" | "placeholder" | "subtle" | "white" | "disabled" | "inherit" | undefined

family "mono" | "sans" | undefined

fontStyle "normal" | "italic" | undefined

layout "horizontal" | "vertical" | undefined

size "m" | "l" | "s" | "button" | "xl" | "xs" | "xxl" | "xxs" | "xxxl" | undefined

termAlignment "left" | "right" | undefined

weight "bold" | "heavy" | "light" | "medium" | "regular" | "semibold" | undefined

PlumaDescriptionListTerm extends Text

color "critical" | "caution" | "success" | "bold" | "accent" | "active" | "base" | "code" | "information" | "invert" | "minimal" | "placeholder" | "subtle" | "white" | "disabled" | "inherit" | undefined

family "mono" | "sans" | undefined

fontStyle "normal" | "italic" | undefined

size "m" | "l" | "s" | "button" | "xl" | "xs" | "xxl" | "xxs" | "xxxl" | undefined

weight "bold" | "heavy" | "light" | "medium" | "regular" | "semibold" | undefined

PlumaDescriptionListDetails extends Text

color "critical" | "caution" | "success" | "bold" | "accent" | "active" | "base" | "code" | "information" | "invert" | "minimal" | "placeholder" | "subtle" | "white" | "disabled" | "inherit" | undefined

family "mono" | "sans" | undefined

fontStyle "normal" | "italic" | undefined

size "m" | "l" | "s" | "button" | "xl" | "xs" | "xxl" | "xxs" | "xxxl" | undefined

weight "bold" | "heavy" | "light" | "medium" | "regular" | "semibold" | undefined

On this page

`PlumaDescriptionList` `extends Text`

`color` `"critical" | "caution" | "success" | "bold" | "accent" | "active" | "base" | "code" | "information" | "invert" | "minimal" | "placeholder" | "subtle" | "white" | "disabled" | "inherit" | undefined`

`family` `"mono" | "sans" | undefined`

`fontStyle` `"normal" | "italic" | undefined`

`layout` `"horizontal" | "vertical" | undefined`

`size` `"m" | "l" | "s" | "button" | "xl" | "xs" | "xxl" | "xxs" | "xxxl" | undefined`

`termAlignment` `"left" | "right" | undefined`

`weight` `"bold" | "heavy" | "light" | "medium" | "regular" | "semibold" | undefined`

`PlumaDescriptionListTerm` `extends Text`

`color` `"critical" | "caution" | "success" | "bold" | "accent" | "active" | "base" | "code" | "information" | "invert" | "minimal" | "placeholder" | "subtle" | "white" | "disabled" | "inherit" | undefined`

`family` `"mono" | "sans" | undefined`

`fontStyle` `"normal" | "italic" | undefined`

`size` `"m" | "l" | "s" | "button" | "xl" | "xs" | "xxl" | "xxs" | "xxxl" | undefined`

`weight` `"bold" | "heavy" | "light" | "medium" | "regular" | "semibold" | undefined`

`PlumaDescriptionListDetails` `extends Text`

`color` `"critical" | "caution" | "success" | "bold" | "accent" | "active" | "base" | "code" | "information" | "invert" | "minimal" | "placeholder" | "subtle" | "white" | "disabled" | "inherit" | undefined`

`family` `"mono" | "sans" | undefined`

`fontStyle` `"normal" | "italic" | undefined`

`size` `"m" | "l" | "s" | "button" | "xl" | "xs" | "xxl" | "xxs" | "xxxl" | undefined`

`weight` `"bold" | "heavy" | "light" | "medium" | "regular" | "semibold" | undefined`