Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

Atrybut popover

Globalny atrybut `popover` tworzy początkowo ukryty panel wyświetlany ponad treścią strony. Wartości `auto`, `manual` i `hint` określają zasady jego zamykania.

Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately

Składnia

popover | popover="" | popover="auto" | popover="manual" | popover="hint"

popover jest globalnym atrybutem wyliczeniowym, a nie logicznym. Panel jest początkowo ukryty; po otwarciu trafia do warstwy najwyższej (top layer). Brak atrybutu oznacza zwykły element. Zapis popover lub popover="" wybiera auto; nieprawidłowa wartość, także popover="false", wybiera manual, zamiast wyłączać funkcję.

auto zamyka inne panele automatyczne, z wyjątkiem odpowiednich paneli nadrzędnych. Otwarcie panelu hint może zamknąć inne panele hint, pozostawiając otwarte odpowiednie panele nadrzędne. Jeśli panel hint ma otwarty panel nadrzędny auto, jego otwarcie może również zamknąć panele auto znajdujące się wyżej na stosie niż ten panel nadrzędny. Oba tryby obsługują kliknięcie poza panelem oraz żądania zamknięcia, zwykle klawiszem Escape. manual nie zamyka innych paneli ani nie reaguje na te mechanizmy.

Przycisk z popovertarget wskazuje id panelu; domyślnie przełącza jego widoczność. popovertargetaction="hide" jawnie go zamyka. JavaScript udostępnia również showPopover(), hidePopover() i togglePopover(). Umieszczaj panel bezpośrednio po przycisku w DOM, gdy to możliwe, aby zachować logiczną kolejność odczytu. Atrybut nie zastępuje semantyki dostępności właściwej dla zawartości.

Przykłady

<!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>

Wynik

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.

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła