Porsche Design System
You are currently viewing an earlier release of the Porsche Design System.Switch to the latest Porsche Design System documentation.
SearchNavigate to GitHub repository of Porsche Design SystemOpen sidebar
ConfiguratorExamplesUsageAccessibilityAPI
Accordion Table of ContentsPropertiestype BreakpointCustomizable<T> = { base: T; xs?: T; s?: T; m?: T; l?: T; xl?: T; xxl?: T; };PropertyAttributeDescriptionTypeDefaultalignMarker align-markerAligns the marker within the summary section.type AccordionAlignMarker =
'start'
'end'
'end'
background backgroundDefines the background color. Use frosted only on images, videos or gradients.type AccordionBackground =
'canvas'
'surface'
'frosted'
'none'
'none'
compact compactDisplays the accordion in compact mode.booleanundefinedheading 🚫headingdeprecated Will be removed in the next major release. Use the summary slot instead. Sets the heading text within the summary section.stringundefinedheadingTag 🚫heading-tagdeprecated Will be removed in the next major release. Use the summary slot instead. Sets the heading tag for proper semantic structure within the page.type AccordionHeadingTag =
'h1'
'h2'
'h3'
'h4'
'h5'
'h6'
'h2'
open openControls whether the accordion is open or closed.booleanundefinedsize 🚫🛠sizedeprecated Will be removed in the next major release. Use the summary slot instead. Controls the heading size in the summary section (only applies when using the heading prop or heading slot).type AccordionSize =
'small'
'medium'
BreakpointCustomizable<AccordionSize>
'small'
sticky 🧪stickyexperimental Makes the summary section sticky at the top while scrolling. Only works with background="canvas" or background="surface". Not compatible with summary-before or summary-after slots.booleanundefined
EventsEventDescriptionTypeupdate Emitted when the accordion state changes.type AccordionUpdateEventDetail = {
  open: boolean;
}
CustomEvent<AccordionUpdateEventDetail>
SlotsSlotDescriptionisRequiredaltPropallowedTagNames<slot name="summary"> Content for the accordion's summary section. Clicking toggles the accordion open and closed.<slot name="summary-before"> Content or interactive elements placed before the accordion's summary section.<slot name="summary-after"> Content or interactive elements placed after the accordion's summary section.<slot name="heading"> 🚫Content for the accordion's heading section. Clicking toggles the accordion open and closed.<slot> Main content displayed when the accordion is expanded.CSS VariablesCSS VariableDescriptiondefaultValue--p-accordion-summary-top Controls the sticky top position when `sticky` is enabled.0px--p-accordion-px Horizontal padding of the accordion.16px--p-accordion-py Vertical padding of the accordion.16px
Global settingsColor SchemeAll color tokens use the light-dark() CSS function. Set the theme via the CSS color-scheme property: light for light mode, dark for dark mode, or light dark to follow the user's system preference.LightDarkLight DarkDirectionThe dir global attribute in HTML changes the direction of text and other content within an element. It's most often used on the <html> tag to set the entire page's direction, which is crucial for supporting languages that are written from right to left (RTL), such as Arabic and Hebrew. For example, using <html dir="rtl"> makes the entire page display from right to left, adjusting the layout and text flow accordingly.LTR (left-to-right)RTL (right-to-left)Text ZoomTo ensure accessibility and comply with WCAG 2.2 AA standards, it is mandatory for web content to support text resizing up to at least 200% without loss of content or functionality. Using relative units like rem is a best practice for achieving this, as they allow the text to scale uniformly based on the user's browser settings.100%130%150%200%