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
Getting StartedDemoFormAdvancedFAQ
Vanilla Js Table of Contents Global Theme All system colors are controlled via the CSS color-scheme property and are included in our mandatory Global Styles. These styles also provide utility classes for selecting the active theme and a polyfill to ensure compatibility with browsers that do not yet support light-dark() (see browser support). By default, color tokens use the light theme. To enable the dark theme or automatic theme switching based on system settings, add the .scheme-light, .scheme-dark or .scheme-light-dark CSS class to the <html> element or any HTML element. This applies the selected theme to all child elements. Learn more in the Theme section. Prefixing You can load the Porsche Design System with a custom unique prefix to prevent conflicts. Just pass the prefix as a parameter to the load method.
<!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8" /> <meta name="viewport" content="width=device-width,initial-scale=1.0" /> <title>Porsche Design System</title> <script src="PATH/TO/PACKAGE/@porsche-design-system/components-js/index.js"></script> </head> <body> <script type="text/javascript"> porscheDesignSystem.load({ prefix: 'sample-prefix' }); </script> <sample-prefix-p-heading size="xx-large">Some heading</sample-prefix-p-heading> </body> </html>
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%