Modale
In questa pagina
Un modale è un <dialog>. Qualunque pulsante con commandfor che punta all’id del modale e command: 'show-modal' lo apre in modo modale: la pagina dietro diventa inerte, quindi focus e lettore di schermo restano dentro. Nessuno script da nessuna parte — sfondo, Escape e clic fuori sono tutti compito del browser.
È per questo che id è obbligatorio e che il componente solleva un errore senza — l’id è tutto il collegamento.
Modale di base
Ogni modale di questa pagina si apre davvero — provalo.
fragment(
button({ commandfor: 'demo-basic', command: 'show-modal' }, 'Apri il modale'),
modal({ id: 'demo-basic', title: 'Ricostruire il sito?' },
'Esegue sitelo build e ripubblica dist/.',
),
)Con un piè di pagina
Un pulsante di chiusura è un qualunque pulsante che punta allo stesso id con command: 'close'.
fragment(
button({ color: 'danger', commandfor: 'demo-confirm', command: 'show-modal' }, 'Elimina la pagina…'),
modal({
id: 'demo-confirm',
title: 'Eliminare questa pagina?',
footer: stack({ direction: 'row', gap: 'sm' },
button({
variant: 'ghost',
color: 'neutral',
commandfor: 'demo-confirm',
command: 'close',
}, 'Annulla'),
button({ color: 'danger' }, 'Elimina'),
),
}, 'Non si può annullare. L’HTML generato viene rimosso alla prossima build.'),
)Dimensioni
fragment(
stack({ direction: 'row', gap: 'sm', wrap: true },
button({ variant: 'outline', color: 'neutral', commandfor: 'demo-sm', command: 'show-modal' }, 'Piccolo'),
button({ variant: 'outline', color: 'neutral', commandfor: 'demo-md', command: 'show-modal' }, 'Medio'),
button({ variant: 'outline', color: 'neutral', commandfor: 'demo-lg', command: 'show-modal' }, 'Grande'),
),
modal({ id: 'demo-sm', size: 'sm', title: 'Piccolo' }, 'size: sm — circa 24rem.'),
modal({ id: 'demo-md', title: 'Medio' }, 'Il predefinito — circa 32rem.'),
modal({ id: 'demo-lg', size: 'lg', title: 'Grande' }, 'size: lg — circa 48rem.'),
)Form dentro un modale
fragment(
button({ variant: 'soft', commandfor: 'demo-form', command: 'show-modal' }, 'Nuova pagina…'),
modal({
id: 'demo-form',
title: 'Nuova pagina',
footer: stack({ direction: 'row', gap: 'sm' },
button({ variant: 'ghost', color: 'neutral', commandfor: 'demo-form', command: 'close' }, 'Annulla'),
button({ type: 'submit' }, 'Crea'),
),
},
stack({ gap: 'md' },
textField({ label: 'Titolo', name: 'modal-title', placeholder: 'Informazioni' }),
selectField({ label: 'Estensione', name: 'modal-ext', options: ['.ht.js', '.ht.ts', '.ht.jsx'] }),
),
),
)Senza pulsante di chiusura
closable: false toglie la × nell’angolo. Escape e il clic fuori lo chiudono comunque; con closedby: 'closerequest' lo chiude solo Escape.
fragment(
button({ variant: 'outline', color: 'neutral', commandfor: 'demo-bare', command: 'show-modal' }, 'Nessun pulsante di chiusura'),
modal({ id: 'demo-bare', title: 'Premi Escape', closable: false },
'Oppure clicca in un punto qualsiasi fuori da questa finestra.',
),
)Contenuto lungo
Il corpo scorre; intestazione e piè di pagina restano fermi.
fragment(
button({ variant: 'outline', color: 'neutral', commandfor: 'demo-long', command: 'show-modal' }, 'Modale lungo'),
modal({
id: 'demo-long',
title: 'Note di rilascio',
footer: button({ commandfor: 'demo-long', command: 'close' }, 'Chiudi'),
},
stack({ gap: 'md' },
...Array.from({ length: 12 }, (unused, index) =>
text({ variant: 'small', tone: 'muted' }, 'Modifica ' + (index + 1) + ' — qualcosa è stato corretto.'),
),
),
),
)Scorrimento dello sfondo
La pagina dietro un modale aperto non scorre. È l’unica cosa che una finestra di dialogo modale lascia a te, e qui è fatta in CSS — nessuno script, e niente da inizializzare. Passa lockScroll: false per lasciare che lo sfondo scorra come al solito.
Supporto dei browser
Aprire una finestra di dialogo con il command di un pulsante funziona in tutti i browser attuali — Chrome 135, Firefox 144 e Safari 26.2 o successivi. In uno più vecchio, button() aggiunge un onclick che carica qualche centinaio di byte di /su/dialog.js per fare lo stesso — solo lì, e solo al primo clic. Safari non chiude ancora una finestra di dialogo al clic fuori (closedby), e lì se ne occupa lo stesso file.
Props
| Prop | Tipo | Predefinito | Descrizione |
|---|---|---|---|
id | string | — | Obbligatorio. Ciò a cui punta il commandfor di un innesco. |
title | Child | — | Intestazione, e nome accessibile della finestra di dialogo. |
size | 'sm' | 'md' | 'lg' | 'md' | Larghezza massima. |
footer | Child | — | Riga in fondo, su una fascia tinta a sé. |
closable | boolean | true | Mostra la × nell’intestazione. |
closeLabel | string | 'Close' | Nome accessibile di quel pulsante. |
lockScroll | boolean | true | Impedisce alla pagina dietro di scorrere mentre è aperto. |
closeButton({ target }) renderizza quella × da sola, per un’intestazione che costruisci tu.