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.
Ver y copiar el código de este render
<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.
Compañía de Innovación de Santiago
Autoridad: CONSTITUTION.md + LOGOS-CANONICOS.mdCambia 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
Autoridad: core-style/DECISIONES.md M15 y LOGOS-CANONICOS.mdCambia 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.
- Usa HTML semántico, foco visible y estados explícitos.
- Conserva contenido útil a 320 px y sin JavaScript.
- 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.
Cobertura
| Dimensión | Contrato |
|---|---|
| Propietario canónico | Sistema de diseño CIS · core/core-style |
| Consumidores | Todos los consumidores |
| Dependencias | HTML nativo, ARIA sólo cuando aporta |
| Estado | candidato |
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.
| Dato | Resultado |
|---|---|
| Clasificación | Patrón observado |
| Implementaciones | 3 implementaciones observadas |
| Repositorios | cochid/cochid-kiosk, cochid/cochid-videos, cochid/cochid-videos-app |
| Snapshot | kit/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.
<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.
<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.
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>
);
}