Prezentare generală
Banner aranjează conținutul furnizat de apelant, un nod icon opțional și un nod action opțional. status descrie semnificația feedbackului: neutral, info, success, warning sau error. variant selectează aspectul solid sau soft. Un color explicit suprascrie paleta de stare fără a-i modifica semnificația.
Valorile implicite sunt status="info" și variant="solid". Paletele de stare implicite sunt, respectiv, gri, albastru, verde, portocaliu și roșu.
Utilizare
Acțiuni și aspect
Banner.Action oferă un buton mic cu contur, care moștenește culoarea afișată a bannerului, inclusiv suprascrierile explicite ale paletei și aspectele solide. Acceptă interacțiuni Button, linkuri, ref-uri și redare personalizată. Slotul action acceptă și controale arbitrare.
Ținta rădăcină este un div. Atributele native, gestionarele de evenimente, className, style și ref se aplică acelei rădăcini. render acceptă un element Base UI sau un callback; callbackul primește proprietăți native și ref, plus starea rezolvată pentru status, variant și color. Păstrați proprietățile și ref-ul furnizate atunci când compuneți un alt element.
role, aria-live sau anunțuri. Alegeți-le la apelant atunci când actualizările trebuie anunțate. Furnizați nume accesibile pentru controale și marcați nodurile icon decorative cu aria-hidden. Apelantul controlează vizibilitatea și închiderea.
Închidere
TransmiteționDismiss pentru a afișa un control fantomă de închidere de 24 px la capătul logic pe linie. Controlul moștenește culoarea bannerului și are type="button". Valoarea implicită pentru closeLabel este Close; furnizați text localizat în aplicația dvs. Spațierea echilibrată pe linie păstrează conținutul centrat și acțiunile departe de control.
Apelantul controlează vizibilitatea. Activarea controlului de închidere apelează onDismiss și păstrează bannerul montat până când apelantul actualizează starea. Alte acțiuni rămân în slotul action.
Migrare
Înlocuițivariant="primary" cu variant="solid" și variant="secondary" cu variant="soft". Înlocuiți color="danger" cu status="error" sau cu color="red" atunci când trebuie modificată doar paleta. Bannerele informative albastre pot utiliza status="info".
Proprietăți
ReactNode
Optional trailing ReactNode. Banner.Action supplies a small outline action that inherits the resolved banner color; arbitrary controls are also accepted.
ReactNode
Caller-provided content, including text, links and controls.
string
Class merged onto the root div or composed element.
string
implicit:"Close"
Accessible label for the close control. Defaults to Close; supply localized text when needed.
"blue" | "gray" | "green" | "orange" | "red"
implicit:"status palette"
Palette override: gray, blue, green, orange or red. When omitted, status selects the corresponding palette.
ReactNode
Optional leading ReactNode. The caller supplies decorative or accessible icon semantics.
(() => void)
Renders a 24px ghost close control and calls this callback when activated. The caller owns visibility.
Ref<HTMLDivElement>
Ref to the root div, or to the DOM element supplied through render.
ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, BannerState>
Base UI element or render callback. The callback receives native props/ref and resolved status, variant and color state.
"error" | "info" | "neutral" | "success" | "warning"
implicit:"info"
Feedback meaning: neutral, info, success, warning or error. Defaults to info. Does not assign a role or live region.
CSSProperties
Inline styles applied to the root div or composed element.
"soft" | "solid"
implicit:"solid"
Solid or soft appearance. Defaults to solid, independently of status.
Banner.Action
string | ((state: ButtonState) => string | undefined)
CSS class applied to the element, or a function that
returns a class based on the component’s state.
boolean
Adds a shadow and backdrop blur. Neutral outline buttons also use elevated surface colors.
ReactNode
Decorative content displayed after the label.
boolean
implicit:"false"
Whether the button should be focusable when disabled.
boolean
Expands the button to fill its container width.
string
Destination URL. Renders a native anchor when
render is omitted unless nativeButton is explicitly true. Custom renderers retain their own element contract.boolean
Shows a loading indicator and disables activation.
"center" | "end" | "start"
Where the loading indicator appears.
center hides the content while preserving its layout space; start and end keep children and the opposite icon visible and replace the corresponding icon with the spinner.boolean
implicit:"true"
Whether the rendered root is a native button. Defaults to true for custom renderers. The built-in
href anchor defaults to false; an explicit value takes precedence.ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, ButtonState>
Caller-supplied root element or renderer. Native attributes, handlers, event details, and refs reach the rendered root. Use
nativeButton={false} and role="link" for a custom navigation anchor. Router integration belongs to the caller.AriaRole
Role of the root element. Use
link for custom navigation renderers.ShortcutDefinition
Flat key array for simultaneous keys, or nested key arrays for an ordered sequence. Displayed on non-mobile screens.
string
Localized text between sequence steps. Defaults to then.
ReactNode
Decorative content displayed before the label.
CSSProperties | ((state: ButtonState) => CSSProperties | undefined)
Style applied to the element, or a function that
returns a style object based on the component’s state.