> ## Documentation Index
> Fetch the complete documentation index at: https://docs.twenty.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Estandarte

> Contenido de retroalimentación con estado, apariencia y paleta independientes.

## Resumen

`Banner` organiza el contenido proporcionado por quien realiza la llamada, un nodo `icon` opcional y un nodo `action` opcional. `status` describe el significado de la retroalimentación: `neutral`, `info`, `success`, `warning` o `error`. `variant` selecciona la apariencia `solid` o `soft`. Un `color` explícito reemplaza la paleta del estado sin cambiar su significado.

Los valores predeterminados son `status="info"` y `variant="solid"`. Las paletas de estado predeterminadas son gris, azul, verde, naranja y rojo, respectivamente.

**Light**

[Ejemplo de banner (light)](https://storybook.twenty.com/iframe.html?id=ui-feedback-banner--display\&viewMode=story\&globals=colorScheme:light)

**Dark**

[Ejemplo de banner (dark)](https://storybook.twenty.com/iframe.html?id=ui-feedback-banner--display\&viewMode=story\&globals=colorScheme:dark)

[Open in Storybook](https://storybook.twenty.com/?path=/story/ui-feedback-banner--display)

## "Uso"

```tsx theme={null}
import { Banner } from 'twenty-ui/primitives/feedback';

export const SyncBanner = () => (
  <Banner status="info" variant="solid">
    Contact sync is temporarily paused. Your saved records remain available.
  </Banner>
);
```

## Acciones y apariencia

**Light**

[Paletas y variantes de comentarios para banners (light)](https://storybook.twenty.com/iframe.html?id=ui-feedback-banner--catalog\&viewMode=story\&globals=colorScheme:light)

**Dark**

[Paletas y variantes de comentarios para banners (dark)](https://storybook.twenty.com/iframe.html?id=ui-feedback-banner--catalog\&viewMode=story\&globals=colorScheme:dark)

[Open in Storybook](https://storybook.twenty.com/?path=/story/ui-feedback-banner--catalog)

```tsx theme={null}
import { Banner } from 'twenty-ui/primitives/feedback';
import { IconInfoCircle } from 'twenty-ui/icon';

export const SyncBanner = ({ onRetry }: { onRetry: () => void }) => (
  <Banner
    status="error"
    variant="soft"
    color="blue"
    icon={<IconInfoCircle aria-hidden="true" />}
    action={<Banner.Action onClick={onRetry}>Retry sync</Banner.Action>}
  >
    Contact sync could not finish.
  </Banner>
);
```

`Banner.Action` proporciona un botón pequeño con contorno que hereda el color mostrado del banner, incluidas las anulaciones explícitas de la paleta y las apariencias sólidas. Admite interacciones de Button, enlaces, refs y renderizado personalizado. La ranura `action` también acepta controles arbitrarios.

El destino raíz es un `div`. Los atributos nativos, los controladores de eventos, `className`, `style` y `ref` se aplican a esa raíz. `render` acepta un elemento Base UI o una función de devolución de llamada; la función recibe props nativas y ref, además del estado resuelto de `status`, `variant` y `color`. Conserve las props y ref proporcionadas al componer otro elemento.

```tsx theme={null}
import { Banner } from 'twenty-ui/primitives/feedback';

export const SyncResult = () => (
  <Banner
    status="success"
    variant="soft"
    role="status"
    aria-live="polite"
    aria-atomic="true"
    render={<section aria-label="Sync result" />}
  >
    Contacts are up to date.
  </Banner>
);
```

El estado no asigna automáticamente `role`, `aria-live` ni anuncios. Elíjalos en quien realiza la llamada cuando se deban anunciar las actualizaciones. Proporcione nombres accesibles para los controles y marque los nodos de iconos decorativos con `aria-hidden`. Quien realiza la llamada controla la visibilidad y el descarte.

## Cierre

Pasa `onDismiss` para mostrar un control de cierre transparente de 24 px al final lógico en línea. El control hereda el color del banner y tiene `type="button"`. `closeLabel` tiene como valor predeterminado `Close`; proporciona texto localizado en tu aplicación. El espaciado en línea equilibrado mantiene el contenido centrado y las acciones despejados del control.

La persona que llama controla la visibilidad. Al activar el control de cierre, se llama a `onDismiss` y el banner permanece montado hasta que la persona que llama actualiza el estado. Las demás acciones permanecen en la ranura `action`.

```tsx theme={null}
import { useState } from 'react';
import { Banner } from 'twenty-ui/primitives/feedback';

export const DismissibleSyncBanner = () => {
  const [isVisible, setIsVisible] = useState(true);

  return isVisible ? (
    <Banner
      onDismiss={() => setIsVisible(false)}
      closeLabel="Dismiss sync message"
    >
      Contacts are syncing in the background.
    </Banner>
  ) : null;
};
```

**Light**

[Banner que se puede descartar (light)](https://storybook.twenty.com/iframe.html?id=ui-feedback-banner--dismissible\&viewMode=story\&globals=colorScheme:light)

**Dark**

[Banner que se puede descartar (dark)](https://storybook.twenty.com/iframe.html?id=ui-feedback-banner--dismissible\&viewMode=story\&globals=colorScheme:dark)

[Open in Storybook](https://storybook.twenty.com/?path=/story/ui-feedback-banner--dismissible)

## Migración

Reemplace `variant="primary"` por `variant="solid"` y `variant="secondary"` por `variant="soft"`. Reemplace `color="danger"` por `status="error"`, o por `color="red"` cuando solo deba cambiar la paleta. Los banners de información azules pueden usar `status="info"`.

## "Props"

**action** `ReactNode`

Optional trailing ReactNode. Banner.Action supplies a small outline action that inherits the resolved banner color; arbitrary controls are also accepted.

**children** `ReactNode`

Caller-provided content, including text, links and controls.

**className** `string`

Class merged onto the root div or composed element.

**closeLabel** `string` (default: Close)

Accessible label for the close control. Defaults to Close; supply localized text when needed.

**color** `"blue" | "gray" | "green" | "orange" | "red"` (default: status palette)

Palette override: gray, blue, green, orange or red. When omitted, status selects the corresponding palette.

**icon** `ReactNode`

Optional leading ReactNode. The caller supplies decorative or accessible icon semantics.

**onDismiss** `(() =\> void)`

Renders a 24px ghost close control and calls this callback when activated. The caller owns visibility.

**ref** `Ref\<HTMLDivElement\>`

Ref to the root div, or to the DOM element supplied through render.

**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.

**status** `"error" | "info" | "neutral" | "success" | "warning"` (default: info)

Feedback meaning: neutral, info, success, warning or error. Defaults to info. Does not assign a role or live region.

**style** `CSSProperties`

Inline styles applied to the root div or composed element.

**variant** `"soft" | "solid"` (default: solid)

Solid or soft appearance. Defaults to solid, independently of status.

### Banner.Action

**Action.className** `string | ((state: ButtonState) =\> string | undefined)`

CSS class applied to the element, or a function that
returns a class based on the component's state.

**Action.elevated** `boolean`

Adds a shadow and backdrop blur. Neutral outline buttons also use elevated surface colors.

**Action.endIcon** `ReactNode`

Decorative content displayed after the label.

**Action.focusableWhenDisabled** `boolean` (default: false)

Whether the button should be focusable when disabled.

**Action.fullWidth** `boolean`

Expands the button to fill its container width.

**Action.href** `string`

Destination URL. Renders a native anchor when `render` is omitted unless `nativeButton` is explicitly true. Custom renderers retain their own element contract.

**Action.loading** `boolean`

Shows a loading indicator and disables activation.

**Action.loadingPosition** `"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.

**Action.nativeButton** `boolean` (default: 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.

**Action.render** `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.

**Action.role** `AriaRole`

Role of the root element. Use `link` for custom navigation renderers.

**Action.shortcut** `ShortcutDefinition`

Flat key array for simultaneous keys, or nested key arrays for an ordered sequence. Displayed on non-mobile screens.

**Action.shortcutJoinLabel** `string`

Localized text between sequence steps. Defaults to then.

**Action.startIcon** `ReactNode`

Decorative content displayed before the label.

**Action.style** `CSSProperties | ((state: ButtonState) =\> CSSProperties | undefined)`

Style applied to the element, or a function that
returns a style object based on the component's state.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.