Saltar al contenido
Índice de Kit UI
Kit UI Componentes

Compartir.

Patrón canónico de compartir para todos los sitios y servicios.

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
HTML del nivel canónico
<nav class="ui-sample ui-actions ui-share-actions" aria-label="Compartir"><a class="btn btn--secondary" href="mailto:?subject=Serie%20COCHID"><svg class="ui-action-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" aria-hidden="true"><path d="M3 5h18v14H3zM3 6l9 7 9-7"></path></svg><span>Correo</span></a><a class="btn btn--secondary" href="#copiar-enlace"><svg class="ui-action-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" aria-hidden="true"><path d="M9 15l6-6M7 17H5a4 4 0 010-8h4M17 7h2a4 4 0 010 8h-4"></path></svg><span>Copiar enlace</span></a><a class="btn btn--secondary" href="#insertar"><svg class="ui-action-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" aria-hidden="true"><path d="M8 7l-5 5 5 5M16 7l5 5-5 5M14 4l-4 16"></path></svg><span>Insertar</span></a></nav>

Variaciones por marca y sitio

Cada cambio visible declara su autoridad; lo que permanece canónico no se vuelve a inventar en el producto.

innovacionsantiago.cl

Compañía de Innovación de Santiago

Autoridad: CONSTITUTION.md + LOGOS-CANONICOS.md

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
circulodesantiago.cl

Círculo de Santiago

Autoridad: core-style/DECISIONES.md M10 y LOGOS-CANONICOS.md

Cambia 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
Compartir tiene 1 implementaciones observadas en 1 repositorios: cds/cis/periodismo2-frontend.
Cambio propuesto
Publicar en r19 el contrato de Compartir para Patrón canónico de compartir para todos los sitios y servicios.
Qué ocurre si respondes No
No se adopta el contrato r19 de Compartir; las 1 implementaciones observadas permanecen sin migración.

Preparando comparación histórica…

Antes / r19

La comparación convierte una regla abstracta en una diferencia visible y verificable.

r19 · correctoContrato canónico renderizado
  • Usa HTML semántico, foco visible y estados explícitos.
  • Conserva contenido útil a 320 px y sin JavaScript.
Antes · problema observadoAnti-ejemplo no interactivo
OKContinuarEnviar
  • 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.

320 pxMóvil y zoom
1280 pxEscritorio

Cobertura

DimensiónContrato
Propietario canónicoSistema de diseño CIS · core/core-style
ConsumidoresTodos los sitios y servicios
DependenciasHTML nativo
Estadocandidato

Evidencia de adopción

Patrón observado. 1 implementaciones observadas en 1 repositorios.

La observación demuestra uso existente; la aceptación canónica sigue dependiendo de esta ficha y de su propietario.

DatoResultado
ClasificaciónPatrón observado
Implementaciones1 implementaciones observadas
Repositorioscds/cis/periodismo2-frontend
Snapshotkit/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
base
hover
focus
disabled
loading

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.

Código de referencia
<nav class="ui-sample ui-actions ui-share-actions" aria-label="Compartir"><a class="btn btn--secondary" href="mailto:?subject=Serie%20COCHID"><svg class="ui-action-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" aria-hidden="true"><path d="M3 5h18v14H3zM3 6l9 7 9-7"></path></svg><span>Correo</span></a><a class="btn btn--secondary" href="#copiar-enlace"><svg class="ui-action-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" aria-hidden="true"><path d="M9 15l6-6M7 17H5a4 4 0 010-8h4M17 7h2a4 4 0 010 8h-4"></path></svg><span>Copiar enlace</span></a><a class="btn btn--secondary" href="#insertar"><svg class="ui-action-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" aria-hidden="true"><path d="M8 7l-5 5 5 5M16 7l5 5-5 5M14 4l-4 16"></path></svg><span>Insertar</span></a></nav>

Código TAILWIND

Copia el bloque completo; después cambia contenido y destinos, no su anatomía.

