CKTIS / HTML
src — Ressourcenadresse
Das Attribut `src` gibt die URL einer Ressource an, die ein HTML-Element verwendet, etwa ein Bild, Skript oder eine Aufnahme. Es ist kein globales Attribut: Ob es anwendbar und erforderlich ist und wie geladen wird, hängt vom Element ab.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
src="URL"src gibt die Adresse einer Ressource an, nicht deren Inhalt oder Alternativtext. Ein angegebener Wert muss eine gültige, nicht leere URL sein; umgebende Leerzeichen sind zulässig. Relative Adressen werden relativ zur Basis-URL des Dokuments aufgelöst. Verwende nicht src="" statt das Attribut wegzulassen.
Bei img bezeichnet es ein Bild; mindestens eines der Attribute src und srcset ist erforderlich. Durch die responsive Auswahl über srcset oder picture kann ein anderes Bild verwendet werden. alt liefert Alternativtext, keine Adresse. Bei input gilt src nur für type="image" und ist dann erforderlich. Bei iframe bezeichnet es eine Seite, aber ein vorhandenes srcdoc hat Vorrang; bei embed bezeichnet es die eingebettete Ressource.
Bei audio und video bezeichnet es die Aufnahme. Gib alternative Ressourcen mit source-Elementen an und lasse src am übergeordneten Element weg. Jedes dieser source-Elemente benötigt src. Ein source innerhalb von picture muss dagegen srcset verwenden und darf kein src haben. Bei track bezeichnet das erforderliche src Textspur-Daten, etwa Untertitel. Nur source.src in einem bestehenden Medienelement zu ändern, schaltet die Wiedergabe nicht um; eine Änderung von src bei audio oder video löst den Ladealgorithmus aus.
Bei script ruft src Code ab, statt den Text im Element zu verwenden. Es ist nur für klassische Skripte und JavaScript-Module zulässig, nicht für Import Maps oder Datenblöcke. Behandle Text in einem Skript mit src nicht als Ersatzcode. Das Beispiel verwendet ein eigenständiges SVG-Bild in einer data:-URL, daher ist keine separate Bilddatei erforderlich.
Beispiele
<!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>Ergebnis
An 80 × 80 CSS-pixel blue square.
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.
Quellen
- 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