Representaciones
- HTML accesiblev4 · 42 KB
- PDF de revisiónv4 · 284 KB
- Datos estructuradosJSON · 18 KB
Patrón canónico de representaciones para firmas y documentos, scribe, medicamentos y editorial sebastián.
Primero el componente, después la variación de marca y finalmente su uso dentro de una página.
<section class="ui-sample ui-document" data-representation-list="true"><h3>Representaciones</h3><ul><li><a href="#html">HTML accesible</a><span>v4 · 42 KB</span></li><li><a href="#pdf">PDF de revisión</a><span>v4 · 284 KB</span></li><li><a href="#json">Datos estructurados</a><span>JSON · 18 KB</span></li></ul></section>Cada cambio visible declara su autoridad; lo que permanece canónico no se vuelve a inventar en el producto.
Compara la propuesta con cortes reales del repositorio. La ausencia de una muestra se declara y nunca se reconstruye de memoria.
Preparando comparación histórica…
La comparación convierte una regla abstracta en una diferencia visible y verificable.
La misma anatomía debe conservar lectura, foco y acciones sin cortar contenido ni crear scroll horizontal en la página.
| Dimensión | Contrato |
|---|---|
| Propietario canónico | Sistema de diseño CIS y Firmas y Documentos · core/core-style |
| Consumidores | Firmas y Documentos, Scribe, Medicamentos y Editorial Sebastián |
| Dependencias | contrato documental, representaciones versionadas |
| Estado | candidato |
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.
| Dato | Resultado |
|---|---|
| Clasificación | Patrón propuesto |
| Implementaciones | 0 implementaciones observadas |
| Repositorios | Ningún repositorio observado |
| Snapshot | kit/componentes/componentes-observados.json |
El inventario conserva repositorio, archivo fuente y criterio de asociación. Observar una implementación no la convierte automáticamente en canónica.
| Estado requerido |
|---|
| borrador |
| en revisión |
| firmado |
| archivado |
Copia el bloque completo; después cambia contenido y destinos, no su anatomía.
<section class="ui-sample ui-document" data-representation-list="true"><h3>Representaciones</h3><ul><li><a href="#html">HTML accesible</a><span>v4 · 42 KB</span></li><li><a href="#pdf">PDF de revisión</a><span>v4 · 284 KB</span></li><li><a href="#json">Datos estructurados</a><span>JSON · 18 KB</span></li></ul></section>Copia el bloque completo; después cambia contenido y destinos, no su anatomía.
<section class="ui-sample ui-document border border-slate-300 bg-white p-4 text-slate-950 grid gap-3" data-representation-list="true"><h3>Representaciones</h3><ul class="grid gap-2"><li><a class="underline underline-offset-4" href="#html">HTML accesible</a><span>v4 · 42 KB</span></li><li><a class="underline underline-offset-4" href="#pdf">PDF de revisión</a><span>v4 · 284 KB</span></li><li><a class="underline underline-offset-4" href="#json">Datos estructurados</a><span>JSON · 18 KB</span></li></ul></section>Copia el bloque completo; después cambia contenido y destinos, no su anatomía.
export interface RepresentationListItem {
/** Nombre de la representación («HTML accesible», «PDF firmado»). */
label: string;
href: string;
/** Versión o formato y tamaño («v4 · 42 KB»); vacío lo oculta. */
detail?: string;
}
export interface RepresentationListProps {
title?: string;
/** Una entrada por formato disponible del mismo documento. */
items?: RepresentationListItem[];
className?: string;
}
const REPRESENTATION_LIST_ITEMS: RepresentationListItem[] = [
{ label: "HTML accesible", href: "#html", detail: "v4 · 42 KB" },
{ label: "PDF de revisión", href: "#pdf", detail: "v4 · 284 KB" },
{ label: "Datos estructurados", href: "#json", detail: "JSON · 18 KB" },
];
/**
* Lista de las representaciones de un documento (HTML, PDF, datos) con su versión o formato y tamaño; se usa en la ficha del documento para elegir en qué formato abrirlo.
*
* @example <RepresentationList items={[{ label: "HTML accesible", href: "/documentos/fyd-184/v4.html", detail: "v4 · 42 KB" }, { label: "PDF firmado", href: "/documentos/fyd-184/v4.pdf", detail: "v4 · 284 KB" }]} />
*/
export function RepresentationList({
title = "Representaciones",
items = REPRESENTATION_LIST_ITEMS,
className,
}: RepresentationListProps) {
return (
<section className={["ui-document", className].filter(Boolean).join(" ")} data-representation-list>
{title ? <h3>{title}</h3> : null}
{items.length ? (
<ul>
{items.map((item, i) => (
<li key={`${item.href}-${i}`}>
<a href={item.href}>{item.label}</a>
{item.detail ? <span>{item.detail}</span> : null}
</li>
))}
</ul>
) : null}
</section>
);
}