Expandable section

An expandable section is a content section with a text toggle that reveals content that is hidden by default.

Examples

Hidden

Expanded

This content is visible only when the component is expanded.

Indented

This content is visible only when the component is expanded.

Disclosure variation (hidden)

Disclosure variation (expanded)

This content is visible only when the component is expanded.

Disclosure variation (indented)

This content is visible only when the component is expanded.

Detached

This content is visible only when the component is expanded.

Truncate expansion (hidden)

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus finibus, diam vitae eleifend consequat, metus sapien posuere quam, ut tincidunt nunc enim eget sapien. Mauris ac dui imperdiet dolor dignissim efficitur laoreet quis erat. Proin turpis leo, malesuada eget urna et, tristique mollis odio. Ut mattis nulla lorem, elementum hendrerit nunc molestie vitae. Proin massa sem, bibendum id urna in, viverra porta neque. Ut ut mi ac lacus rhoncus mollis id quis sem. Suspendisse non justo elementum, dictum eros nec, hendrerit sapien. Mauris aliquet, est sit amet tincidunt vehicula, purus est hendrerit arcu, vitae egestas odio lorem ut lacus. In et neque non metus viverra rhoncus quis non purus. Integer id venenatis tortor. Nulla sollicitudin convallis tellus, at porta eros volutpat in. Curabitur rhoncus rhoncus nisi, sit amet tincidunt dolor efficitur vitae. Integer purus neque, porta non odio lobortis, accumsan elementum risus. Pellentesque viverra id lacus a cursus. Etiam eu pulvinar risus. Etiam ultrices nec urna id consequat.

Truncate expansion (expanded)

Documentation

Accessibility

Attribute	Applied to	Outcome
`aria-expanded="true"`	`.pf-v6-c-expandable-section__toggle .pf-v6-c-button`	Indicates that the expandable section content is visible. Required
`aria-expanded="false"`	`.pf-v6-c-expandable-section__toggle .pf-v6-c-button`	Indicates the the expandable section content is hidden. Required
`hidden`	`.pf-v6-c-expandable-section__content`	Indicates that the expandable section content element is hidden. Use with `aria-expanded="false"` Required
`aria-hidden="true"`	`.pf-v6-c-expandable-section__toggle-icon`	Hides the icon from screen readers. Required
`aria-controls="[id of content element]"`	`.pf-v6-c-expandable-section.pf-m-detached .pf-v6-c-expandable-section__toggle .pf-v6-c-button`	Identifies the element controlled by the toggle button. Required
`id`	`.pf-v6-c-expandable-section.pf-m-detached .pf-v6-c-expandable-section__content`	Gives the content an `id` for use with `aria-controls` on `.pf-v6-c-expandable-section__toggle .pf-v6-c-button`. Required

Usage

Class	Applied to	Outcome
`.pf-v6-c-expandable-section`	`<div>`	Initiates the expandable section component. Required
`.pf-v6-c-expandable-section__toggle`	`<div>`	Initiates the expandable toggle wrapper. Required
`.pf-v6-c-expandable-section__toggle-icon`	`<span>`	Initiates the expandable toggle icon. Required
`.pf-v6-c-expandable-section__content`	`<div>`	Initiates the expandable section content. Required
`.pf-m-expanded`	`.pf-v6-c-expandable-section`	Modifies the component for the expanded state.
`.pf-m-display-lg`	`.pf-v6-c-expandable-section`	Modifies the styling of the component to have large display styling.
`.pf-m-indented`	`.pf-v6-c-expandable-section`	Indicates that the expandable section content is indented and is aligned with the start of the title text to provide visual hierarchy.
`.pf-m-truncate`	`.pf-v6-c-expandable-section`	Indicates that the expandable section content is truncated by default, and not truncated when expanded.
`.pf-m-expand-top`	`.pf-v6-c-expandable-section__toggle-icon`	Modifies the toggle icon to point up when expanded.
`--pf-v6-c-expandable-section--m-truncate__content--LineClamp`	`.pf-v6-c-expandable-section.pf-m-truncate`	Modifies the number of lines to show before truncating.

CSS variables

