Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

HTMLImageElement.src — URL zdroja obrázka

HTMLImageElement.src umožňuje čítať alebo nastaviť URL obrázka. Vlastnosť odráža atribút src. Pri čítaní vráti absolútnu URL len vtedy, ak možno hodnotu atribútu spracovať ako URL s použitím základnej URL dokumentu. Nepotvrdzuje, že sa obrázok načítal.

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

Syntax

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

HTMLImageElement.src je zapisovateľná textová vlastnosť DOM v prehliadači, nie samotného ECMAScriptu. Odráža atribút src prvku img: priradenie image.src = url tento atribút zmení.

Ak atribút existuje, image.src pri čítaní vráti absolútnu URL len vtedy, ak možno hodnotu atribútu spracovať ako URL s použitím základnej URL dokumentu. Ak sa spracovanie URL nepodarí, image.src vráti hodnotu atribútu ako USVString. Každá nespárovaná kódová jednotka UTF-16 z rozsahu surogátov, uložená v atribúte napríklad pomocou setAttribute, sa vo vrátenom reťazci nahradí náhradným znakom U+FFFD. Napríklad icon.png nemožno vyhodnotiť vzhľadom na nepriehľadnú základnú URL typu data:. Ak atribút chýba, image.src vráti prázdny reťazec. Naopak, image.getAttribute("src") vráti uloženú hodnotu atribútu bez vyhodnotenia URL alebo null, ak atribút chýba.

Zmena src spustí spracovanie zdroja obrázka, ale neznamená, že sa načítanie okamžite dokončí. Spracúvaj udalosti load a error a obslužné funkcie nainštaluj pred priradením hodnoty. Pri použití srcset alebo picture sa vybraný zdroj môže líšiť od src; na kontrolu URL aktuálnej požiadavky použi currentSrc.

Príklad overuje iba rozlíšenie URL v samostatnom dokumente s pevne nastavenou základnou URL. Neoveruje načítanie ani zobrazenie obrázka. Spusti ho v prehliadači; prítomnosť Node 24 v repozitári nedokazuje podporu tohto API.

Príklady

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);

Výsledok

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

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje