Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Ramka iframe: właściwość contentWindow i zdarzenie load

`contentWindow` daje dostęp do obiektu reprezentującego okno ramki, a `load` powiadamia o zakończeniu ładowania. Zdarzenie nie potwierdza powodzenia ani nie daje dostępu do DOM.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

const frameWindow = iframe.contentWindow;
iframe.addEventListener("load", handler);
iframe.addEventListener("load", handler, { once: true });

iframe.contentWindow to właściwość tylko do odczytu. Zwraca WindowProxy kontekstu przeglądania ramki albo null, jeśli ramka nie ma takiego kontekstu, na przykład przed wstawieniem nowego elementu do dokumentu. Przy nawigacji w tym samym kontekście obiekt WindowProxy zachowuje tożsamość, choć obiekty Window i Document, do których prowadzi, mogą się zmienić. Sama obecność obiektu proxy nie oznacza, że docelowy dokument jest gotowy.

Zarejestruj funkcję obsługi load na elemencie iframe, a nie na jego oknie, przed wstawieniem ramki lub rozpoczęciem nawigacji, którą chcesz obserwować. Późniejsza nawigacja może ponownie wywołać zdarzenie; przy { once: true } funkcja obsługi jest usuwana tuż przed jej pierwszym wywołaniem. load może wystąpić także po nieudanym ładowaniu, a error na elemencie nie sygnalizuje takiej awarii. Żadne z tych zdarzeń nie nadaje uprawnień ani nie potwierdza gotowości aplikacji.

Możesz odczytać iframe.contentWindow.document, gdy dokument ramki ma to samo źródło (origin) co strona nadrzędna. Przy różnych źródłach odczyt zgłasza SecurityError, a iframe.contentDocument zwraca null. Atrybut sandbox bez allow-same-origin może nadać dokumentowi nieprzezroczyste źródło. Do komunikacji ze współpracującą ramką o innym, znanym źródle użyj postMessage() z dokładnym targetOrigin; odbiorca powinien sprawdzić event.origin, event.source i strukturę danych wiadomości.

To API platformy WWW, a nie funkcja ECMAScript 2024. Przykład wymaga przeglądarki z DOM; obsługa i zasady bezpieczeństwa zależą od środowiska.

Przykłady

<!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>

Wynik

true
Frame ready

Zapisz przykład jako plik HTML, udostępnij go przez HTTP(S) i otwórz w przeglądarce. Zasady strony muszą zezwalać na skrypt osadzony w HTML, ramkę i użycie `srcdoc`. W konsoli przeglądarki `true` pojawia się przed wstawieniem ramki, a `Frame ready` w funkcji obsługi `load`. Przykład korzysta ze stałego, zaufanego tekstu `srcdoc`, nie pobiera zewnętrznego dokumentu i usuwa ramkę po odczytaniu tytułu.

Powiązane lekcje

  • JavaScript · Lekcja 5 · Zaawansowany · Wersja: 4

Źródła