CKTIS / HTML
source — alternatieve afbeeldings- en mediabronnen
Het element `source` declareert alternatieve bronnen voor `picture`, `audio` of `video`. Het toont zelf niets. Binnen `picture` is `srcset` verplicht; binnen `audio` en `video` is `src` verplicht. Deze toepassingen mogen niet met elkaar worden verward.
Versie: 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 is een leeg element: het heeft geen inhoud en geen eindtag. Plaats het binnen picture vóór het verplichte img-element. Binnen audio en video zijn source-elementen alleen als kindelement toegestaan als het bovenliggende element geen src-attribuut heeft. Ze moeten vóór track-elementen en fallbackinhoud staan. Heeft het bovenliggende element wel een src-attribuut, dan wordt bij de bronselectie dat attribuut gebruikt in plaats van de source-kindelementen.
Binnen picture is srcset verplicht en is src verboden. img toont de afbeelding en levert ook de alt-tekst en een fallbackbron. sizes beschrijft de afbeeldingsgrootte voor kandidaten met breedtedescriptors; het is verplicht, tenzij img automatische formaten toestaat. width en height kunnen de afmetingen en beeldverhouding van de geselecteerde variant vastleggen.
Binnen audio en video vereist elk source een niet-lege src-URL. Het optionele type geeft een MIME-type op en helpt een niet-ondersteund formaat over te slaan zonder het op te halen. media bevat media queries: de selectie in picture reageert op veranderingen in de omgeving, terwijl de voorwaarde bij media-elementen slechts één keer wordt beoordeeld tijdens de selectie van de bron.
Alleen src of type van een bestaande bron binnen audio of video wijzigen, verandert de weergave niet; stel de src van het bovenliggende element in. In het voorbeeld voorkomen ingesloten afbeeldingen netwerkafhankelijkheden: bij een viewportbreedte van minstens 600 CSS-pixels wordt de blauwe variant geselecteerd; bij een kleinere breedte de oranje variant.
Voorbeelden
<!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>Resultaat
Viewport >= 600 CSS px: blue rectangle, 120 × 80 CSS px. Viewport < 600 CSS px: orange rectangle, 120 × 80 CSS px.
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.