Modal
Un modal es una superficie centrada que aparece sobre la página y bloquea la interacción con el contenido detrás. Se usa para tareas focalizadas o decisiones que requieren atención inmediata.
Uso
Cuándo usar modal
- La tarea es corta, focalizada y se completa sin perder el contexto principal.
- La acción requiere confirmación explícita antes de continuar.
- La decisión es irreversible o tiene consecuencias importantes.
Cuándo evitarlo
- Para mensajes pasajeros: usa toast.
- Para información contextual no esencial: usa popover o tooltip.
- Para tareas largas o flujos de varios pasos que se benefician de la página completa: navega a una vista dedicada.
Estructura
Título, contenido, acciones
Un modal tiene tres regiones claras: un título breve que nombra la decisión, un contenido que explica las consecuencias y un set de acciones al pie. Mantén ese orden de lectura.
Botones
Reglas de posición
En Lexy los botones de un modal viven siempre en la parte inferior. La posición concreta depende de cuántos haya y de qué función cumplan:
- Un botón neutral (un simple acuse de recibo): centrado al pie.
- Un botón de avance o confirmación: alineado a la derecha del pie.
- Dos botones: en esquinas opuestas. Cancelar a la izquierda, primario a la derecha.
- Tres o más botones: no hay una posición determinada, el grupo se acomoda según el flujo y la jerarquía visual.
Un solo botón, centrado
Cuando el modal solo informa o pide un acuse de recibo, el botón se centra al pie. El usuario no decide, solo confirma haber leído.
Tus cambios se guardaron correctamente.
Un solo botón, a la derecha
Cuando el botón único hace avanzar el flujo (continuar, enviar, finalizar), se alinea a la derecha del pie del modal.
Revisa los datos antes de continuar con el envío.
Dos botones, en esquinas opuestas
Con dos acciones, cada una ocupa una esquina del pie. La acción de cancelar queda a la izquierda y la primaria a la derecha, separadas para evitar clics accidentales.
Descripción breve del modal y de lo que va a ocurrir al confirmar.
Varios botones, sin posición fija
Si el modal expone tres o más acciones, no hay una regla única de posición. Agrupa por jerarquía y deja que el diseño del contenido guíe la composición.
Puedes guardar como borrador, previsualizar o publicar ahora.
Variantes
Destructivo
Cuando la acción borra, elimina o revierte algo de forma irreversible, el modal debe nombrar la consecuencia con precisión. El botón primario mantiene el mismo verbo del título.
Accesibilidad
Foco y teclado
- Al abrirse, el foco se mueve al primer control interactivo del modal.
- El foco queda atrapado dentro del modal hasta que se cierra.
- Esc cierra el modal y devuelve el foco al elemento que lo abrió.
Etiquetas
- El modal se anuncia con role="dialog" y aria-labelledby apuntando al título.
- Si el contenido necesita contexto adicional, usa aria-describedby.
- Evita superficies modales encadenadas: un modal sobre otro confunde el foco y la jerarquía.
Contenido
Título y descripción
- El título es una afirmación corta sobre la decisión, no una pregunta.
- El contenido explica qué pasará y, si aplica, cómo se puede revertir.
- Si la acción no se puede deshacer, dilo explícitamente.