Saltar al contenido
Índice de Kit UI
Kit UI Componentes

Notificación temporal.

Patrón canónico de notificación temporal para todos los consumidores.

Verlo por niveles

Primero el componente, después la variación de marca y finalmente su uso dentro de una página.

Nivel 1Componente canónico
Nivel 2COCHID · variación
Nivel 3Dentro de una página
Sitio · sección
Ver y copiar el código de este render
HTML del nivel canónico
<aside class="ui-sample ui-feedback" data-toast="true" role="status" aria-live="polite"><div><strong>Cambios guardados</strong><p>Versión 4 · 18:24 CLT</p></div><button class="btn btn--icon" type="button" aria-label="Cerrar notificación">×</button></aside>

Variaciones por marca y sitio

Cada cambio visible declara su autoridad; lo que permanece canónico no se vuelve a inventar en el producto.

innovacionsantiago.cl

Compañía de Innovación de Santiago

Autoridad: CONSTITUTION.md + LOGOS-CANONICOS.md

Cambia en esta marca

  • Navegación y contenido propios del servicio
  • Acento reservado para acciones y datos

Permanece canónico

  • Mark CIS y namebrand de tres líneas
  • IBM Plex Sans, foco, espaciado y anatomía
cochid.cl

COCHID

Autoridad: core-style/DECISIONES.md M15 y LOGOS-CANONICOS.md

Cambia en esta marca

  • Cuadrado azul y namebrand de tres líneas
  • Azul COCHID en selección, capas y series

Permanece canónico

  • Estructura y semántica comunes
  • Fuentes, unidades y alternativa tabular

Comparación histórica recuperable

Compara la propuesta con cortes reales del repositorio. La ausencia de una muestra se declara y nunca se reconstruye de memoria.

Estado actual
Notificación temporal tiene 8 implementaciones observadas en 6 repositorios: cds/cis/cis-admin, cds/cis/cis-usaia, cds/cis/periodismo2-frontend, cochid/cochid-lex, cochid/cochid-videos, cochid/cochid-videos-app.
Cambio propuesto
Publicar en r19 el contrato de Notificación temporal para Patrón canónico de notificación temporal para todos los consumidores.
Qué ocurre si respondes No
No se adopta el contrato r19 de Notificación temporal; las 8 implementaciones observadas permanecen sin migración.

Preparando comparación histórica…

Antes / r19

La comparación convierte una regla abstracta en una diferencia visible y verificable.

r19 · correctoContrato canónico renderizado
  • Usa HTML semántico, foco visible y estados explícitos.
  • Conserva contenido útil a 320 px y sin JavaScript.
Antes · problema observadoAnti-ejemplo no interactivo
EN LÍNEATodo funciona correctamenteSin señal, hora ni servicio asociado
  • No agregues sombras, radios ni franjas laterales decorativas.
  • No uses color, placeholder o icono como única explicación.

Responsive

La misma anatomía debe conservar lectura, foco y acciones sin cortar contenido ni crear scroll horizontal en la página.

320 pxMóvil y zoom
1280 pxEscritorio

Cobertura

DimensiónContrato
Propietario canónicoSistema de diseño CIS · core/core-style
ConsumidoresTodos los consumidores
DependenciasHTML nativo, ARIA sólo cuando aporta
Estadocandidato

Evidencia de adopción

Patrón observado. 8 implementaciones observadas en 6 repositorios.

La observación demuestra uso existente; la aceptación canónica sigue dependiendo de esta ficha y de su propietario.

DatoResultado
ClasificaciónPatrón observado
Implementaciones8 implementaciones observadas
Repositorioscds/cis/cis-admin, cds/cis/cis-usaia, cds/cis/periodismo2-frontend, cochid/cochid-lex, cochid/cochid-videos, cochid/cochid-videos-app
Snapshotkit/componentes/componentes-observados.json

Consumidores observados

El inventario conserva repositorio, archivo fuente y criterio de asociación. Observar una implementación no la convierte automáticamente en canónica.

Estados

Estado requerido
información
advertencia
error
éxito

Accesibilidad

  • Conserva nombre accesible, orden de lectura y foco visible.
  • Funciona a 320 px, con zoom de 200% y texto largo.
  • El color nunca es la única señal de estado o acción.
  • El contenido esencial permanece disponible sin JavaScript.

Código HTML

Copia el bloque completo; después cambia contenido y destinos, no su anatomía.

Código de referencia
<aside class="ui-sample ui-feedback" data-toast="true" role="status" aria-live="polite"><div><strong>Cambios guardados</strong><p>Versión 4 · 18:24 CLT</p></div><button class="btn btn--icon" type="button" aria-label="Cerrar notificación">×</button></aside>

Código TAILWIND

Copia el bloque completo; después cambia contenido y destinos, no su anatomía.

Código de referencia
<aside class="ui-sample ui-feedback border border-slate-300 bg-white p-4 text-slate-950 grid gap-3" data-toast="true" role="status" aria-live="polite"><div><strong>Cambios guardados</strong><p>Versión 4 · 18:24 CLT</p></div><button class="btn btn--icon border border-slate-950 px-3 py-2 focus-visible:outline-2 focus-visible:outline-offset-2 disabled:cursor-not-allowed" type="button" aria-label="Cerrar notificación">×</button></aside>

Código REACT

Copia el bloque completo; después cambia contenido y destinos, no su anatomía.

Código de referencia
import type { MouseEventHandler } from "react";

export interface ToastProps {
  /** Qué acción terminó; vacío omite el título. */
  title?: string;
  /** Detalle breve bajo el título; vacío omite el párrafo. */
  description?: string;
  /** Nombre accesible del botón de cierre; vacío oculta el botón. */
  closeLabel?: string;
  /** Se llama al pulsar el botón de cierre; quien usa el componente lo retira. */
  onClose?: MouseEventHandler<HTMLButtonElement>;
  className?: string;
}

/**
 * Notificación temporal que confirma una acción recién hecha (guardar, copiar, enviar) sin cambiar de vista.
 *
 * Usa `role="status"` con `aria-live="polite"`. El componente no se oculta solo: quien lo usa decide cuándo retirarlo, por ejemplo en `onClose`.
 *
 * @example <Toast title="Cambios guardados" description="Versión 4 · 18:24 CLT" onClose={cerrar} />
 * @example <Toast title="Enlace copiado" description="Puedes pegarlo en otro sitio." onClose={cerrar} />
 */
export function Toast({
  title = "Cambios guardados",
  description = "Versión 4 · 18:24 CLT",
  closeLabel = "Cerrar notificación",
  onClose,
  className,
}: ToastProps) {
  return (
    <aside className={["ui-feedback", className].filter(Boolean).join(" ")} data-toast role="status" aria-live="polite">
      {title || description ? (
        <div>
          {title ? <strong>{title}</strong> : null}
          {description ? <p>{description}</p> : null}
        </div>
      ) : null}
      {closeLabel ? <button className="btn btn--icon" type="button" aria-label={closeLabel} onClick={onClose}>×</button> : null}
    </aside>
  );
}