Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

HTMLImageElement.src — URL izvora slike

HTMLImageElement.src omogućuje čitanje ili postavljanje URL-a slike. Svojstvo odražava atribut src. Pri čitanju vraća apsolutni URL samo ako se vrijednost atributa može protumačiti kao URL uz osnovni URL dokumenta. Ne potvrđuje da je slika učitana.

Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

image.src = url;
const resolvedUrl = image.src;

HTMLImageElement.src zapisivo je tekstno svojstvo DOM-a u pregledniku, a ne samog ECMAScripta. Odražava atribut src elementa img: dodjela image.src = url mijenja taj atribut.

Ako atribut postoji, image.src pri čitanju vraća apsolutni URL samo ako se vrijednost atributa može protumačiti kao URL uz osnovni URL dokumenta. Ako raščlanjivanje URL-a ne uspije, image.src vraća vrijednost atributa kao USVString. Svaka neuparena surogatna kodna jedinica UTF-16 pohranjena u atributu, primjerice pomoću metode setAttribute, u vraćenom se nizu zamjenjuje zamjenskim znakom U+FFFD. Na primjer, icon.png ne može se razriješiti u odnosu na neprozirni osnovni URL vrste data:. Ako atribut nedostaje, image.src vraća prazan niz. Nasuprot tome, image.getAttribute("src") vraća pohranjenu vrijednost atributa bez razrješavanja URL-a ili null ako atribut ne postoji.

Promjena src pokreće obradu izvora slike, ali ne znači da će učitavanje odmah završiti. Obradi događaje load i error te postavi rukovatelje prije dodjele. Uz srcset ili picture, odabrani se resurs može razlikovati od src; za pregled URL-a trenutačnog zahtjeva upotrijebi currentSrc.

Primjer provjerava samo razrješavanje URL-a u zasebnom dokumentu s fiksnom osnovom. Ne provjerava dohvaćanje ni prikaz slike. Pokreni ga u pregledniku; prisutnost Nodea 24 u repozitoriju ne dokazuje podršku za ovaj API.

Primjeri

const doc = document.implementation.createHTMLDocument("Demo");
const base = doc.createElement("base");
base.href = "https://example.invalid/assets/";
doc.head.append(base);

const image = doc.createElement("img");
image.src = "icon.png";

console.log(image.getAttribute("src"));
console.log(image.src);

Rezultat

icon.png
https://example.invalid/assets/icon.png

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori