Porsche Design SystemSearchNavigate to GitHub repository of Porsche Design SystemOpen sidebar
Getting StartedDemoFormFAQ
React Router Table of Contents Porsche Design System form components can be integrated into React Router using different techniques based on your state management and form handling preferences. Each component automatically keeps its internal value in sync, similar to native form elements. All form components support: Manual State Management (Props + Events) using value/checked properties and change/input/blur event listeners Native form submission using form-associated custom elements Form Integration Demo A complete example of how to integrate form components with React Router can be explored here: Manual State Management (Preferred) While all custom form components update their internal state automatically, you can manage their values externally using the value or checked props along with input, change, and blur events. This approach allows flexible integration with any form library.
const [value, setValue] = useState<PInputTextProps['value']>(''); const onInput = (e: CustomEvent<InputTextInputEventDetail>) => { setValue(e.target.value); }; ... <PInputText name="myInputText" label="Some Label" value={value} onInput={onInput} />
Native Form Submission All custom form components are form-associated custom elements that integrate seamlessly with forms. Leveraging the ElementInternals API, They will work like their native counterparts, ensuring compatibility with form behaviors.
const onSubmit = (e: FormEvent<HTMLFormElement>) => { console.log(e); }; ... <form onSubmit={onSubmit}> <PInputText name="myInputText" label="Some Label"></PInputText> <PButton type="submit">Submit</PButton> </form>
Global settingsThemeChanges the theme of the application and any Porsche Design System component. It's possible to choose between forced theme light and dark. It's also possible to use auto, which applies light or dark theme depending on the operating system settings automatically.LightDarkAuto (sync with operating system)DirectionThe 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%