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
Banner Table of Contents Accessibility support Keyboard Key / stateFunctionESCCloses the Banner.Tab, Shift-TabMoves focus to the next focusable element.focusMoves focus automatically to the close button. ARIA enhancements Internal ARIA that is managed by the component: ARIAUsagerole="status"When content is populated or changed in state="info", the component announces it unobtrusively.role="alert"When content is populated or changed in state="warning/error", the component announces it immediately.aria-label="STRING"References the accessible name. Development considerations Focus handling To support keyboard navigation, please take care of correct focus handling after closing the Banner with ESC or Enter key: The trigger element (e.g. a button) which has opened the Banner must receive focus state again after the Banner is closed. This is important to keep focus order consistent. ARIA live announcements The Banner component uses role="status" and role="alert" to announce content changes for assistive technologies, but only if the component is pre-rendered and the content is added dynamically. Common do's and don'ts Do pre-render the banner in the DOM and update its content when showing feedback. Do provide meaningful heading and description text for warnings and errors. Do return focus to the trigger or at a logical place after the banner is dismissed. Don't mount the entire banner only at the moment it should be announced. Integration examples
Banner mounted only when shown❌ Anti-pattern
// Banner is created only when an error occurs — live region may not announce.
if (hasError) {
  document.body.insertAdjacentHTML('beforeend', '<p-banner open heading="Error">Something went wrong.</p-banner>');
}
✅ Recommended
<!-- Pre-render the banner and update content when needed. -->

<p-banner id="form-banner" heading="Error" description="Check the highlighted fields and try again." state="error"></p-banner>
Error feedback without descriptive content❌ Anti-pattern
<p-banner open="true" state="error" description="Error"></p-banner>
✅ Recommended
<p-banner open="true" state="error" heading="Payment could not be processed" description="Check your card details or try another payment method."></p-banner>
Tests Automated TechnologySupportAXE-Core (WCAG 2.2 AA, Best-Practice)✅High-Contrast Mode (light/dark)✅Text-Zoom (200%)✅ Manual TechnologySupportKeyboard✅Screen reader (VoiceOver, NVDA)✅
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%