Expand or collapse column	Selector	Variable	Value
	.pf-v6-c-expandable-section	--pf-v6-c-expandable-section--Gap	0.5rem
--pf-v6-c-expandable-section--Gap --pf-t--global--spacer--sm --pf-t--global--spacer--200 0.5rem
	.pf-v6-c-expandable-section	--pf-v6-c-expandable-section__toggle-icon--MinWidth	1em
	.pf-v6-c-expandable-section	--pf-v6-c-expandable-section__toggle-icon--Color	(In light theme) #1f1f1f
--pf-v6-c-expandable-section__toggle-icon--Color --pf-t--global--icon--color--regular --pf-t--global--icon--color--100 --pf-t--color--gray--90 #1f1f1f
	.pf-v6-c-expandable-section	--pf-v6-c-expandable-section__toggle-icon--Transition	.2s ease-in 0s
	.pf-v6-c-expandable-section	--pf-v6-c-expandable-section__toggle-icon--Rotate	0
	.pf-v6-c-expandable-section	--pf-v6-c-expandable-section__toggle-icon--m-expand-top--Rotate	0
	.pf-v6-c-expandable-section	--pf-v6-c-expandable-section--m-expanded__toggle-icon--Rotate	90deg
	.pf-v6-c-expandable-section	--pf-v6-c-expandable-section--m-expanded__toggle-icon--m-expand-top--Rotate	-90deg
	.pf-v6-c-expandable-section	--pf-v6-c-expandable-section__content--MaxWidth	auto
	.pf-v6-c-expandable-section	--pf-v6-c-expandable-section--m-limit-width__content--MaxWidth	46.875rem
	.pf-v6-c-expandable-section	--pf-v6-c-expandable-section--m-display-lg--PaddingBlockStart	0.5rem
--pf-v6-c-expandable-section--m-display-lg--PaddingBlockStart --pf-t--global--spacer--sm --pf-t--global--spacer--200 0.5rem
	.pf-v6-c-expandable-section	--pf-v6-c-expandable-section--m-display-lg--PaddingBlockEnd	0.5rem
--pf-v6-c-expandable-section--m-display-lg--PaddingBlockEnd --pf-t--global--spacer--sm --pf-t--global--spacer--200 0.5rem
	.pf-v6-c-expandable-section	--pf-v6-c-expandable-section--m-display-lg--PaddingInlineStart	1rem
--pf-v6-c-expandable-section--m-display-lg--PaddingInlineStart --pf-t--global--spacer--md --pf-t--global--spacer--300 1rem
	.pf-v6-c-expandable-section	--pf-v6-c-expandable-section--m-display-lg--PaddingInlineEnd	1rem
--pf-v6-c-expandable-section--m-display-lg--PaddingInlineEnd --pf-t--global--spacer--md --pf-t--global--spacer--300 1rem
	.pf-v6-c-expandable-section	--pf-v6-c-expandable-section--m-display-lg--m-expanded--PaddingBlockEnd	1rem
--pf-v6-c-expandable-section--m-display-lg--m-expanded--PaddingBlockEnd --pf-t--global--spacer--md --pf-t--global--spacer--300 1rem
	.pf-v6-c-expandable-section	--pf-v6-c-expandable-section--m-display-lg--BackgroundColor	(In light theme) #f2f2f2
--pf-v6-c-expandable-section--m-display-lg--BackgroundColor --pf-t--global--background--color--secondary--default --pf-t--global--background--color--200 --pf-t--color--gray--10 #f2f2f2
	.pf-v6-c-expandable-section	--pf-v6-c-expandable-section--m-display-lg--BorderWidth	1px
--pf-v6-c-expandable-section--m-display-lg--BorderWidth --pf-t--global--border--width--box--default --pf-t--global--border--width--100 1px
	.pf-v6-c-expandable-section	--pf-v6-c-expandable-section--m-display-lg--BorderColor	(In light theme) #c7c7c7
--pf-v6-c-expandable-section--m-display-lg--BorderColor --pf-t--global--border--color--default --pf-t--global--border--color--100 --pf-t--color--gray--30 #c7c7c7
	.pf-v6-c-expandable-section	--pf-v6-c-expandable-section--m-display-lg--BorderRadius	16px
