Saltar al contenido
Índice de Kit UI
Kit UI Componentes

Estado de error.

Patrón canónico de estado 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 ui-state ui-state--error" data-error-state role="alert"><svg class="ui-state__icon" viewBox="0 0 24 24" aria-hidden="true"><circle cx="12" cy="12" r="9"></circle><path d="M12 7v6M12 17h.01"></path></svg><div><h3>No pudimos cargar los datos</h3><p>Conservamos la última versión disponible.</p><div class="ui-actions"><button class="btn btn--secondary" type="button">Reintentar</button><a class="btn btn--quiet" href="#estado">Ver estado del servicio</a></div></div></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
Estado de error tiene 3 implementaciones observadas en 3 repositorios: cochid/cochid-kiosk, cochid/cochid-videos, cochid/cochid-videos-app.
Cambio propuesto
Publicar en r19 el contrato de Estado de error para Patrón canónico de estado de error para todos los consumidores.
Qué ocurre si respondes No
No se adopta el contrato r19 de Estado de error; las 3 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. 3 implementaciones observadas en 3 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
Implementaciones3 implementaciones observadas
Repositorioscochid/cochid-kiosk, 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
<section class="ui-sample ui-feedback ui-state ui-state--error" data-error-state role="alert"><svg class="ui-state__icon" viewBox="0 0 24 24" aria-hidden="true"><circle cx="12" cy="12" r="9"></circle><path d="M12 7v6M12 17h.01"></path></svg><div><h3>No pudimos cargar los datos</h3><p>Conservamos la última versión disponible.</p><div class="ui-actions"><button class="btn btn--secondary" type="button">Reintentar</button><a class="btn btn--quiet" href="#estado">Ver estado del servicio</a></div></div></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 ui-state ui-state--error border border-slate-300 bg-white p-4 text-slate-950 grid gap-3" data-error-state role="alert"><svg class="ui-state__icon h-auto w-full" viewBox="0 0 24 24" aria-hidden="true"><circle cx="12" cy="12" r="9"></circle><path d="M12 7v6M12 17h.01"></path></svg><div><h3>No pudimos cargar los datos</h3><p>Conservamos la última versión disponible.</p><div class="ui-actions"><button class="btn btn--secondary border border-slate-950 px-3 py-2 focus-visible:outline-2 focus-visible:outline-offset-2 disabled:cursor-not-allowed" type="button">Reintentar</button><a class="btn btn--quiet underline underline-offset-4" href="#estado">Ver estado del servicio</a></div></div></section>

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 ErrorStateProps {
  /** Qué no se pudo hacer («No pudimos cargar los datos»). */
  title?: string;
  /** Qué se conserva o qué respondió el origen, con hora si la hay. */
  description?: string;
  /** Texto del botón que reintenta; vacío lo oculta. */
  retryLabel?: string;
  /** Se llama al pulsar el botón de reintentar. */
  onRetry?: MouseEventHandler<HTMLButtonElement>;
  /** Texto del enlace a la página de estado; vacío lo oculta. */
  statusLabel?: string;
  /** Destino del enlace a la página de estado del servicio. */
  statusHref?: string;
  className?: string;
}

/**
 * Estado de error de una vista cuyos datos no cargaron, con el motivo, un botón para reintentar y un enlace al estado del servicio.
 *
 * Usa `role="alert"`. Si ambas acciones van vacías, no se muestra la fila de acciones.
 *
 * @example <ErrorState onRetry={recargar} statusHref="/estado" />
 * @example <ErrorState description="El origen respondió 503 a las 18:24 CLT." onRetry={recargar} />
 */
export function ErrorState({
  title = "No pudimos cargar los datos",
  description = "Conservamos la última versión disponible.",
  retryLabel = "Reintentar",
  onRetry,
  statusLabel = "Ver estado del servicio",
  statusHref = "#estado",
  className,
}: ErrorStateProps) {
  return (
    <section className={["ui-feedback ui-state ui-state--error", className].filter(Boolean).join(" ")} data-error-state role="alert">
      <svg className="ui-state__icon" viewBox="0 0 24 24" aria-hidden="true"><circle cx="12" cy="12" r="9"></circle><path d="M12 7v6M12 17h.01"></path></svg>
      <div>
        {title ? <h3>{title}</h3> : null}
        {description ? <p>{description}</p> : null}
        {retryLabel || statusLabel ? (
          <div className="ui-actions">
            {retryLabel ? <button className="btn btn--secondary" type="button" onClick={onRetry}>{retryLabel}</button> : null}
            {statusLabel ? <a className="btn btn--quiet" href={statusHref}>{statusLabel}</a> : null}
          </div>
        ) : null}
      </div>
    </section>
  );
}