Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

allowfullscreen — możliwość pełnego ekranu w ramce

Logiczny atrybut `allowfullscreen` umożliwia delegowanie funkcji pełnego ekranu do `iframe`, ale sam nie przełącza widoku.

Wersja: HTML Living Standard

Składnia

<iframe src="/video" allowfullscreen></iframe>

Poprawną postacią jest samo allowfullscreen lub allowfullscreen="". Obecność oznacza prawdę: zapis allowfullscreen="false" jest niezgodną próbą wyłączenia i nadal ustawia właściwość allowFullscreen na true. Aby wyłączyć tę deklarację, usuń atrybut.

To starsza postać delegacji Permissions Policy. Ograniczenie fullscreen w allow ma pierwszeństwo, a ramka nie może obejść zakazu dokumentu nadrzędnego. Dopuszczenie funkcji nie zastępuje wywołania Fullscreen API, wymaganej aktywności użytkownika ani obsługi odmowy.

Przykład celowo zawiera błędne "false", aby pokazać pułapkę wartości logicznych. Jednocześnie allow="fullscreen 'none'" blokuje funkcję: właściwość atrybutu jest prawdziwa, ale fullscreenEnabled w ramce fałszywe. Test nie otwiera pełnego ekranu.

Przykłady

<!doctype html><meta charset="utf-8">
<iframe id="frame" title="Local player" allowfullscreen="false"
  allow="fullscreen 'none'" srcdoc="<p>Player</p>"></iframe>
<output id="result"></output>
<script>
document.querySelector('#frame').addEventListener('load', event => {
  const frame = event.target;
  document.querySelector('#result').textContent =
    'attributePresent=' + frame.allowFullscreen +
    '; effective=' + frame.contentDocument.fullscreenEnabled;
});
</script>

Wynik

attributePresent=true; effective=false

Sprawdzono różnicę między obecnością atrybutu a efektywną polityką. Do zwykłego użycia wybierz poprawną składnię podaną wyżej.

Źródła