--pf-v6-c-expandable-section--m-display-lg--BorderRadius --pf-t--global--border--radius--medium --pf-t--global--border--radius--300 16px
	.pf-v6-c-expandable-section	--pf-v6-c-expandable-section--m-indented__content--PaddingInlineStart	calc(0.5rem + 0.5rem + 1em)
--pf-v6-c-expandable-section--m-indented__content--PaddingInlineStart calc(--pf-t--global--spacer--action--horizontal--plain--default + --pf-t--global--spacer--gap--text-to-element--default + --pf-v6-c-expandable-section__toggle-icon--MinWidth) calc(--pf-t--global--spacer--sm + --pf-t--global--spacer--sm + 1em) calc(--pf-t--global--spacer--200 + --pf-t--global--spacer--200 + 1em) calc(0.5rem + 0.5rem + 1em)
	.pf-v6-c-expandable-section	--pf-v6-c-expandable-section--m-truncate__content--LineClamp	3
	.pf-v6-c-expandable-section	--pf-v6-c-expandable-section--m-truncate--Gap	0.25rem
--pf-v6-c-expandable-section--m-truncate--Gap --pf-t--global--spacer--xs --pf-t--global--spacer--100 0.25rem
	.pf-v6-c-expandable-section.pf-m-expanded	--pf-v6-c-expandable-section__toggle-icon--Rotate	90deg
--pf-v6-c-expandable-section__toggle-icon--Rotate --pf-v6-c-expandable-section--m-expanded__toggle-icon--Rotate 90deg
	.pf-v6-c-expandable-section.pf-m-expanded	--pf-v6-c-expandable-section__toggle-icon--m-expand-top--Rotate	-90deg
--pf-v6-c-expandable-section__toggle-icon--m-expand-top--Rotate --pf-v6-c-expandable-section--m-expanded__toggle-icon--m-expand-top--Rotate -90deg
	.pf-v6-c-expandable-section.pf-m-expanded	--pf-v6-c-expandable-section--m-display-lg--PaddingBlockEnd	1rem
--pf-v6-c-expandable-section--m-display-lg--PaddingBlockEnd --pf-v6-c-expandable-section--m-display-lg--m-expanded--PaddingBlockEnd --pf-t--global--spacer--md --pf-t--global--spacer--300 1rem
	.pf-v6-c-expandable-section.pf-m-limit-width	--pf-v6-c-expandable-section__content--MaxWidth	46.875rem
--pf-v6-c-expandable-section__content--MaxWidth --pf-v6-c-expandable-section--m-limit-width__content--MaxWidth 46.875rem
	.pf-v6-c-expandable-section.pf-m-indented	--pf-v6-c-expandable-section__content--PaddingInlineStart	calc(0.5rem + 0.5rem + 1em)
--pf-v6-c-expandable-section__content--PaddingInlineStart --pf-v6-c-expandable-section--m-indented__content--PaddingInlineStart calc(--pf-t--global--spacer--action--horizontal--plain--default + --pf-t--global--spacer--gap--text-to-element--default + --pf-v6-c-expandable-section__toggle-icon--MinWidth) calc(--pf-t--global--spacer--sm + --pf-t--global--spacer--sm + 1em) calc(--pf-t--global--spacer--200 + --pf-t--global--spacer--200 + 1em) calc(0.5rem + 0.5rem + 1em)
	.pf-v6-c-expandable-section.pf-m-truncate	--pf-v6-c-expandable-section--Gap	0.25rem
--pf-v6-c-expandable-section--Gap --pf-v6-c-expandable-section--m-truncate--Gap --pf-t--global--spacer--xs --pf-t--global--spacer--100 0.25rem
	.pf-v6-c-expandable-section__toggle-icon.pf-m-expand-top	--pf-v6-c-expandable-section__toggle-icon--Rotate	0
--pf-v6-c-expandable-section__toggle-icon--Rotate --pf-v6-c-expandable-section__toggle-icon--m-expand-top--Rotate 0

View source on GitHub