Modale

Une modale est un <dialog>. N’importe quel bouton dont le commandfor vise l’id de la modale, avec command: 'show-modal', l’ouvre en mode modal : la page derrière devient inerte, le focus et le lecteur d’écran restent donc dedans. Sans le moindre script — le fond, Échap et le clic à l’extérieur sont l’affaire du navigateur.

C’est pourquoi l’id est obligatoire et que le composant lève une erreur sans lui : l’id est tout le câblage.

Modale de base

Chaque modale de cette page s’ouvre vraiment — essayez.

Reconstruire le site ?

Cela lance sitelo build et republie dist/.
fragment(
  button({ commandfor: 'demo-basic', command: 'show-modal' }, 'Ouvrir la modale'),
  modal({ id: 'demo-basic', title: 'Reconstruire le site ?' },
    'Cela lance sitelo build et republie dist/.',
  ),
)

Avec un pied

Un bouton de fermeture est n’importe quel bouton pointant vers le même id avec command: 'close'.

Supprimer cette page ?

C’est irréversible. Le HTML généré disparaît au prochain build.
fragment(
  button({ color: 'danger', commandfor: 'demo-confirm', command: 'show-modal' }, 'Supprimer la page…'),
  modal({
    id: 'demo-confirm',
    title: 'Supprimer cette page ?',
    footer: stack({ direction: 'row', gap: 'sm' },
      button({
        variant: 'ghost',
        color: 'neutral',
        commandfor: 'demo-confirm',
        command: 'close',
      }, 'Annuler'),
      button({ color: 'danger' }, 'Supprimer'),
    ),
  }, 'C’est irréversible. Le HTML généré disparaît au prochain build.'),
)

Tailles

Petite

size: sm — environ 24rem.

Moyenne

Le défaut — environ 32rem.

Grande

size: lg — environ 48rem.
fragment(
  stack({ direction: 'row', gap: 'sm', wrap: true },
    button({ variant: 'outline', color: 'neutral', commandfor: 'demo-sm', command: 'show-modal' }, 'Petite'),
    button({ variant: 'outline', color: 'neutral', commandfor: 'demo-md', command: 'show-modal' }, 'Moyenne'),
    button({ variant: 'outline', color: 'neutral', commandfor: 'demo-lg', command: 'show-modal' }, 'Grande'),
  ),
  modal({ id: 'demo-sm', size: 'sm', title: 'Petite' }, 'size: sm — environ 24rem.'),
  modal({ id: 'demo-md', title: 'Moyenne' }, 'Le défaut — environ 32rem.'),
  modal({ id: 'demo-lg', size: 'lg', title: 'Grande' }, 'size: lg — environ 48rem.'),
)

Des formulaires dans une modale

Nouvelle page

fragment(
  button({ variant: 'soft', commandfor: 'demo-form', command: 'show-modal' }, 'Nouvelle page…'),
  modal({
    id: 'demo-form',
    title: 'Nouvelle page',
    footer: stack({ direction: 'row', gap: 'sm' },
      button({ variant: 'ghost', color: 'neutral', commandfor: 'demo-form', command: 'close' }, 'Annuler'),
      button({ type: 'submit' }, 'Créer'),
    ),
  },
    stack({ gap: 'md' },
      textField({ label: 'Titre', name: 'modal-title', placeholder: 'À propos' }),
      selectField({ label: 'Extension', name: 'modal-ext', options: ['.ht.js', '.ht.ts', '.ht.jsx'] }),
    ),
  ),
)

Sans bouton de fermeture

closable: false retire le × du coin. Échap et le clic à l’extérieur la ferment toujours ; avec closedby: 'closerequest', seul Échap la ferme.

Appuyez sur Échap

Ou cliquez n’importe où en dehors de ce dialogue.
fragment(
  button({ variant: 'outline', color: 'neutral', commandfor: 'demo-bare', command: 'show-modal' }, 'Sans bouton de fermeture'),
  modal({ id: 'demo-bare', title: 'Appuyez sur Échap', closable: false },
    'Ou cliquez n’importe où en dehors de ce dialogue.',
  ),
)

Contenu long

Le corps défile ; l’en-tête et le pied restent en place.

Notes de version

Changement 1 — quelque chose a été corrigé.

Changement 2 — quelque chose a été corrigé.

Changement 3 — quelque chose a été corrigé.

Changement 4 — quelque chose a été corrigé.

Changement 5 — quelque chose a été corrigé.

Changement 6 — quelque chose a été corrigé.

Changement 7 — quelque chose a été corrigé.

Changement 8 — quelque chose a été corrigé.

Changement 9 — quelque chose a été corrigé.

Changement 10 — quelque chose a été corrigé.

Changement 11 — quelque chose a été corrigé.

Changement 12 — quelque chose a été corrigé.

fragment(
  button({ variant: 'outline', color: 'neutral', commandfor: 'demo-long', command: 'show-modal' }, 'Modale longue'),
  modal({
    id: 'demo-long',
    title: 'Notes de version',
    footer: button({ commandfor: 'demo-long', command: 'close' }, 'Fermer'),
  },
    stack({ gap: 'md' },
      ...Array.from({ length: 12 }, (unused, index) =>
        text({ variant: 'small', tone: 'muted' }, 'Changement ' + (index + 1) + ' — quelque chose a été corrigé.'),
      ),
    ),
  ),
)

Défilement de l’arrière-plan

La page derrière une modale ouverte ne défile pas. C’est la seule chose qu’un dialogue modal vous laisse, et elle est faite en CSS ici — aucun script, rien à initialiser. Passez lockScroll: false pour laisser l’arrière-plan défiler comme d’habitude.

Prise en charge des navigateurs

Ouvrir un dialogue depuis le command d’un bouton fonctionne dans tous les navigateurs actuels — Chrome 135, Firefox 144 et Safari 26.2 ou plus récents. Dans un plus ancien, button() ajoute un onclick qui charge quelques centaines d’octets de /su/dialog.js pour faire de même — là seulement, et au premier clic. Safari ne ferme pas encore un dialogue au clic extérieur (closedby) ; le même fichier s’en charge aussi.

Props

PropTypeDéfautDescription
idstring—Obligatoire. Ce que vise le commandfor d’un déclencheur.
titleChild—Titre, et nom accessible du dialogue.
size'sm' | 'md' | 'lg''md'Largeur maximale.
footerChild—Rangée du bas, sur sa propre bande teintée.
closablebooleantrueAfficher le × dans l’en-tête.
closeLabelstring'Close'Nom accessible de ce bouton.
lockScrollbooleantrueEmpêcher la page derrière de défiler tant qu’elle est ouverte.

closeButton({ target }) rend ce × tout seul, pour un en-tête que vous construisez vous-même.