Verificación de correo.
Patrón canónico de verificación de correo para cuenta, admin, usaia, firmas y documentos.
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-auth-status ui-auth-status--success" data-auth-source="cis-auth-authentik" data-email-verification role="status"><span class="ui-auth-status__symbol" aria-hidden="true">✓</span><div><h3>Revisa tu correo</h3><p>Enviamos un enlace a martin@example.cl. Puedes cerrar esta ventana.</p><div class="ui-actions"><button class="btn btn--secondary" type="button">Enviar otro enlace</button><a class="btn btn--quiet" href="#correo">Cambiar correo</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
Círculo de Santiago
Autoridad: core-style/DECISIONES.md M10 y LOGOS-CANONICOS.mdCambia en esta marca
- Mark circular y namebrand Círculo de Santiago en caja normal
- Contenido societario y navegación propia
Permanece canónico
- Misma estructura, orden de cuenta y footer
- Tipografía, foco y comportamiento canónicos
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
- Verificación de correo no tiene una implementación vigente demostrada; sus ejemplos son material candidato.
- Cambio propuesto
- Publicar en r19 el contrato de Verificación de correo para Patrón canónico de verificación de correo para cuenta, admin, usaia, firmas y documentos.
- Qué ocurre si respondes No
- Verificación de correo 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.
- 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 y cis-auth · core/core-style |
| Consumidores | Cuenta, Admin, usaia, Firmas y Documentos |
| Dependencias | HTML nativo, validación de servidor |
| 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 |
|---|
| vacío |
| completo |
| inválido |
| disabled |
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-auth-status ui-auth-status--success" data-auth-source="cis-auth-authentik" data-email-verification role="status"><span class="ui-auth-status__symbol" aria-hidden="true">✓</span><div><h3>Revisa tu correo</h3><p>Enviamos un enlace a martin@example.cl. Puedes cerrar esta ventana.</p><div class="ui-actions"><button class="btn btn--secondary" type="button">Enviar otro enlace</button><a class="btn btn--quiet" href="#correo">Cambiar correo</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-auth-status ui-auth-status--success border border-slate-300 bg-white p-4 text-slate-950 grid gap-3" data-auth-source="cis-auth-authentik" data-email-verification role="status"><span class="ui-auth-status__symbol" aria-hidden="true">✓</span><div><h3>Revisa tu correo</h3><p>Enviamos un enlace a martin@example.cl. Puedes cerrar esta ventana.</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">Enviar otro enlace</button><a class="btn btn--quiet underline underline-offset-4" href="#correo">Cambiar correo</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 type EmailVerificationTone = "progress" | "success" | "warning" | "error";
export interface EmailVerificationProps {
/** Tono del aviso: `success` con el enlace enviado, `error` si el enlace venció. Define el símbolo. */
tone?: EmailVerificationTone;
title?: string;
/** Qué pasó con el enlace y qué hacer ahora. */
description?: string;
/** Texto del botón que pide otro enlace. */
resendLabel?: string;
onResend?: MouseEventHandler<HTMLButtonElement>;
/** Texto del enlace para corregir la dirección de correo. */
changeEmailLabel?: string;
changeEmailHref?: string;
className?: string;
}
const EMAIL_VERIFICATION_SYMBOLS: Record<EmailVerificationTone, string> = {
progress: "↻",
success: "✓",
warning: "i",
error: "!",
};
/**
* Aviso de verificación de correo, para después del registro: confirma el envío del enlace o informa que venció.
*
* Usa `role="status"`. El símbolo sigue al tono. Si ambas acciones van vacías, no se muestra la fila de acciones.
*
* @example <EmailVerification description="Enviamos un enlace a ana@example.cl. Puedes cerrar esta ventana." onResend={reenviar} />
* @example <EmailVerification tone="error" title="El enlace venció" description="Solicita uno nuevo para completar el registro." />
*/
export function EmailVerification({
tone = "success",
title = "Revisa tu correo",
description = "Enviamos un enlace a martin@example.cl. Puedes cerrar esta ventana.",
resendLabel = "Enviar otro enlace",
onResend,
changeEmailLabel = "Cambiar correo",
changeEmailHref = "#correo",
className,
}: EmailVerificationProps) {
return (
<section
className={["ui-auth-status", `ui-auth-status--${tone}`, className].filter(Boolean).join(" ")}
data-auth-source="cis-auth-authentik"
data-email-verification
role="status"
>
<span className="ui-auth-status__symbol" aria-hidden="true">{EMAIL_VERIFICATION_SYMBOLS[tone]}</span>
<div>
<h3>{title}</h3>
{description ? <p>{description}</p> : null}
{resendLabel || changeEmailLabel ? (
<div className="ui-actions">
{resendLabel ? <button className="btn btn--secondary" type="button" onClick={onResend}>{resendLabel}</button> : null}
{changeEmailLabel ? <a className="btn btn--quiet" href={changeEmailHref}>{changeEmailLabel}</a> : null}
</div>
) : null}
</div>
</section>
);
}