Acciones masivas.
Patrón canónico de acciones masivas 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
<div class="ui-sample ui-actions ui-bulk-actions" data-selection-count="3"><strong>3 filas seleccionadas</strong><button class="btn btn--secondary" type="button"><svg class="ui-action-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" aria-hidden="true"><path d="M12 3v12M7 10l5 5 5-5M4 20h16"></path></svg><span>Exportar</span></button><button class="btn btn--secondary" type="button"><svg class="ui-action-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" aria-hidden="true"><path d="M4 5h16v14H4zM8 9h8M8 13h5"></path></svg><span>Asignar</span></button><button class="btn btn--destructive" type="button"><svg class="ui-action-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" aria-hidden="true"><path d="M5 7h14M9 7V4h6v3M8 10v7M12 10v7M16 10v7"></path></svg><span>Eliminar</span></button><button class="btn btn--quiet" type="button"><svg class="ui-action-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" aria-hidden="true"><path d="M5 5l14 14M19 5L5 19"></path></svg><span>Cancelar selección</span></button></div>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
- Acciones masivas no tiene una implementación vigente demostrada; sus ejemplos son material candidato.
- Cambio propuesto
- Publicar en r19 el contrato de Acciones masivas para Patrón canónico de acciones masivas para todos los sitios y servicios.
- Qué ocurre si respondes No
- Acciones masivas 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 · core/core-style |
| Consumidores | Todos los sitios y servicios |
| Dependencias | HTML nativo |
| 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 |
|---|
| 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.
<div class="ui-sample ui-actions ui-bulk-actions" data-selection-count="3"><strong>3 filas seleccionadas</strong><button class="btn btn--secondary" type="button"><svg class="ui-action-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" aria-hidden="true"><path d="M12 3v12M7 10l5 5 5-5M4 20h16"></path></svg><span>Exportar</span></button><button class="btn btn--secondary" type="button"><svg class="ui-action-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" aria-hidden="true"><path d="M4 5h16v14H4zM8 9h8M8 13h5"></path></svg><span>Asignar</span></button><button class="btn btn--destructive" type="button"><svg class="ui-action-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" aria-hidden="true"><path d="M5 7h14M9 7V4h6v3M8 10v7M12 10v7M16 10v7"></path></svg><span>Eliminar</span></button><button class="btn btn--quiet" type="button"><svg class="ui-action-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" aria-hidden="true"><path d="M5 5l14 14M19 5L5 19"></path></svg><span>Cancelar selección</span></button></div>Código TAILWIND
Copia el bloque completo; después cambia contenido y destinos, no su anatomía.
<div class="ui-sample ui-actions ui-bulk-actions border border-slate-300 bg-white p-4 text-slate-950" data-selection-count="3"><strong>3 filas seleccionadas</strong><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"><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="M12 3v12M7 10l5 5 5-5M4 20h16"></path></svg><span>Exportar</span></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"><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="M4 5h16v14H4zM8 9h8M8 13h5"></path></svg><span>Asignar</span></button><button class="btn btn--destructive border border-slate-950 px-3 py-2 focus-visible:outline-2 focus-visible:outline-offset-2 disabled:cursor-not-allowed" type="button"><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="M5 7h14M9 7V4h6v3M8 10v7M12 10v7M16 10v7"></path></svg><span>Eliminar</span></button><button class="btn btn--quiet border border-slate-950 px-3 py-2 focus-visible:outline-2 focus-visible:outline-offset-2 disabled:cursor-not-allowed" type="button"><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="M5 5l14 14M19 5L5 19"></path></svg><span>Cancelar selección</span></button></div>Código REACT
Copia el bloque completo; después cambia contenido y destinos, no su anatomía.
import type { MouseEventHandler } from "react";
/** Icono de una acción masiva. */
export type BulkActionsIcon = "export" | "assign" | "delete" | "clear";
export interface BulkActionsItem {
label: string;
/** Icono antes del texto; sin él, el botón lleva sólo el texto. */
icon?: BulkActionsIcon;
/** `destructive` para acciones que borran; `quiet` para salir de la selección. */
tone?: "secondary" | "destructive" | "quiet";
/** Deshabilita la acción cuando no aplica a la selección actual. */
disabled?: boolean;
onClick?: MouseEventHandler<HTMLButtonElement>;
}
export interface BulkActionsProps {
/** Cantidad de filas seleccionadas; va en `data-selection-count` y en el resumen. */
count?: number;
/** Resumen visible de la selección; por defecto «N filas seleccionadas». */
label?: string;
items?: BulkActionsItem[];
className?: string;
}
const ICONOS: Record<BulkActionsIcon, string> = {
export: "M12 3v12M7 10l5 5 5-5M4 20h16",
assign: "M4 5h16v14H4zM8 9h8M8 13h5",
delete: "M5 7h14M9 7V4h6v3M8 10v7M12 10v7M16 10v7",
clear: "M5 5l14 14M19 5L5 19",
};
const ITEMS: BulkActionsItem[] = [
{ label: "Exportar", icon: "export" },
{ label: "Asignar", icon: "assign" },
{ label: "Eliminar", icon: "delete", tone: "destructive" },
{ label: "Cancelar selección", icon: "clear", tone: "quiet" },
];
/**
* Barra de acciones sobre las filas seleccionadas de una tabla o lista, con el conteo de la selección.
*
* Muéstrala sólo cuando hay al menos una fila seleccionada; la acción que borra lleva `tone: "destructive"` y la que sale de la selección, `tone: "quiet"`.
*
* @example <BulkActions count={12} />
* @example <BulkActions count={1} items={[{ label: "Exportar", icon: "export", onClick: exportar }]} />
*/
export function BulkActions({ count = 3, label, items = ITEMS, className }: BulkActionsProps) {
const resumen = label ?? (count === 1 ? "1 fila seleccionada" : `${count} filas seleccionadas`);
if (!resumen && !items.length) return null;
return (
<div className={["ui-actions ui-bulk-actions", className].filter(Boolean).join(" ")} data-selection-count={count}>
{resumen ? <strong>{resumen}</strong> : null}
{items.map((item, i) => (
<button className={`btn btn--${item.tone ?? "secondary"}`} type="button" disabled={item.disabled} onClick={item.onClick} key={`${item.label}-${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>
</button>
))}
</div>
);
}