Saltar al contenido principal
Neural UIv2.0.0Documentación
Ver v1 GitHub

Alert

Comunica un mensaje contextual con acciones y cierre opcionales.

Categoría
Estados y avisos
Import
@neural-ui/core/alert
Selector
neu-alert
import { NeuAlertComponent } from '@neural-ui/core/alert';

Uso

Elige tone para la intención semántica y variant para la superficie. Proyecta el mensaje en el cuerpo y coloca las acciones en neu-alert-actions. closable añade un botón de cierre; cerrar oculta esta instancia y emite closed una sola vez. Crea una nueva instancia para mostrar otro mensaje. icon resuelve un icono de la aplicación; los iconos de tono integrados no necesitan un proveedor.

Ejemplos

Prueba la interacción y abre Código para ver la implementación. Reiniciar restablece el estado inicial.

Ejemplos
Cambios guardados
Tu perfil está actualizado.
Revisa tus ajustes
Confirma las preferencias de notificación.

Pendiente de confirmación.

Prueba y configura

Cambia las opciones y consulta la vista previa y el template generado. Código contiene el ejemplo ejecutable completo.

Prueba y configura

Vista previa

Cuenta actualizada
Tus preferencias se han guardado.

Eventos closed: 0

Template generado: refleja las opciones anteriores. Abre Código para ver los imports y el estado completos.

template.html
<neu-alert
  tone="info"
  variant="soft"
  title="Cuenta actualizada"
  [showIcon]="true"
  [closable]="false"
  closeLabel="Cerrar alerta"
  (closed)="onClosed()"
>
  Tus preferencias se han guardado.
</neu-alert>

Datos y contenido

Los Inputs configuran la alerta. closed informa de que esta instancia se ha cerrado; no es un modelo bidireccional de visibilidad. Las acciones proyectadas por la aplicación gestionan sus propios eventos.

Accesibilidad y teclado

danger utiliza una alerta urgente; los otros tonos anuncian un estado de forma no intrusiva. Reserva los anuncios urgentes para mensajes que requieren atención inmediata. Proporciona un closeLabel significativo. Los botones proyectados conservan su acceso por teclado.

Tecla
Acción
Tab Accede al botón de cerrar cuando está disponible y a los controles proyectados.
Enter Cierra el aviso desde su botón enfocado de cerrar o activa un botón proyectado enfocado.
Space Cierra el aviso desde su botón enfocado de cerrar o activa un botón proyectado enfocado.

API

Los Inputs y Outputs se extraen del paquete fijado. Los tipos con nombre enlazan a sus definiciones; Templates enumera solo las zonas de proyección disponibles.

Inputs

Configura el componente con [propiedad]="valor". Tu aplicación proporciona estos valores; el componente no debe reemplazar el estado que le pasas.

Nombre
Tipo
Por defecto
Uso en el template
Descripción
closablebooleanfalse[closable]Muestra el botón nativo de cierre.
closeLabelstring'Close alert'[closeLabel]Nombre accesible del botón de cierre.
iconstring | nullnull[icon]Clave de icono de la aplicación; null utiliza el icono de tono integrado.
showIconbooleantrue[showIcon]Muestra u oculta el icono decorativo.
titlestring''[title]Título visible opcional sobre el contenido proyectado.
toneNeuAlertTone'info'[tone]info, success, warning o danger; danger anuncia una alerta urgente.
variantNeuAlertVariant'soft'[variant]Fondo soft o superficie outline.

Outputs

Escucha un evento con (evento)="handler($event)". La tabla indica qué datos recibe tu función y cómo utilizarlos.

Nombre
Valor emitido
Uso en el template
Descripción
closedvoid(closed)="onClosed($event)"Emite una sola vez al cerrar esta instancia de la alerta.

Templates

ng-content proyecta contenido dentro del componente. Los inputs TemplateRef reciben un template; las directivas ng-template identifican templates con un contexto tipado. Una directiva compartida en el entrypoint no es necesariamente un slot de este componente.

Nombre
Mecanismo
Contrato
*

Cuerpo del mensaje

Ver ejemplo
Proyección de contenido

Proyecta texto, énfasis o HTML estructurado en el mensaje.

<ng-content />

Contexto utilizado: —

[neu-alert-actions]

Acciones del mensaje

Ver ejemplo
Proyección de contenido

Los botones de la aplicación gestionan sus propias acciones.

<ng-content select="[neu-alert-actions]" />

Contexto utilizado: —

Cada ejemplo muestra un template diferente. Alterna entre Demo y Código para consultar su implementación, imports y estado.

Contenido del mensaje

*

Contenido del mensaje
Antes de continuar

Utiliza HTML proyectado para añadir énfasis y estructura.

Acciones proyectadas

[neu-alert-actions]

Acciones proyectadas
Notificaciones opcionales
Elige si quieres recibir novedades.

Desactivadas

Public Types

Abre un tipo para consultar su definición y los campos de sus interfaces.

Estilos y tokens

Utiliza los Inputs públicos y los tokens de superficie, texto, espaciado y color semántico de Core. Mantén el contenido adaptable y comprueba ambos temas.

Tokens específicos

Token
Efecto
Estado / variante
Valor / origen
Alternativa
--neu-alert-error-bg Valor del tema heredado que utiliza este componente Superficie del campo var(--neu-error-bg)Declaración raíz--neu-error-bg
--neu-alert-error-border Valor del tema heredado que utiliza este componente Superficie del campo rgba(239, 68, 68, 0.2)Declaración raízSin alias de token
--neu-alert-error-text Valor del tema heredado que utiliza este componente Superficie del campo var(--neu-error-text)Declaración raíz--neu-error-text
--neu-alert-info-bg Valor del tema heredado que utiliza este componente Superficie del campo var(--neu-info-bg)Declaración raíz--neu-info-bg
--neu-alert-info-border Valor del tema heredado que utiliza este componente Superficie del campo rgba(0, 122, 255, 0.2)Declaración raízSin alias de token
--neu-alert-info-text Valor del tema heredado que utiliza este componente Superficie del campo var(--neu-info-text)Declaración raíz--neu-info-text
--neu-alert-success-bg Valor del tema heredado que utiliza este componente Superficie del campo var(--neu-success-bg)Declaración raíz--neu-success-bg
--neu-alert-success-border Valor del tema heredado que utiliza este componente Superficie del campo rgba(16, 185, 129, 0.2)Declaración raízSin alias de token
--neu-alert-success-text Valor del tema heredado que utiliza este componente Superficie del campo var(--neu-success-text)Declaración raíz--neu-success-text
--neu-alert-warning-bg Valor del tema heredado que utiliza este componente Superficie del campo var(--neu-warning-bg)Declaración raíz--neu-warning-bg
--neu-alert-warning-border Valor del tema heredado que utiliza este componente Superficie del campo rgba(245, 158, 11, 0.2)Declaración raízSin alias de token
--neu-alert-warning-text Valor del tema heredado que utiliza este componente Superficie del campo var(--neu-warning-text)Declaración raíz--neu-warning-text

Tokens compartidos utilizados

Sobrescríbelos en un contenedor local para afectar a este ejemplo. Una modificación en :root afecta a los demás componentes que utilizan el mismo token.

Token
Efecto aquí
Otros efectos
Valor / alternativa
--neu-radius Radio de las esquinas del control Compartido con otros consumidores de Core; limita el cambio a un ámbito. 8px