CKTIS / HTML
src — adresse de ressource
L’attribut `src` indique l’URL d’une ressource utilisée par un élément HTML, comme une image, un script ou un enregistrement. Ce n’est pas un attribut global : son applicabilité, son caractère obligatoire et son mode de chargement dépendent de l’élément.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
src="URL"src fournit l’adresse d’une ressource, et non son contenu ni son texte alternatif. La valeur fournie doit être une URL valide et non vide ; les espaces qui l’entourent sont autorisés. Une adresse relative est résolue par rapport à l’URL de base du document. N’utilisez pas src="" à la place de l’omission de l’attribut.
Sur img, il désigne une image ; au moins l’un des attributs src et srcset est obligatoire. La sélection adaptative via srcset ou picture peut entraîner l’utilisation d’une autre image. alt fournit un texte alternatif, pas une adresse. Sur input, src ne s’applique qu’à type="image" et est alors obligatoire. Sur iframe, il désigne une page, mais un srcdoc présent est prioritaire ; sur embed, il désigne la ressource intégrée.
Sur audio et video, il désigne l’enregistrement. Indiquez les ressources alternatives avec des éléments source, sans src sur l’élément parent. Chacun de ces éléments source exige src. En revanche, un source dans picture doit utiliser srcset et ne doit pas avoir src. Sur track, le src obligatoire désigne les données de piste textuelle, comme des sous-titres. Modifier uniquement source.src dans un élément multimédia existant ne change pas la lecture ; modifier src sur audio ou video déclenche l’algorithme de chargement.
Sur script, src récupère du code au lieu d’utiliser le texte enfant de l’élément. Il est autorisé uniquement pour les scripts classiques et les modules JavaScript, pas pour les import maps ni les blocs de données. Ne considérez pas le texte d’un script avec src comme du code de secours. L’exemple utilise une image SVG autonome dans une URL data: ; aucun fichier image séparé n’est donc nécessaire.
Exemples
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>src example</title>
</head>
<body>
<img
src="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='80'%20height='80'%3E%3Crect%20width='80'%20height='80'%20fill='blue'/%3E%3C/svg%3E"
alt="Blue square"
width="80"
height="80">
</body>
</html>Résultat
An 80 × 80 CSS-pixel blue square.
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.
Sources
- HTML Standard — The img element
- HTML Standard — The source element
- HTML Standard — The embed element
- HTML Standard — The iframe element
- HTML Standard — Image Button state
- HTML Standard — Location of the media resource
- HTML Standard — The track element
- HTML Standard — The audio element
- HTML Standard — The video element
- HTML Standard — The script element