CKTIS / HTML
popovertarget — désigner un popover cible
L’attribut popovertarget relie un bouton à un élément popover au moyen de son id. Il permet d’afficher et de masquer cet élément sans JavaScript.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
popovertarget="popover-id"popovertarget désigne l’élément contrôlé par un button ou un input avec type="button". Un input doit être dans l’état Button : les types submit, reset et image ne prennent donc pas en charge ce mécanisme. Sa valeur est l’id de la cible, sans # ; ce n’est pas un sélecteur CSS. La cible doit avoir un attribut popover et se trouver dans le même arbre.
L’attribut distinct popovertargetaction permet de choisir l’action : toggle inverse la visibilité, show affiche et hide masque. Si la valeur est absente ou invalide, l’action est toggle. À lui seul, popovertarget ne transforme pas la cible en popover.
Utilisez type="button" pour éviter l’envoi du formulaire. Les boutons désactivés et les boutons d’envoi associés à un formulaire ne déclenchent pas ce mécanisme. Il ne fonctionne pas non plus si la cible n’existe pas ou n’a pas d’attribut popover.
Dans la mesure du possible, placez la cible juste après son bouton dans le DOM afin de préserver l’ordre logique de lecture. Dans l’exemple, popover="auto" permet également de fermer le contenu en cliquant à l’extérieur.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Popover target</title>
<button type="button" popovertarget="details">Toggle details</button>
<div id="details" popover="auto">Additional details.</div>
</html>Résultat
Initially: only “Toggle details” is visible. First button activation: “Additional details.” becomes visible. Second activation: it 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.