Communitygithub.com

YepAPI/habilidades

Diálogos de Radix/shadcn, cuadros de diálogo de confirmación, hojas deslizables para móvil, foco atrapado, bloqueo de desplazamiento y soporte para diálogos anidados.

¿Qué es habilidades?

Este skill proporciona reglas y patrones para implementar modales y diálogos accesibles y robustos en aplicaciones React usando las bibliotecas Radix UI y shadcn/ui. Está diseñado para desarrolladores que trabajan con frameworks como React, Next.js o cualquier ecosistema que soporte Radix. La habilidad estandariza el uso de componentes como `<Dialog>`, `<AlertDialog>` y `<Sheet>`, garantizando que todos los modales cumplan con buenas prácticas de accesibilidad: foco atrapado automático, bloqueo del desplazamiento del body, cierre con tecla Escape y clic fuera del overlay, y soporte para formularios dentro de diálogos sin cerrar en validación fallida. También incluye recomendaciones específicas para dispositivos móviles, como el uso de `<Sheet>` en lugar de diálogos centrados, y patrones de estado controlado (`open` + `onOpenChange`) para evitar dependencias de estado interno. El objetivo es evitar implementaciones personalizadas frágiles y garantizar una experiencia de usuario consistente y accesible en todos los tamaños de pantalla.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YepAPI/skills/tree/HEAD/skills/modals-dialogs

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Modales y Diálogos

Reglas

  • Usa el Dialog de Radix o <Dialog> de shadcn — accesible, con foco atrapado y bloqueo de desplazamiento por defecto
  • Cuadros de diálogo de confirmación para acciones destructivas: "¿Eliminar este proyecto?" con botones Cancelar (secundario) y Eliminar (destructivo)
  • Hojas/paneles deslizables para móvil: <Sheet> de shadcn — se desliza desde abajo o desde un lado, mejor objetivo táctil que los modales centrados
  • Foco atrapado: Radix lo maneja automáticamente — el primer elemento enfocable recibe el foco al abrir, y lo devuelve al cerrar
  • Bloqueo de desplazamiento: evita el desplazamiento del body cuando el modal está abierto — Radix lo maneja con <Dialog.Overlay>
  • Disparadores de cierre: tecla Escape, clic fuera del overlay, botón de cierre explícito — todos proporcionados por Radix
  • Estado controlado: props open + onOpenChange — no confíes en el estado interno para modales activados por eventos externos
  • Formularios en diálogos: enviar con Enter, cerrar al tener éxito, mostrar errores en línea — no cerrar en caso de fallo de validación
  • Móvil: usa <Sheet> (panel inferior) en lugar de <Dialog> centrado para acciones en pantallas pequeñas

Patrones

// Cuadro de diálogo de confirmación con shadcn
import {
  AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent,
  AlertDialogDescription, AlertDialogFooter, AlertDialogHeader,
  AlertDialogTitle, AlertDialogTrigger,
} from "@/components/ui/alert-dialog";

function BotonEliminar({ onDelete }: { onDelete: () => Promise<void> }) {
  const [cargando, setCargando] = useState(false);
  return (
    <AlertDialog>
      <AlertDialogTrigger asChild>
        <Button variant="destructive">Eliminar proyecto</Button>
      </AlertDialogTrigger>
      <AlertDialogContent>
        <AlertDialogHeader>
          <AlertDialogTitle>¿Eliminar este proyecto?</AlertDialogTitle>
          <AlertDialogDescription>
            Esto eliminará permanentemente el proyecto y todos sus datos. Esta acción no se puede deshacer.
          </AlertDialogDescription>
        </AlertDialogHeader>
        <AlertDialogFooter>
          <AlertDialogCancel>Cancelar</AlertDialogCancel>
          <AlertDialogAction
            onClick={async () => { setCargando(true); await onDelete(); setCargando(false); }}
            disabled={cargando}
          >
            {cargando ? "Eliminando..." : "Eliminar"}
          </AlertDialogAction>
        </AlertDialogFooter>
      </AlertDialogContent>
    </AlertDialog>
  );
}

// Hoja deslizable para acciones amigables en móvil
import { Sheet, SheetContent, SheetHeader, SheetTitle, SheetTrigger } from "@/components/ui/sheet";

function MenuMovil() {
  return (
    <Sheet>
      <SheetTrigger asChild><Button variant="ghost" size="icon"><IconoMenu /></Button></SheetTrigger>
      <SheetContent side="bottom">
        <SheetHeader><SheetTitle>Acciones</SheetTitle></SheetHeader>
        <nav className="flex flex-col gap-2 py-4">
          <Button variant="ghost">Editar</Button>
          <Button variant="ghost">Compartir</Button>
          <Button variant="destructive">Eliminar</Button>
        </nav>
      </SheetContent>
    </Sheet>
  );
}

Evita

  • Construir modales personalizados con position: fixed y gestión manual del foco — usa Dialog de Radix/shadcn
  • Omitir la tecla Escape y el cierre al hacer clic fuera — Radix maneja ambos, no los sobrescribas
  • Modales centrados en móvil para menús de acciones — usa Sheet/Drawer inferior para mejor alcance del pulgar
  • Cerrar el diálogo al fallar la validación de un formulario — manténlo abierto, muestra errores en línea, deja que el usuario corrija y reenvíe
  • Diálogos anidados sin contexto de apilamiento adecuado — si son necesarios, usa el soporte de diálogos anidados de Radix con un z-index apropiado

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

YepAPI/skills

WCAG 2.1 AA — semantic HTML, keyboard navigation, screen readers.

YepAPI/skills

Experiment setup, variant splitting, statistical significance, and feature flag integration.

YepAPI/skills

CRUD generators, data tables, user management, role-based access, and bulk operations.

YepAPI/skills

Monitor what ChatGPT and Gemini say about your brand using YepAPI.

YepAPI/skills

Queue workers with BullMQ/Inngest/Trigger.dev, job retries, dead letter queues, concurrency.

YepAPI/skills

Commander.js, interactive prompts with Clack, spinners, colors, config files, exit codes, and npm publishing.

YepAPI/skills

cmdk integration, Cmd+K trigger, fuzzy search, grouped actions, keyboard navigation, and dynamic action registration.

YepAPI/skills

Content planning with trend and sentiment data from YepAPI.

YepAPI/skills

Content calendar, keyword-driven planning, and content briefs.

YepAPI/skills

Theme switching with CSS variables, system preference detection, next-themes, and persistence.

YepAPI/skills

Threaded comments, @mentions, reactions, moderation queue, optimistic UI, and cursor pagination.

YepAPI/skills

Competitive analysis between domains using YepAPI.

YepAPI/skills

Layout grids, KPI cards, data tables with sorting/filtering, sidebar navigation, and responsive breakpoints.

YepAPI/skills

Data encryption — TLS everywhere, AES-256-GCM for PII, bcrypt passwords, encrypted backups.

YepAPI/skills

Chart patterns with Recharts/Nivo/D3, responsive containers, color scales, and accessibility.

YepAPI/skills

Drizzle schema definition, push vs migrate, type-safe queries, relations, transactions, and prepared statements.

YepAPI/skills

Upload handling, resize/compress, CDN delivery, blur placeholders, and next/image patterns.

YepAPI/skills

Local business and Google Maps research using YepAPI.

YepAPI/skills

Cursor-based pagination, IntersectionObserver, virtualized lists with @tanstack/react-virtual, and scroll position restoration.

YepAPI/skills

Chat UI components, streaming responses with AI SDK, context window management, and RAG patterns.

Skills relacionados