Código de referencia
<nav class="ui-sample ui-actions ui-share-actions border border-slate-300 bg-white p-4 text-slate-950 flex flex-wrap items-center gap-3" aria-label="Compartir"><a class="btn btn--secondary underline underline-offset-4" href="mailto:?subject=Serie%20COCHID"><svg class="ui-action-icon h-auto w-full" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" aria-hidden="true"><path d="M3 5h18v14H3zM3 6l9 7 9-7"></path></svg><span>Correo</span></a><a class="btn btn--secondary underline underline-offset-4" href="#copiar-enlace"><svg class="ui-action-icon h-auto w-full" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" aria-hidden="true"><path d="M9 15l6-6M7 17H5a4 4 0 010-8h4M17 7h2a4 4 0 010 8h-4"></path></svg><span>Copiar enlace</span></a><a class="btn btn--secondary underline underline-offset-4" href="#insertar"><svg class="ui-action-icon h-auto w-full" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" aria-hidden="true"><path d="M8 7l-5 5 5 5M16 7l5 5-5 5M14 4l-4 16"></path></svg><span>Insertar</span></a></nav>

Código REACT

Copia el bloque completo; después cambia contenido y destinos, no su anatomía.

Código de referencia
import type { MouseEventHandler } from "react";

/** Icono de una acción de compartir: correo, copiar enlace o insertar. */
export type ShareActionsIcon = "mail" | "link" | "embed";

export interface ShareActionsItem {
  label: string;
  /** Destino del enlace: `mailto:`, un ancla o una URL. */
  href: string;
  /** Icono antes del texto; sin él, el enlace lleva sólo el texto. */
  icon?: ShareActionsIcon;
  onClick?: MouseEventHandler<HTMLAnchorElement>;
}

export interface ShareActionsProps {
  /** Nombre accesible del grupo (`aria-label` del `<nav>`). */
  label?: string;
  items?: ShareActionsItem[];
  /** Mensaje de la región `role="status"`, como «Enlace copiado». Pasa `""` mientras no hay mensaje para que la región exista antes del anuncio; sin la prop, no se emite. */
  status?: string;
  className?: string;
}

const ICONOS: Record<ShareActionsIcon, string> = {
  mail: "M3 5h18v14H3zM3 6l9 7 9-7",
  link: "M9 15l6-6M7 17H5a4 4 0 010-8h4M17 7h2a4 4 0 010 8h-4",
  embed: "M8 7l-5 5 5 5M16 7l5 5-5 5M14 4l-4 16",
};

const ITEMS: ShareActionsItem[] = [
  { label: "Correo", href: "mailto:?subject=Serie%20COCHID", icon: "mail" },
  { label: "Copiar enlace", href: "#copiar-enlace", icon: "link" },
  { label: "Insertar", href: "#insertar", icon: "embed" },
];

/**
 * Grupo de enlaces para compartir una página o un recurso por correo, enlace copiado o código para insertar.
 *
 * Cada acción es un `<a>` y funciona sin JavaScript; `status` confirma una acción que corre en el navegador, como copiar el enlace.
 *
 * @example <ShareActions items={[{ label: "Correo", href: "mailto:?subject=Serie%20COCHID", icon: "mail" }]} />
 * @example <ShareActions status="Enlace copiado" />
 */
export function ShareActions({ label = "Compartir", items = ITEMS, status, className }: ShareActionsProps) {
  if (!items.length && status === undefined) return null;
  return (
    <nav className={["ui-actions ui-share-actions", className].filter(Boolean).join(" ")} aria-label={label}>
      {items.map((item, i) => (
        <a className="btn btn--secondary" href={item.href} onClick={item.onClick} key={`${item.href}-${i}`}>
          {item.icon ? (
            <svg className="ui-action-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.8" aria-hidden="true"><path d={ICONOS[item.icon]}></path></svg>
          ) : null}
          <span>{item.label}</span>
        </a>
      ))}
      {status !== undefined ? <span role="status">{status}</span> : null}
    </nav>
  );
}