Componer mensaje.
Patrón canónico de componer mensaje 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.
Ver y copiar el código de este render
<form class="ui-sample ui-service" data-compose-message><header><strong>Nuevo mensaje</strong><button class="btn btn--icon" type="button" aria-label="Cerrar borrador">×</button></header><label>Para <input class="input" type="email" value="equipo@example.cl"></label><label>Asunto <input class="input" value="Revisión del documento"></label><label>Mensaje <textarea class="input" rows="4"></textarea></label><footer class="ui-actions"><button class="btn btn--primary" type="submit">Enviar</button><button class="btn btn--secondary" type="button">Programar</button><span>Borrador guardado 18:24 CLT</span></footer></form>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
- Componer mensaje no tiene una implementación vigente demostrada; sus ejemplos son material candidato.
- Cambio propuesto
- Publicar en r19 el contrato de Componer mensaje para Patrón canónico de componer mensaje para cis-admin, cis-infra, cis-inbox, usaia y servicios internos.
- Qué ocurre si respondes No
- Componer mensaje 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.
- 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.
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.
<form class="ui-sample ui-service" data-compose-message><header><strong>Nuevo mensaje</strong><button class="btn btn--icon" type="button" aria-label="Cerrar borrador">×</button></header><label>Para <input class="input" type="email" value="equipo@example.cl"></label><label>Asunto <input class="input" value="Revisión del documento"></label><label>Mensaje <textarea class="input" rows="4"></textarea></label><footer class="ui-actions"><button class="btn btn--primary" type="submit">Enviar</button><button class="btn btn--secondary" type="button">Programar</button><span>Borrador guardado 18:24 CLT</span></footer></form>Código TAILWIND
Copia el bloque completo; después cambia contenido y destinos, no su anatomía.
<form class="ui-sample ui-service border border-slate-300 bg-white p-4 text-slate-950 grid gap-3" data-compose-message><header class="flex flex-wrap items-center justify-between gap-3"><strong>Nuevo mensaje</strong><button class="btn btn--icon border border-slate-950 px-3 py-2 focus-visible:outline-2 focus-visible:outline-offset-2 disabled:cursor-not-allowed" type="button" aria-label="Cerrar borrador">×</button></header><label>Para <input class="input border border-slate-400 bg-white px-3 py-2 focus-visible:outline-2 focus-visible:outline-offset-2" type="email" value="equipo@example.cl"></label><label>Asunto <input class="input border border-slate-400 bg-white px-3 py-2 focus-visible:outline-2 focus-visible:outline-offset-2" value="Revisión del documento"></label><label>Mensaje <textarea class="input border border-slate-400 bg-white px-3 py-2 focus-visible:outline-2 focus-visible:outline-offset-2" rows="4"></textarea></label><footer class="ui-actions flex flex-wrap items-center justify-between gap-3"><button class="btn btn--primary border border-slate-950 px-3 py-2 focus-visible:outline-2 focus-visible:outline-offset-2 disabled:cursor-not-allowed" type="submit">Enviar</button><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">Programar</button><span>Borrador guardado 18:24 CLT</span></footer></form>Código REACT
Copia el bloque completo; después cambia contenido y destinos, no su anatomía.
import type { ChangeEventHandler, FormEventHandler, MouseEventHandler } from "react";
export interface ComposeMessageProps {
title?: string;
/** Nombre accesible del botón que cierra el borrador. */
closeLabel?: string;
onClose?: MouseEventHandler<HTMLButtonElement>;
/** Etiqueta del campo del destinatario. */
toLabel?: string;
/** Nombre del parámetro enviado con el destinatario; sin él, el formulario nativo no envía este campo. */
toName?: string;
/** Destinatario inicial del campo «Para» no controlado. */
defaultTo?: string;
/** Destinatario controlado; va junto con `onToChange`. */
to?: string;
onToChange?: ChangeEventHandler<HTMLInputElement>;
/** Etiqueta del campo del asunto. */
subjectLabel?: string;
/** Nombre del parámetro enviado con el asunto; sin él, el formulario nativo no envía este campo. */
subjectName?: string;
/** Asunto inicial de un campo no controlado. */
defaultSubject?: string;
/** Asunto controlado; va junto con `onSubjectChange`. */
subject?: string;
onSubjectChange?: ChangeEventHandler<HTMLInputElement>;
/** Etiqueta del cuerpo del mensaje. */
messageLabel?: string;
/** Nombre del parámetro enviado con el cuerpo; sin él, el formulario nativo no envía este campo. */
messageName?: string;
/** Texto inicial del cuerpo no controlado. */
defaultMessage?: string;
/** Cuerpo controlado; va junto con `onMessageChange`. */
message?: string;
onMessageChange?: ChangeEventHandler<HTMLTextAreaElement>;
/** Alto visible del cuerpo, en líneas. */
messageRows?: number;
/** Texto del botón que envía el formulario. */
submitLabel?: string;
/** Texto del botón para programar el envío; vacío lo oculta. */
scheduleLabel?: string;
onSchedule?: MouseEventHandler<HTMLButtonElement>;
/** Estado del borrador junto a los botones («Borrador guardado 18:24 CLT»); vacío lo oculta. */
status?: string;
/** URL que recibe el formulario nativo (atributo `action`). */
action?: string;
method?: "get" | "post";
onSubmit?: FormEventHandler<HTMLFormElement>;
className?: string;
}
/**
* Formulario para redactar un mensaje con destinatario, asunto y cuerpo, enviarlo o programar su envío, con el estado del borrador; se usa en bandejas de correo y en la mensajería de un servicio.
*
* Es un `<form>` nativo: para enviarlo sin JavaScript, pasa `action`, `method` y los `name` de cada campo. Cada campo es controlado sólo si llegan su valor y su `onChange` (`to` + `onToChange`, `subject` + `onSubjectChange`, `message` + `onMessageChange`).
*
* @example <ComposeMessage defaultTo="equipo@example.cl" defaultSubject="Revisión del documento" defaultMessage="Adjunto la versión corregida." toName="to" subjectName="subject" messageName="body" action="/mensajes" method="post" />
* @example <ComposeMessage message={cuerpo} onMessageChange={cambiarCuerpo} status="Guardando borrador" onSubmit={enviar} onClose={cerrar} />
*/
export function ComposeMessage({
title = "Nuevo mensaje",
closeLabel = "Cerrar borrador",
onClose,
toLabel = "Para",
toName,
defaultTo = "equipo@example.cl",
to,
onToChange,
subjectLabel = "Asunto",
subjectName,
defaultSubject = "Revisión del documento",
subject,
onSubjectChange,
messageLabel = "Mensaje",
messageName,
defaultMessage = "",
message,
onMessageChange,
messageRows = 4,
submitLabel = "Enviar",
scheduleLabel = "Programar",
onSchedule,
status = "Borrador guardado 18:24 CLT",
action,
method,
onSubmit,
className,
}: ComposeMessageProps) {
const para = to !== undefined && onToChange !== undefined ? { value: to, onChange: onToChange } : { defaultValue: to ?? defaultTo };
const asunto = subject !== undefined && onSubjectChange !== undefined ? { value: subject, onChange: onSubjectChange } : { defaultValue: subject ?? defaultSubject };
const cuerpo = message !== undefined && onMessageChange !== undefined ? { value: message, onChange: onMessageChange } : { defaultValue: message ?? defaultMessage };
return (
<form className={["ui-service", className].filter(Boolean).join(" ")} data-compose-message action={action} method={method} onSubmit={onSubmit}>
<header>
<strong>{title}</strong>
<button className="btn btn--icon" type="button" aria-label={closeLabel} onClick={onClose}>×</button>
</header>
<label>
{`${toLabel} `}
<input className="input" type="email" name={toName} {...para} />
</label>
<label>
{`${subjectLabel} `}
<input className="input" name={subjectName} {...asunto} />
</label>
<label>
{`${messageLabel} `}
<textarea className="input" rows={messageRows} name={messageName} {...cuerpo} />
</label>
<footer className="ui-actions">
<button className="btn btn--primary" type="submit">{submitLabel}</button>
{scheduleLabel ? <button className="btn btn--secondary" type="button" onClick={onSchedule}>{scheduleLabel}</button> : null}
{status ? <span>{status}</span> : null}
</footer>
</form>
);
}