A page-level, full-width announcement bar — distinct from `<al-alert>` (which is a card-surfaced, contextual message).
PLAYGROUND2 CONTROLS
PREVIEW / al-banner / SOUTHLEFT
Loading preview
We're rolling out a new theming engine this week — some screens may look slightly different.
Learn more
FLAGS
CODE — HTML / REACT
Guidance
NOT YET AUTHORED · 20 COMPONENTS COVERED
NO USAGE GUIDANCE HAS BEEN WRITTEN FOR THIS COMPONENT YET. THE API BELOW IS GENERATED FROM THE MANIFEST AND IS COMPLETE; WHAT IS MISSING IS WHEN TO REACH FOR IT AND WHEN NOT TO.
FIGMA PARITYNOT TRACKED
NO DESIGN-SYSTEM PROJECT TRACKS THIS COMPONENT AGAINST A FIGMA FILE — IT IS EITHER OUTSIDE EVERY PROJECT’S DECLARED SCOPE, OR NOT YET SEEDED INTO ITS PROJECT’S PARITY MANIFEST.
ACCESSIBILITYAXE 4.12.1
CHECKEVIDENCEDETAILRESULT
Default stateAXEbanner--CustomIconPASS
Advanced statesAXE2 further storiesPASS
Screen readerMANUALNo screen-reader pass has been recorded for this component.NOT RECORDED
Keyboard navigationINTERACTION TESTSNo interaction tests and no manual keyboard pass.NOT RECORDED
The CI gate disables color-contrast globally (libs/al-web-components/story-fixture/src/main.ts), so its result never reaches a test run. It is enabled for this measurement, and reported here whichever way it comes out.
NO CONTRAST VIOLATIONS ACROSS THIS COMPONENT’S 3 STORIES.
import '@southleft/al-web-components/components/banner';
import { ALBanner } from '@southleft/al-react';
API — 2 PROPS2 DOCUMENTED
PROPTYPEDEFAULT
isDismissiblebooleanWhether the banner shows a dismiss control.—
isDismissedbooleanWhether the banner has been dismissed. Owned state, toggled by `close()`.—
SLOTS3
SLOTDESCRIPTION
(default)The banner's message content.
linkOptional trailing link/CTA (typically an `<al-link>`).
iconSlot in an icon to override the default one.
EVENTS1
EVENTDESCRIPTIONTYPE
onBannerCloseFired when the banner is dismissed. Detail: `{ isDismissed }`.CustomEvent
CSS CUSTOM PROPERTIES1
PROPERTYDESCRIPTIONDEFAULT
--al-banner-icon-fillFill of the leading icon. Defaults to the informational content color; set it to any content token to retone the banner (e.g. `var(--al-theme-color-content-danger-default)`).—