CKTIS / HTML
L’attribut popover
L’attribut global `popover` crée un panneau initialement masqué, affiché au-dessus du contenu de la page. Ses valeurs `auto`, `manual` et `hint` déterminent comment le panneau se ferme.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
popover | popover="" | popover="auto" | popover="manual" | popover="hint"popover est un attribut global à valeurs énumérées, et non un attribut booléen. Le panneau est masqué au départ ; lorsqu’il s’ouvre, il rejoint la couche supérieure (top layer). En l’absence de l’attribut, l’élément reste ordinaire. La forme popover seule ou popover="" sélectionne auto ; une valeur non valide, y compris popover="false", sélectionne manual au lieu de désactiver la fonctionnalité.
auto ferme les autres popovers automatiques, à l’exception des popovers ancêtres appropriés. L’ouverture d’un popover hint peut fermer d’autres popovers hint tout en laissant les ancêtres concernés ouverts. Si le popover hint a un ancêtre auto ouvert, son ouverture peut aussi fermer les popovers auto situés au-dessus de cet ancêtre dans la pile. Les deux modes prennent en charge la fermeture par clic à l’extérieur et les demandes de fermeture, généralement avec Échap. manual ne ferme pas les autres popovers et ne réagit pas à ces mécanismes de fermeture.
Le popovertarget d’un bouton fait référence à l’id du panneau ; son action par défaut en bascule la visibilité. popovertargetaction="hide" le ferme explicitement. JavaScript fournit également showPopover(), hidePopover() et togglePopover(). Si possible, placez le panneau juste après son déclencheur dans le DOM afin de préserver un ordre de lecture logique. L’attribut ne remplace pas les sémantiques d’accessibilité adaptées au contenu.
Exemples
<!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>Résultat
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.
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.