WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

playsinline — Videowiedergabe innerhalb der Seite

Das boolesche Attribut playsinline gibt dem Browser den Hinweis, Videos im Wiedergabebereich des Elements statt im Vollbild oder in einem separaten Fenster abzuspielen. Es ist ein Hinweis, keine Garantie; das Weglassen erzwingt keinen Vollbildmodus.

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

Syntax

<video playsinline></video>

playsinline ist ein boolesches Attribut des Elements video. Wenn es vorhanden ist, gibt es dem Browser den Hinweis, Videos standardmäßig innerhalb des Dokuments und im Wiedergabebereich des Elements statt im Vollbild oder in einem separaten, in der Größe veränderbaren Fenster anzuzeigen. Es handelt sich um einen Hinweis für den Browser, nicht um eine uneingeschränkte Vorgabe für die Darstellung.

Fehlt playsinline, bedeutet das nicht, dass das Video im Vollbild angezeigt wird: Ein Browser kann Videos standardmäßig innerhalb der Seite abspielen. Das Attribut startet die Wiedergabe nicht und ersetzt weder autoplay noch controls.

Gültige Schreibweisen sind playsinline, playsinline="" und playsinline="playsinline". Die Schreibweise playsinline="false" entspricht nicht der Syntax boolescher Attribute; das Attribut bleibt trotzdem vorhanden. Um den Hinweis zu deaktivieren, entferne das Attribut.

In JavaScript entspricht dem Attribut die Eigenschaft playsInline von HTMLVideoElement, mit großgeschriebenem I. Sie spiegelt wider, ob das Attribut vorhanden ist: Durch Zuweisen von false wird es entfernt, durch Zuweisen von true hinzugefügt. Das Beispiel prüft diesen Zusammenhang ohne Mediendatei; es testet nicht die tatsächliche Darstellung des Videos.

Beispiele

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

Ergebnis

true
false
true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen