Estado y avisos@unozero-ai/ui

Alert

Aviso dentro del contenido, en los cuatro tonos de estado.

Usar

import { Alert } from "@unozero-ai/ui/react";

<Alert></Alert>

Cuándo usarlo

Alert vive dentro del contenido, junto a lo que explica: una tarjeta, un formulario, una sección. Si el aviso afecta a toda la vista, va en un Banner arriba de la página; si solo confirma algo que acaba de pasar, en un toast que se va solo.

Configurador

Cambia las props y mira el componente y su código al mismo tiempo.

La Suite Junior no tiene precio para el 24 de diciembre.
dismissible
<Alert>La Suite Junior no tiene precio para el 24 de diciembre.</Alert>

Variantes

Cada tono trae su icono y su par de tinte y texto con contraste AA; default es la nota neutra, sin estado. El significado lo carga el título; el color solo lo confirma (la Regla del Tenant). Escribe el título como el hecho, no como la categoría: «Habitación sin tarifa», no «Advertencia». El título va en heading, no en title como en el kit React: title es un atributo de HTML y pintaría un tooltip nativo.

La habitación 204 pidió despertador a las 6:00.Desde el 15 de diciembre se aplican las tarifas de temporada alta a todas las habitaciones.Hosroom envió 42 cambios de inventario hace 3 minutos.La Suite Junior no tiene precio para el 24 de diciembre y no se puede reservar ese día.El banco rechazó la tarjeta del huésped. La reserva queda en espera de pago.

Solo título o solo texto

heading y el contenido son opcionales. Usa solo el título cuando el hecho cabe en una línea, y solo el texto para una nota que no necesita titular.

El huésped pidió factura a nombre de empresa. Revisa el NIT antes de emitirla.

Con una acción

El contenido acepta cualquier marcado. Si el aviso pide un paso, pon un Button variant="link": un botón relleno dentro de un aviso compite con la acción principal de la pantalla (la Regla de una Sola Decisión). Para cambiar el icono, ponlo en el slot icon; para un título con marcado, en el slot heading.

Te quedan 480 de 5.000. Al llegar al límite, el agente deja de responder a los huéspedes.

Ampliar el plan

Descartable

Con dismissible aparece la equis. Al pulsarla, el aviso se funde, pliega su alto para que lo de debajo suba sin salto, queda hidden y emite uz-dismiss. Recordar que se cerró es cosa tuya: vuelve a mostrarlo con hidden={false}. En React, el envoltorio de esta versión aún no trae onDismiss, así que la demo escucha el evento en el elemento con un ref.

Las conversaciones con huéspedes extranjeros se responden en su idioma. Revisa las respuestas de esta semana.

En un formulario

El resumen de errores va arriba del formulario y cada campo dice el suyo debajo. danger lleva role="alert", así que al aparecer el lector de pantalla lo anuncia; el resto de tonos, role="status". Pulsa «Emitir factura» con los campos vacíos y luego rellénalos.

Emitir factura

API

Generada del custom-elements.json que publica @unozero-ai/ui. Las partes se estilan desde tu CSS con el nombre del elemento: uz-button::part(base).

Alert · <uz-alert>

PropTipoDefectoDescripción
variant"default" | "info" | "success" | "warning" | "danger""info"Tono del aviso: icono y par de tinte y texto. danger se anuncia como role="alert".
headingstring""El title del kit React (title es un atributo global: mostraría un tooltip nativo).
dismissiblebooleanfalseMuestra la ✕ para cerrarlo; al cerrarse queda hidden y emite uz-dismiss.
EventoDescripción
onDismissTras la salida, cuando ya está oculto.
SlotDescripción
(por defecto)El cuerpo. Una acción va aquí como <uz-button variant="link">.
headingTítulo con marcado (alternativa a heading).
iconSustituye al icono de la variante.
Parte CSSDescripción
uz-alert::part(base)La superficie.
MétodoDescripción
dismiss()—