- contrato-v4.pdf · 2,4 MB
Adjuntos.
Patrón canónico de adjuntos para cis-admin, cis-infra, cis-inbox, usaia y servicios internos.
Verlo por niveles
Primero el componente, después la variación de marca y finalmente su uso dentro de una página.
- contrato-v4.pdf · 2,4 MB
- anexo.csv · 0,7 MB
- contrato-v4.pdf · 2,4 MB
Ver y copiar el código de este render
<section class="ui-sample ui-service" data-attachment-list="true"><header><strong>Adjuntos</strong><span>1 archivo · 2,4 MB</span></header><ul><li><span>contrato-v4.pdf · 2,4 MB</span><progress value="100" max="100">100%</progress><button class="btn btn--secondary btn--sm" type="button">Quitar</button></li></ul></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.md- contrato-v4.pdf · 2,4 MB
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
Autoridad: core-style/DECISIONES.md M15 y LOGOS-CANONICOS.md- contrato-v4.pdf · 2,4 MB
- anexo.csv · 0,7 MB
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
- Adjuntos no tiene una implementación vigente demostrada; sus ejemplos son material candidato.
- Cambio propuesto
- Publicar en r19 el contrato de Adjuntos para Patrón canónico de adjuntos para cis-admin, cis-infra, cis-inbox, usaia y servicios internos.
- Qué ocurre si respondes No
- Adjuntos 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.
- contrato-v4.pdf · 2,4 MB
- Conecta estado, timestamp y fuente al servicio real.
- Explica impacto, recuperación y recibo cuando hay una falla.
- No muestres CONFIRMADO o EN LÍNEA sin señal verificable.
- No expongas secretos, tokens ni trazas con datos personales.
Responsive
La misma anatomía debe conservar lectura, foco y acciones sin cortar contenido ni crear scroll horizontal en la página.
- contrato-v4.pdf · 2,4 MB
- contrato-v4.pdf · 2,4 MB
- anexo.csv · 0,7 MB
Cobertura
| Dimensión | Contrato |
|---|---|
| Propietario canónico | Sistema de diseño CIS e Infraestructura · core/core-style |
| Consumidores | cis-admin, cis-infra, cis-inbox, usaia y servicios internos |
| Dependencias | API del servicio, recibos verificables |
| Estado | candidato |
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.
| Dato | Resultado |
|---|---|
| Clasificación | Patrón propuesto |
| Implementaciones | 0 implementaciones observadas |
| Repositorios | Ningún repositorio observado |
| 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 |
|---|
| operativo |
| degradado |
| fallido |
| sin datos |
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-service" data-attachment-list="true"><header><strong>Adjuntos</strong><span>1 archivo · 2,4 MB</span></header><ul><li><span>contrato-v4.pdf · 2,4 MB</span><progress value="100" max="100">100%</progress><button class="btn btn--secondary btn--sm" type="button">Quitar</button></li></ul></section>Código TAILWIND
Copia el bloque completo; después cambia contenido y destinos, no su anatomía.
<section class="ui-sample ui-service border border-slate-300 bg-white p-4 text-slate-950 grid gap-3" data-attachment-list="true"><header class="flex flex-wrap items-center justify-between gap-3"><strong>Adjuntos</strong><span>1 archivo · 2,4 MB</span></header><ul class="grid gap-2"><li><span>contrato-v4.pdf · 2,4 MB</span><progress value="100" max="100">100%</progress><button class="btn btn--secondary btn--sm border border-slate-950 px-3 py-2 focus-visible:outline-2 focus-visible:outline-offset-2 disabled:cursor-not-allowed" type="button">Quitar</button></li></ul></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 AttachmentListItem {
/** Nombre del archivo, con su extensión. */
name: string;
/** Tamaño con su unidad («2,4 MB»); se muestra después del nombre. */
size?: string;
/** Avance de la carga, de 0 a 100; sin valor no se muestra la barra. */
progress?: number;
/** Texto de la barra de avance; por defecto el porcentaje redondeado («68%»). */
progressLabel?: string;
/** Se llama al quitar el archivo o al cancelar su carga. */
onRemove?: MouseEventHandler<HTMLButtonElement>;
}
export interface AttachmentListProps {
title?: string;
/** Resumen del conjunto: cantidad de archivos y tamaño total («2 archivos · 3,1 MB»); vacío lo oculta. */
summary?: string;
/** Un elemento por archivo adjunto o en carga. */
items?: AttachmentListItem[];
/** Texto del botón de un archivo que terminó de cargar. */
removeLabel?: string;
/** Texto del botón de un archivo cuya carga no termina (`progress` menor que 100). */
cancelLabel?: string;
className?: string;
}
const ATTACHMENT_LIST_ITEMS: AttachmentListItem[] = [{ name: "contrato-v4.pdf", size: "2,4 MB", progress: 100 }];
/**
* Lista de archivos adjuntos con su tamaño, avance de carga y botón para quitar cada uno; se usa al redactar un mensaje o completar una solicitud.
*
* Mientras un archivo carga, su botón dice `cancelLabel`; al terminar, `removeLabel`. En ambos casos llama a `onRemove` del archivo. Cada fila lleva su botón secundario pequeño (`btn--secondary btn--sm`).
*
* @example <AttachmentList summary="1 archivo · 2,4 MB" items={[{ name: "contrato-v4.pdf", size: "2,4 MB", progress: 100, onRemove: quitar }]} />
* @example <AttachmentList summary="2 archivos · 3,1 MB" items={[{ name: "contrato-v4.pdf", size: "2,4 MB", progress: 100 }, { name: "anexo.csv", size: "0,7 MB", progress: 68 }]} />
*/
export function AttachmentList({
title = "Adjuntos",
summary = "1 archivo · 2,4 MB",
items = ATTACHMENT_LIST_ITEMS,
removeLabel = "Quitar",
cancelLabel = "Cancelar",
className,
}: AttachmentListProps) {
return (
<section className={["ui-service", className].filter(Boolean).join(" ")} data-attachment-list>
<header>
<strong>{title}</strong>
{summary ? <span>{summary}</span> : null}
</header>
{items.length ? (
<ul>
{items.map((item, i) => {
const cargando = item.progress !== undefined && item.progress < 100;
return (
<li key={`${item.name}-${i}`}>
<span>{item.size ? `${item.name} · ${item.size}` : item.name}</span>
{item.progress !== undefined ? (
<progress value={item.progress} max={100}>{item.progressLabel ?? `${Math.round(item.progress)}%`}</progress>
) : null}
<button className="btn btn--secondary btn--sm" type="button" onClick={item.onRemove}>{cargando ? cancelLabel : removeLabel}</button>
</li>
);
})}
</ul>
) : null}
</section>
);
}