CKTIS / HTML
Het popover-attribuut
Het globale attribuut `popover` maakt een paneel dat aanvankelijk verborgen is en boven de pagina-inhoud wordt weergegeven. De waarden `auto`, `manual` en `hint` bepalen hoe het paneel wordt gesloten.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
popover | popover="" | popover="auto" | popover="manual" | popover="hint"popover is een globaal enumeratieattribuut, geen booleaans attribuut. Het paneel is aanvankelijk verborgen; wanneer het wordt geopend, komt het in de bovenste laag (top layer). Zonder het attribuut blijft het een gewoon element. Alleen popover of popover="" kiest auto; een ongeldige waarde, waaronder popover="false", kiest manual in plaats van de functie uit te schakelen.
auto sluit andere automatische popovers, behalve geschikte bovenliggende popovers. Bij het openen van een hint-popover kunnen andere hint-popovers sluiten, terwijl de relevante bovenliggende popovers open blijven. Heeft de hint-popover een open bovenliggende auto-popover, dan kunnen bij het openen ook auto-popovers sluiten die in de stapel boven die bovenliggende popover staan. Beide modi ondersteunen sluiten door buiten het paneel te klikken en sluitverzoeken, meestal via Escape. manual sluit geen andere popovers en reageert niet op deze sluitmechanismen.
De popovertarget van een knop verwijst naar de id van het paneel; de standaardactie schakelt de zichtbaarheid ervan om. popovertargetaction="hide" sluit het expliciet. JavaScript biedt ook showPopover(), hidePopover() en togglePopover(). Plaats het paneel indien mogelijk direct na de trigger in de DOM, zodat de leesvolgorde logisch blijft. Het attribuut vervangt niet de toegankelijkheidssemantiek die bij de inhoud hoort.
Voorbeelden
<!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>Resultaat
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.
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.