CKTIS / HTML
source — risorse alternative per immagini e contenuti multimediali
L’elemento `source` dichiara risorse alternative per `picture`, `audio` o `video`. Non visualizza nulla da solo. All’interno di `picture` richiede `srcset`; all’interno di `audio` e `video` richiede `src`. Questi usi non vanno confusi.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<picture>
<source srcset="image.svg" type="image/svg+xml">
<img src="fallback.png" alt="Description">
</picture>source è un elemento vuoto: non contiene contenuto e non ha un tag di chiusura. All’interno di picture va inserito prima dell’elemento img obbligatorio. All’interno di audio e video, gli elementi figli source sono ammessi solo se l’elemento genitore non ha l’attributo src e devono precedere gli elementi track e i contenuti di fallback. Se il genitore ha l’attributo src, la selezione della risorsa usa tale attributo anziché gli elementi figli source.
All’interno di picture, srcset è obbligatorio e src è vietato. img visualizza l’immagine e fornisce anche il testo alt e una sorgente di fallback. sizes descrive le dimensioni dell’immagine per i candidati con descrittori di larghezza; è obbligatorio, a meno che img non consenta dimensioni automatiche. width e height possono definire le dimensioni e le proporzioni della variante selezionata.
All’interno di audio e video, ogni source richiede un URL src non vuoto. L’attributo facoltativo type indica un tipo MIME e aiuta a ignorare un formato non supportato senza scaricarlo. media contiene media query: in picture la selezione reagisce ai cambiamenti dell’ambiente, mentre per gli elementi multimediali la condizione viene valutata una sola volta durante la selezione della risorsa.
Modificare soltanto src o type di una sorgente esistente all’interno di audio o video non cambia la riproduzione; imposta il src dell’elemento genitore. Nell’esempio, le immagini incorporate eliminano le dipendenze dalla rete: con una finestra di visualizzazione larga almeno 600 pixel CSS viene selezionata la variante blu; al di sotto, quella arancione.
Esempi
<!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>Risultato
Viewport >= 600 CSS px: blue rectangle, 120 × 80 CSS px. Viewport < 600 CSS px: orange rectangle, 120 × 80 CSS px.
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.