KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

srcset — lijst met afbeeldingskandidaten

Het attribuut `srcset` biedt de browser alternatieve afbeeldingsbronnen. `x`-descriptoren geven de pixeldichtheid aan, terwijl `w`-descriptoren de bronbreedte aangeven die samen met `sizes` wordt gebruikt om een afbeelding te kiezen.

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

Syntax

srcset="image.png 1x, image@2x.png 2x" | srcset="image-400.png 400w, image-800.png 800w" sizes="100vw"

srcset is een door komma’s gescheiden lijst met afbeeldings-URL’s en optionele descriptoren. Het geldt voor img en voor source binnen picture; in dat laatste geval is het verplicht en toont het daaropvolgende img de gekozen afbeelding. Het vervangt niet src op source in audio of video.

De descriptor 2x geeft de dichtheid aan, terwijl 800w de natuurlijke breedte van de bron aangeeft. Waarden moeten positief zijn en mogen niet worden herhaald. Een ontbrekende descriptor betekent 1x. Combineer w niet met x of met kandidaten zonder descriptor.

Bij w-kandidaten is sizes vereist voor img; het beschrijft de breedte voor de selectie, niet de CSS-layoutbreedte. Ook source vereist in dit geval sizes, tenzij het daaropvolgende img automatische formaten toestaat. Bij w negeert de browser src voor de selectie; bij x kan src een 1x-kandidaat leveren als de lijst die niet bevat.

De browser kiest een bron op basis van de weergaveomstandigheden; ga niet uit van een vaste koppeling met de schermdichtheid. Het voorbeeld bevat twee ingesloten afbeeldingen en ziet er hetzelfde uit, ongeacht de selectie.

Voorbeelden

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>srcset example</title>
<img
  src="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='40'%20height='40'%3E%3Cpath%20fill='royalblue'%20d='M0,0H40V40H0Z'/%3E%3C/svg%3E"
  srcset="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='40'%20height='40'%3E%3Cpath%20fill='royalblue'%20d='M0,0H40V40H0Z'/%3E%3C/svg%3E 1x, data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='80'%20height='80'%3E%3Cpath%20fill='royalblue'%20d='M0,0H80V80H0Z'/%3E%3C/svg%3E 2x"
  width="40" height="40" alt="Blue square">
</html>

Resultaat

A royal-blue square displayed at 40 × 40 CSS pixels.

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.

Bronnen