CKTIS / JavaScript
iframe: lastnost contentWindow in dogodek load
`contentWindow` vrne sklic na okno okvirja. `load` sporoči konec poskusa nalaganja, vendar ne potrdi uspeha in ne omogoči dostopa do DOM-a.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
const frameWindow = iframe.contentWindow;
iframe.addEventListener("load", handler);
iframe.addEventListener("load", handler, { once: true });iframe.contentWindow je lastnost samo za branje. Vrne WindowProxy konteksta brskanja okvirja ali null, če konteksta ni, na primer pri novem elementu pred vstavljanjem v dokument. Pri navigacijah znotraj istega konteksta proxy ostane isti objekt, čeprav se lahko zamenjata objekta Window in Document, na katera se nanaša. Sam obstoj proxyja še ne pomeni, da je želeni dokument pripravljen.
Poslušalnik za load registriraj na elementu iframe, ne na njegovem oknu, preden element vstaviš ali zaženeš navigacijo, ki jo želiš spremljati. Poznejša navigacija lahko znova sproži dogodek; pri { once: true } se poslušalnik odstrani tik pred prvim klicem. load se lahko sproži tudi ob neuspelem nalaganju, element pa te napake ne sporoči z dogodkom error. Nobeden od dogodkov ne podeli dostopa ali potrdi, da je vdelana aplikacija pripravljena.
iframe.contentWindow.document lahko bereš, če imata dokument okvirja in nadrejena stran isti izvor. Pri različnih izvorih dostop sproži SecurityError, medtem ko iframe.contentDocument vrne null. sandbox brez allow-same-origin lahko dokumentu dodeli neprosojen izvor. Za komunikacijo z okvirjem, ki sodeluje in ima drug znan izvor, uporabi postMessage() z natančnim targetOrigin; prejemnik naj preveri event.origin, event.source in zgradbo podatkov sporočila.
To so API-ji spletne platforme, ne funkcije ECMAScripta 2024. Primer zahteva brskalnik z DOM-om; podpora in varnostna pravila so odvisni od okolja.
Primeri
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>iframe contentWindow and load</title>
</head>
<body>
<script>
(() => {
const iframe = document.createElement("iframe");
console.log(iframe.contentWindow === null);
iframe.srcdoc = "<!doctype html><title>Frame ready</title>";
iframe.addEventListener("load", () => {
console.log(iframe.contentWindow.document.title);
iframe.remove();
}, { once: true });
document.body.append(iframe);
})();
</script>
</body>
</html>Rezultat
true Frame ready
Shrani primer kot datoteko HTML, ponudi jo prek HTTP(S) in jo odpri v brskalniku. Stran mora dovoljevati vdelani skript, okvir in prireditev vrednosti `srcdoc`. V konzoli brskalnika se pred vstavljanjem okvirja izpiše `true`, v obdelovalniku dogodka `load` pa `Frame ready`. Koda uporabi nespremenljiv, zaupanja vreden niz `srcdoc`, ne naloži zunanjega dokumenta in po branju naslova odstrani okvir.
Povezane lekcije
- JavaScript · Lekcija 5 · Napredna · Različica: 4