Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

playsinline — odtwarzanie wideo w obrębie strony

Atrybut logiczny playsinline sugeruje przeglądarce odtwarzanie video w obszarze elementu zamiast na pełnym ekranie lub w osobnym oknie. Jest wskazówką, nie gwarancją; jego brak nie wymusza pełnego ekranu.

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

Składnia

<video playsinline></video>

playsinline jest atrybutem logicznym elementu video. Jego obecność sugeruje domyślne wyświetlanie filmu w dokumencie, w obszarze odtwarzania elementu, zamiast na pełnym ekranie lub w osobnym, skalowalnym oknie. To wskazówka dla przeglądarki, a nie bezwarunkowe wymuszenie sposobu prezentacji.

Brak playsinline nie oznacza pełnego ekranu: przeglądarka może domyślnie odtwarzać wideo w obrębie strony. Atrybut nie uruchamia odtwarzania i nie zastępuje autoplay ani controls.

Poprawne zapisy to playsinline, playsinline="" oraz playsinline="playsinline". Zapis playsinline="false" jest niezgodny ze składnią atrybutów logicznych i nadal oznacza obecność atrybutu. Aby wyłączyć wskazówkę, usuń atrybut.

W JavaScript odpowiada mu właściwość playsInline obiektu HTMLVideoElement, z wielką literą I. Odzwierciedla ona obecność atrybutu: przypisanie false usuwa go, a true dodaje. Przykład sprawdza tę zależność bez pliku multimedialnego; nie sprawdza rzeczywistego trybu wyświetlania filmu.

Przykłady

<!doctype html>
<meta charset="utf-8">
<title>playsinline</title>
<video id="clip" playsinline controls></video>
<pre id="result"></pre>
<script>
  const clip = document.getElementById('clip');
  const states = [clip.playsInline];
  clip.playsInline = false;
  states.push(clip.hasAttribute('playsinline'));
  clip.playsInline = true;
  states.push(clip.hasAttribute('playsinline'));
  document.getElementById('result').textContent = states.join('\n');
</script>

Wynik

true
false
true

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

Źródła