Instrumentación y recibos.
Objeto, versión, fuente y acción forman una unidad visible cuando la persona necesita verificar una publicación, proceso o contrato.
Cuándo usar
Objeto, versión, fuente y acción forman una unidad visible cuando la persona necesita verificar una publicación, proceso o contrato.
- Elegir el elemento HTML nativo antes de agregar una primitiva interactiva.
- Mantener el nombre, el resultado y la acción visibles sin depender de un icono.
- Documentar cualquier excepción en el producto consumidor.
Ejemplo visible
Contrato de publicación
Ver recibo- Versión
- 10.0.0-candidate.46
- Publicado
- 25 ago 2026 · 19:20 CLT
- Fuente
- manifest.json · SHA-256
- Alcance
- 378 páginas · 244 componentes canónicos
Anatomía
| Parte | Contrato |
|---|---|
| 1 | Identificador estable del objeto |
| 2 | Nombre humano |
| 3 | Versión o período |
| 4 | Timestamp con zona |
| 5 | Fuente o recibo enlazado |
| 6 | Alcance y consecuencia |
| 7 | Acción contextual |
Estados y variantes
| Estado | Comportamiento esperado |
|---|---|
| vigente | Versión, fuente y fecha verificables |
| parcial | Cobertura disponible y faltante |
| stale | Edad del dato y acción de refresco |
| reemplazado | Versión sucesora y retorno |
| fallido | Objeto afectado, efecto y recuperación |
Accesibilidad
- Usar dl cuando se presentan pares término-valor.
- Los enlaces conservan destino descriptivo.
- El timestamp incluye zona horaria cuando puede haber ambigüedad.
- El color nunca sustituye el texto del estado.
- El detalle técnico no expone secretos, tokens ni datos personales.
HTML de referencia
<section aria-labelledby="contrato-184">
<header>
<span>CTR-184</span>
<h2 id="contrato-184">Contrato de publicación</h2>
</header>
<dl>
<div><dt>Versión</dt><dd>10.0.0-candidate.46</dd></div>
<div><dt>Fuente</dt><dd><a href="/manifest.json">Manifest SHA-256</a></dd></div>
</dl>
</section>Definition of Done
- Ejemplo visible y código copiable coinciden.
- Teclado, foco, nombre accesible y estado fueron probados.
- El componente funciona sin JavaScript o declara una mejora progresiva acotada.
- Los mensajes cumplen core/prosa en modo estricto.
- La promoción registra versión, compatibilidad y prueba de regresión.