menuDocumentationexpand_more

Modal — Dialog Popup

Button que abre un modal dialog con contenido.

Sintaxis

:::modal {title="My Modal" label="Open Modal" icon="open_in_new"}
Modal content here with **markdown** support.
:::

Props

PropTipoDefaultDescripción
titlestring'Modal'Título del dialog
labelstringtitle o 'Open'Texto del button
iconstringMaterial icon para button
classstringClases button (con smart detection)
stylestringCSS inline
idstringPara tracking de estado modal

Rendering

  • Base UI Dialog.Root — portal, focus trap, a11y
  • Backdrop: bg-black/60
  • Popup: rounded-3xl, max-w-3xl, max-h-[85vh]
  • Body scrollable
  • Close button (X) en header

Smart Detection

Mismo sistema que Button (ver [directive-button.md]):

DetecciónRegexDefault omitido
Tamaño`/\btext-(xs\sm\base\lg\xl\[2-9]xl)\b/`text-sm
Display`/\b(flex\inline-flex\block\grid\hidden)\b/`inline-flex

Position Shorthands

ShorthandResultado
#lefttext-left
#centertext-center
#righttext-right

Limitaciones

  • No anidar modales dentro de modales
  • Contenido crítico no debe estar SOLO en modales
  • El contenido del modal soporta markdown completo, listas, tablas, y directivas anidadas
  • State tracking via id — múltiples modales se coordinan via modals state en RenderContext