Saltar al contenido
Índice de Kit UI
Kit UI Componentes

Alerta de error.

Patrón canónico de alerta de error 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
<section class="ui-sample ui-feedback" role="alert" data-severity="error"><span class="badge badge--err">Error</span> <strong>No se guardaron los cambios</strong><p>Otra persona guardó una versión más reciente. Revisa las diferencias y vuelve a guardar.</p><a class="btn btn--quiet" href="#detalle">Ver detalle</a></section>

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
Alerta de error no tiene una implementación vigente demostrada; sus ejemplos son material candidato.
Cambio propuesto
Publicar en r19 el contrato de Alerta de error para Patrón canónico de alerta de error para todos los consumidores.
Qué ocurre si respondes No
Alerta de error queda fuera de r19 y sus ejemplos siguen sólo como evidencia pendiente de reformulació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 propuesto. 0 implementaciones observadas en 0 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 propuesto
Implementaciones0 implementaciones observadas
RepositoriosNingún repositorio observado
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
<section class="ui-sample ui-feedback" role="alert" data-severity="error"><span class="badge badge--err">Error</span> <strong>No se guardaron los cambios</strong><p>Otra persona guardó una versión más reciente. Revisa las diferencias y vuelve a guardar.</p><a class="btn btn--quiet" href="#detalle">Ver detalle</a></section>

Código TAILWIND

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

Código de referencia
<section class="ui-sample ui-feedback border border-slate-300 bg-white p-4 text-slate-950 grid gap-3" role="alert" data-severity="error"><span class="badge badge--err">Error</span> <strong>No se guardaron los cambios</strong><p>Otra persona guardó una versión más reciente. Revisa las diferencias y vuelve a guardar.</p><a class="btn btn--quiet underline underline-offset-4" href="#detalle">Ver detalle</a></section>

Código REACT

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

Código de referencia
export interface AlertErrorProps {
  /** Título del error; vacío omite el título. */
  title?: string;
  /** Qué pasó y cómo corregirlo; vacío omite el párrafo. */
  description?: string;
  /** Texto del enlace al detalle; vacío oculta el enlace. */
  linkLabel?: string;
  /** Destino del enlace al detalle; vacío oculta el enlace. */
  href?: string;
  /** Texto de la insignia que dice la gravedad antes del título («Error»); vacío la oculta. */
  severityLabel?: string;
  className?: string;
}

/**
 * Alerta de error dentro de la página, para una acción que falló; dice qué pasó y cómo corregirlo.
 *
 * Usa `role="alert"`: el lector de pantalla la anuncia de inmediato. La insignia de `severityLabel` dice la gravedad en texto, sin depender del color.
 *
 * @example <AlertError title="No se guardaron los cambios" description="Otra persona guardó una versión más reciente. Revisa las diferencias y vuelve a guardar." href="/conflictos" />
 * @example <AlertError title="No se pudo publicar" description="El archivo supera los 20 MB. Reduce su tamaño y vuelve a subirlo." linkLabel="Ver requisitos" href="/ayuda/archivos" />
 */
export function AlertError({
  title = "No se guardaron los cambios",
  description = "Otra persona guardó una versión más reciente. Revisa las diferencias y vuelve a guardar.",
  linkLabel = "Ver detalle",
  href = "#detalle",
  severityLabel = "Error",
  className,
}: AlertErrorProps) {
  return (
    <section className={["ui-feedback", className].filter(Boolean).join(" ")} role="alert" data-severity="error">
      {severityLabel ? <span className="badge badge--err">{severityLabel}</span> : null}
      {severityLabel && title ? " " : null}
      {title ? <strong>{title}</strong> : null}
      {description ? <p>{description}</p> : null}
      {linkLabel && href ? <a className="btn btn--quiet" href={href}>{linkLabel}</a> : null}
    </section>
  );
}