CKTIS / HTML
L’attributo popover
L’attributo globale `popover` crea un pannello inizialmente nascosto, visualizzato sopra il contenuto della pagina. I valori `auto`, `manual` e `hint` ne determinano le modalità di chiusura.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
popover | popover="" | popover="auto" | popover="manual" | popover="hint"popover è un attributo globale enumerato, non un attributo booleano. Il pannello è inizialmente nascosto; quando viene aperto, entra nel livello superiore (top layer). Se l’attributo è omesso, l’elemento resta ordinario. popover senza valore o popover="" seleziona auto; un valore non valido, incluso popover="false", seleziona manual invece di disattivare la funzionalità.
auto chiude gli altri popover automatici, tranne gli eventuali popover antenati appropriati. L’apertura di un popover hint può chiudere altri popover hint lasciando aperti gli antenati pertinenti. Se il popover hint ha un antenato auto aperto, la sua apertura può anche chiudere i popover auto che si trovano sopra quell’antenato nella pila. Entrambe le modalità supportano la chiusura con un clic all’esterno e le richieste di chiusura, di solito tramite Escape. manual non chiude gli altri popover e non reagisce a questi meccanismi di chiusura.
Il popovertarget di un pulsante fa riferimento all’id del pannello; l’azione predefinita ne alterna la visibilità. popovertargetaction="hide" lo chiude esplicitamente. JavaScript offre anche showPopover(), hidePopover() e togglePopover(). Quando possibile, posiziona il pannello subito dopo il relativo attivatore nel DOM, così da mantenere un ordine di lettura logico. L’attributo non sostituisce le semantiche di accessibilità adatte al contenuto.
Esempi
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Popover example</title>
<button type="button" popovertarget="help">Help</button>
<div id="help" popover="auto">
Settings are saved automatically.
<button type="button" popovertarget="help" popovertargetaction="hide">Close</button>
</div>
</html>Risultato
Initially: Help is visible; the popover is hidden. Activate Help: Settings are saved automatically. and Close become visible. Activate Close: the popover is hidden again.
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.