Skip to contentPorsche Design System
You are currently viewing an earlier release of the Porsche Design System.Switch to the latest Porsche Design System documentation.
SearchGitHub repository of Porsche Design SystemOpen settings sidebar
Table Table of Contents Table PropertiesPropertyAttributeDescriptionTypeDefaultcaption captionSets a screen-reader-only accessible caption that describes the table's content; it is not visible in the browser. Use an element with slot="caption" for a visible caption instead.stringundefinedcompact compactReduces the cell padding and spacing for a more condensed table layout in data-dense UIs.booleanfalselayout layoutControls the CSS table-layout algorithm: auto sizes columns to fit their content, fixed distributes width equally.type TableLayout =
'auto'
'fixed''auto'sticky 🧪stickyexperimental Makes the scroll position indicator sticky at the viewport edge while scrolling, indicating overflow in the table.booleanfalseEventsEventDescriptionTypeupdate Emitted when the user clicks a sortable column header, carrying the new sort configuration in the event detail.type TableUpdateEventDetail = {
  id: string;
  active?: boolean;
  direction?: Direction;
}
CustomEvent<TableUpdateEventDetail>SlotsSlotDescriptionisRequiredaltPropallowedTagNames<slot name="caption"> Shows a caption that describes the content of the table.<slot> Default slot for the table content.CSS VariablesCSS VariableDescriptiondefaultValue--p-table-scroll-indicator-top Defines the distance from the top of the viewport at which the scroll indicator sticks when scrolling down and `sticky` is enabled.0px--p-table-scroll-indicator-bottom Defines the distance from the bottom of the viewport at which the scroll indicator sticks when scrolling up and `sticky` is enabled.0px Table Head SlotsSlotDescriptionisRequiredaltPropallowedTagNames<slot> Default slot for the table head content. Table Head Row SlotsSlotDescriptionisRequiredaltPropallowedTagNames<slot> Default slot for the table head row content. Table Head Cell PropertiesPropertyAttributeDescriptionTypeDefaulthideLabel hide-labelHides the visible column label while keeping it accessible to screen readers. Only applies when sort is not set.booleanfalsemultiline multilineAllows the column header text to wrap onto multiple lines instead of being truncated to a single line.booleanfalsesort sortConfigures sorting behavior for this column by providing an id, active state, and current direction (asc or desc).type TableHeadCellSort = {
  'id'?: string;
  'active'?: boolean;
  'direction'?: ,asc,desc;
}undefinedSlotsSlotDescriptionisRequiredaltPropallowedTagNames<slot> Default slot for the table head cell content. Table Body SlotsSlotDescriptionisRequiredaltPropallowedTagNames<slot> Default slot for the table body content. Table Row SlotsSlotDescriptionisRequiredaltPropallowedTagNames<slot> Default slot for the table row content. Table Cell PropertiesPropertyAttributeDescriptionTypeDefaultmultiline multilineAllows slotted text to wrap onto multiple lines instead of being forced onto a single line.booleanfalseSlotsSlotDescriptionisRequiredaltPropallowedTagNames<slot> Default slot for the table cell content.
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%