CKTIS / HTML
source — alternative Bild- und Medienressourcen
Das Element `source` gibt alternative Ressourcen für `picture`, `audio` oder `video` an. Es zeigt selbst nichts an. Innerhalb von `picture` ist `srcset` erforderlich, innerhalb von `audio` und `video` `src`. Diese Verwendungen dürfen nicht verwechselt werden.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<picture>
<source srcset="image.svg" type="image/svg+xml">
<img src="fallback.png" alt="Description">
</picture>source ist ein leeres Element: Es hat keinen Inhalt und kein End-Tag. Innerhalb von picture steht es vor dem erforderlichen img. Innerhalb von audio und video sind source-Kindelemente nur zulässig, wenn das Elternelement kein src-Attribut hat. Sie müssen vor track-Elementen und Ersatzinhalten stehen. Hat das Elternelement ein src-Attribut, wird bei der Ressourcenauswahl dieses Attribut anstelle der source-Kindelemente verwendet.
Innerhalb von picture ist srcset erforderlich und src unzulässig. Das img zeigt das Bild an und stellt außerdem den alt-Text sowie eine Ersatzquelle bereit. sizes beschreibt die Bildgröße für Kandidaten mit Breiten-Deskriptoren; es ist erforderlich, sofern img keine automatischen Größen zulässt. Mit width und height lassen sich die Abmessungen und das Seitenverhältnis der ausgewählten Variante festlegen.
Innerhalb von audio und video benötigt jedes source eine nicht leere src-URL. Das optionale type gibt einen MIME-Typ an und hilft dabei, ein nicht unterstütztes Format ohne Abruf zu überspringen. media enthält Media Queries: Die Auswahl in picture reagiert auf Änderungen der Umgebung, während die Bedingung bei Medienelementen nur einmal bei der Ressourcenauswahl ausgewertet wird.
Das bloße Ändern von src oder type einer vorhandenen Quelle in audio oder video ändert die Wiedergabe nicht; setze stattdessen src des übergeordneten Elements. Im Beispiel vermeiden eingebettete Bilder Netzwerkabhängigkeiten: Bei einer Viewport-Breite von mindestens 600 CSS-Pixeln wird die blaue Variante ausgewählt, bei geringerer Breite die orangefarbene.
Beispiele
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>source demo</title>
<picture>
<source media="(min-width: 600px)" type="image/svg+xml"
srcset="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='120'%20height='80'%3E%3Cpath%20fill='blue'%20d='M0,0H120V80H0Z'/%3E%3C/svg%3E">
<img width="120" height="80" alt="Color sample"
src="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='120'%20height='80'%3E%3Cpath%20fill='orange'%20d='M0,0H120V80H0Z'/%3E%3C/svg%3E">
</picture>
</html>Ergebnis
Viewport >= 600 CSS px: blue rectangle, 120 × 80 CSS px. Viewport < 600 CSS px: orange rectangle, 120 × 80 CSS px.
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.