Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

HTMLImageElement.src — URL vira slike

HTMLImageElement.src omogoča branje ali nastavljanje URL-ja slike. Lastnost odraža atribut src. Pri branju vrne absolutni URL samo, če je vrednost atributa mogoče razčleniti kot URL z uporabo osnovnega URL-ja dokumenta. Ne potrjuje, da se je slika naložila.

Različica: 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 je zapisljiva besedilna lastnost DOM-a v brskalniku, ne pa samega ECMAScripta. Odraža atribut src elementa img: z dodelitvijo image.src = url ta atribut spremenimo.

Če je atribut prisoten, image.src pri branju vrne absolutni URL samo, če je vrednost atributa mogoče razčleniti kot URL z uporabo osnovnega URL-ja dokumenta. Če razčlenjevanje URL-ja ne uspe, image.src vrne vrednost atributa kot USVString. Vsako neparno nadomestno kodno enoto UTF-16, shranjeno v atributu na primer z metodo setAttribute, v vrnjenem nizu nadomesti nadomestni znak U+FFFD. Na primer, icon.png ni mogoče razrešiti glede na nepregleden osnovni URL vrste data:. Če atribut manjka, image.src vrne prazen niz. Nasprotno pa image.getAttribute("src") vrne shranjeno vrednost atributa brez razreševanja URL-ja ali null, če atributa ni.

Sprememba src sproži obdelavo vira slike, vendar to ne pomeni, da se nalaganje takoj konča. Obravnavaj dogodka load in error ter upravljalnike namesti pred dodelitvijo. Pri srcset ali picture se lahko izbrani vir razlikuje od src; za pregled URL-ja trenutne zahteve uporabi currentSrc.

Primer preverja samo razreševanje URL-ja v ločenem dokumentu s fiksno osnovo. Ne preverja pridobivanja ali prikaza slike. Zaženi ga v brskalniku; prisotnost Node 24 v repozitoriju ne dokazuje podpore za ta API.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri