---
title: HTMLIFrameElement
slug: Web/API/HTMLIFrameElement
tags:
  - API
  - HTML DOM
  - Interfejs
  - Potrzebny przegląd
  - Referencja
translation_of: Web/API/HTMLIFrameElement
---
<div>{{APIRef("HTML DOM")}}</div>

<p>Interfejs <strong><code>HTMLIFrameElement</code></strong> dostarcza specjalne właściwości i metody (oprócz tych dziedziczonych po {{domxref("HTMLElement")}}) do manipulowania rozkładem i prezentacją wewnętrznych elementów ramki.</p>

<h2 id="Właściwości">Właściwości</h2>

<p><em>Dziedziczy właściwości od rodzica, {{domxref("HTMLElement")}}</em>.</p>

<dl>
 <dt>{{domxref("HTMLIFrameElement.align")}} {{obsolete_inline}}</dt>
 <dd>{{domxref("DOMString")}} określający zawijanie ramki w stosunku do otaczającego kontekstu.</dd>
 <dt>{{domxref("HTMLIFrameElement.allowfullscreen")}} {{experimental_inline}}</dt>
 <dd>{{domxref("Boolean")}} określa, czy ramka ma zostać umieszczona w trybie pełnoekranowym. Zobacz <a href="/pl-PL/docs/DOM/Using_full-screen_mode">Używanie trybu pełnoekranowego</a> dla szczegółów.</dd>
 <dt>{{domxref("HTMLIFrameElement.contentDocument")}} {{readonlyInline}}</dt>
 <dd>Zwraca obiekt {{domxref("Document")}}, reprezentujący aktualny kontekst przeglądania w ramce.</dd>
 <dt>{{domxref("HTMLIFrameElement.contentWindow")}} {{readonlyInline}}</dt>
 <dd>Zwraca obiekt {{domxref("WindowProxy")}}, referencję do okna przeglądarki w ramce.</dd>
 <dt>{{domxref("HTMLIFrameElement.frameBorder")}} {{obsolete_inline}}</dt>
 <dd>{{domxref("DOMString")}} określający, czy tworzyć obramowania między ramkami.</dd>
 <dt>{{domxref("HTMLIFrameElement.height")}}</dt>
 <dd>{{domxref("DOMString")}} reprezentujący atrybut {{htmlattrxref("height", "iframe")}} oznaczający wysokość ramki.</dd>
 <dt>{{domxref("HTMLIFrameElement.longDesc")}} {{obsolete_inline}}</dt>
 <dd>{{domxref("DOMString")}} zawierający URI długiego opisu ramki.</dd>
 <dt>{{domxref("HTMLIFrameElement.marginHeight")}} {{obsolete_inline}}</dt>
 <dd>{{domxref("DOMString")}} oznaczający wysokość marginesu.</dd>
 <dt>{{domxref("HTMLIFrameElement.marginWidth")}} {{obsolete_inline}}</dt>
 <dd>{{domxref("DOMString")}} oznaczający szerokość marginesu.</dd>
 <dt>{{domxref("HTMLIFrameElement.name")}}</dt>
 <dd>{{domxref("DOMString")}} oznaczający atrybut {{htmlattrxref("name", "iframe")}}, zawierający nazwę ramki.</dd>
 <dt>{{domxref("HTMLIFrameElement.sandbox")}}</dt>
 <dd>{{domxref("DOMSettableTokenList")}} oznaczający atrybut {{htmlattrxref("sandbox", "iframe")}}, oznaczając dodatkowe ograniczenia na zachowanie zagnieżdżonej zawartości.</dd>
 <dt>{{domxref("HTMLIFrameElement.scrolling")}} {{obsolete_inline}}</dt>
 <dd>{{domxref("DOMString")}}, od którego zależy, czy przeglądarka ma dostarczyć paski przewijania.</dd>
 <dt>{{domxref("HTMLIFrameElement.seamless")}} {{experimental_inline}}</dt>
 <dd>{{domxref("Boolean")}}, odzwierciedlający atrybut {{htmlattrxref("seamless", "iframe")}} , oznaczający, że ramkę należy wyświetlać bezszwowo wewnątrz dokumentu rodzica.</dd>
 <dt>{{domxref("HTMLIFrameElement.src")}}</dt>
 <dd>Is a {{domxref("DOMString")}} that reflects the {{htmlattrxref("src", "iframe")}} HTML attribute, containing the address of the content to be embedded.</dd>
 <dt>{{domxref("HTMLIFrameElement.srcdoc")}}</dt>
 <dd>Is a {{domxref("DOMString")}} that represents the content to display in the frame.</dd>
 <dt>{{domxref("HTMLIFrameElement.width")}}</dt>
 <dd>Is a {{domxref("DOMString")}} that reflects the {{htmlattrxref("width", "iframe")}} HTML attribute, indicating the width of the frame.</dd>
</dl>

<h2 id="Metody">Metody</h2>

<p><em>Dziedziczy właściwości od rodzica, {{domxref("HTMLElement")}}</em>.</p>

<dl>
 <dt>{{domxref("HTMLIFrameElement.setNfcFocus")}}</dt>
 <dd>Część <a href="/en-US/docs/Web/API/Using_the_Browser_API">Browser API</a> systemu Firefox OS, ustala, czy element {{htmlelement("iframe")}} może otrzymać zdarzenie <a href="/en-US/docs/Web/API/NFC_API">NFC</a>.</dd>
</dl>

<h2 id="Historia_specyfikacji">Historia specyfikacji</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specyfikacja</th>
   <th scope="col">Status</th>
   <th scope="col">Opis</th>
  </tr>
  <tr>
   <td>{{SpecName('HTML WHATWG', "the-iframe-element.html#the-iframe-element", "HTMLIFrameElement")}}</td>
   <td>{{Spec2('HTML WHATWG')}}</td>
   <td>Dodano właściwość <code>allowFullscreen</code>.</td>
  </tr>
  <tr>
   <td>{{SpecName('HTML5 W3C', "embedded-content-0.html#the-iframe-element", "HTMLIFrameElement")}}</td>
   <td>{{Spec2('HTML5 W3C')}}</td>
   <td>Następujące właściwości uznano za przestarzałe: <code>scrolling</code>, <code>marginWidth</code>, <code>marginHeight</code>, <code>longDesc</code>, <code>frameBorder</code>, and <code>align</code>.<br>
    Te zostały dodane: <code>srcdoc</code>, <code>sandbox</code>, <code>seamless</code>, and <code>contentWindow</code>.</td>
  </tr>
  <tr>
   <td>{{SpecName('DOM2 HTML', 'html.html#ID-50708718', 'HTMLIFrameElement')}}</td>
   <td>{{Spec2('DOM2 HTML')}}</td>
   <td>Dodano właściwość <code>contentDocument.</code></td>
  </tr>
  <tr>
   <td>{{SpecName('DOM1', 'level-one-html.html#ID-50708718', 'HTMLIFrameElement')}}</td>
   <td>{{Spec2('DOM1')}}</td>
   <td>Początkowa definicja.</td>
  </tr>
 </tbody>
</table>

<h2 id="Kompatybliność_przeglądarek">Kompatybliność przeglądarek</h2>

<div>{{CompatibilityTable}}</div>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Właściwość</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari (WebKit)</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>(Tak)</td>
   <td>1.0 (1.7 lub wcześniejsza)</td>
   <td>(Tak)</td>
   <td>(Tak)</td>
   <td>(Tak)</td>
  </tr>
  <tr>
   <td><code>srcdoc</code></td>
   <td>4</td>
   <td>{{CompatGeckoDesktop(25)}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
  <tr>
   <td><code>sandbox</code></td>
   <td>4</td>
   <td>{{CompatGeckoDesktop(17)}} [1]</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
  <tr>
   <td><code>seamless</code> {{experimental_inline}}</td>
   <td>4</td>
   <td>Nieobsługiwane</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
  <tr>
   <td><code>contentDocument</code></td>
   <td>(Tak)</td>
   <td>(Tak)</td>
   <td>8.0 (dla wcześniejszych wersji używaj <code>HTMLIFrameElement.contentWindow.document</code>)</td>
   <td>(Tak)</td>
   <td>(Tak)</td>
  </tr>
  <tr>
   <td><code>contentWindow</code></td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>(Tak)</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
  <tr>
   <td><code>allowFullScreen</code> {{experimental_inline}}</td>
   <td>17 {{property_prefix("-webkit")}}<br>
    <em>Tylko codzienne wydania testowe</em></td>
   <td>{{compatGeckoDesktop(9.0)}} {{property_prefix("-moz")}}<br>
    {{compatGeckoDesktop(18.0)}}</td>
   <td>Nieobsługiwane</td>
   <td>Nieobsługiwane</td>
   <td>Nieobsługiwane</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Android</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>IE Phone</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>(Tak)</td>
   <td>{{CompatGeckoMobile(1.0)}}</td>
   <td>(Tak)</td>
   <td>(Tak)</td>
   <td>(Tak)</td>
  </tr>
  <tr>
   <td><code>srcdoc</code></td>
   <td>4</td>
   <td>{{CompatGeckoMobile(25)}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
  <tr>
   <td><code>sandbox</code></td>
   <td>4</td>
   <td>{{CompatGeckoMobile(17)}} [1]</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
  <tr>
   <td><code>seamless</code> {{experimental_inline}}</td>
   <td>4</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
  <tr>
   <td><code>contentDocument</code></td>
   <td>(Tak)</td>
   <td>(Tak)</td>
   <td>{{CompatUnknown}}</td>
   <td>(Tak)</td>
   <td>(Tak)</td>
  </tr>
  <tr>
   <td><code>contentWindow</code></td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
  <tr>
   <td><code>allowFullScreen</code> {{experimental_inline}}</td>
   <td>17 {{property_prefix("-webkit")}}<br>
    <em>Tylko codzienne wydania testowe</em></td>
   <td>{{compatGeckoMobile(9.0)}} {{property_prefix("-moz")}}<br>
    {{compatGeckoMobile(18.0)}}</td>
   <td>Nieobsługiwane</td>
   <td>Nieobsługiwane</td>
   <td>Nieobsługiwane</td>
  </tr>
 </tbody>
</table>
</div>

<p>[1] Wcześniej, <code>sandbox</code> był obiektem {{domxref("DOMString")}} a nie {{domxref("DOMSettableTokenList")}}. Naprawiono to w <a href="/en-US/Firefox/Releases/29/Site_Compatibility">Gecko 29.0</a> {{geckoRelease(29)}}) ({{bug(845067)}}). Inne przeglądarki mogą wciąż implementować to jako <code>DOMString</code> ponieważ  to późna zmiana w speyfikacji.</p>

<h3 id="Uwagi_do_Firefox_OS">Uwagi do Firefox OS</h3>

<p>Firefox OS rozszerza <code>HTMLIFrameElement</code> o obsługę elementów iframe przeglądarki. Te metody stworzono dla <a href="/pl-PL/docs/Mozilla/Firefox_OS/Security/Application_security">uprzywilejowanych aplikacji</a> które chcą zaimplementować przeglądarkę jak aplikację na urządzenia z Firefox OS.Wtedy <code>HTMLIFrameElement</code> dziedziczy też od interfejsu {{domxref("EventTarget")}}. To learn how to implement such applications, see the <a href="/pl-PL/docs/WebAPI/Browser">Używanie API przeglądarki</a> article.</p>

<dl>
 <dt>{{domxref("HTMLIFrameElement.setVisible()","HTMLIFrameElement.setVisible(visible)")}}</dt>
 <dd>Pozwala bezpośrednio zmienić widoczność ramek.</dd>
 <dt>{{domxref("HTMLIFrameElement.getVisible()","HTMLIFrameElement.getVisible()")}}</dt>
 <dd>Zwraca obecny stan widoczności ramki obiektem {{domxref("DOMRequest")}}.</dd>
 <dt>{{domxref("HTMLIFrameElement.sendMouseEvent()","HTMLIFrameElement.sendMouseEvent(type, x, y, button, clickCount, modifiers)")}}</dt>
 <dd>Wysyła zdarzenie myszy do przeglądarki.</dd>
 <dt>{{domxref("HTMLIFrameElement.sendTouchEvent()","HTMLIFrameElement.sendTouchEvent(type, identifiers, touchesX, touchesY,radiisX, radiisY, rotationAngles, forces,count, modifiers)")}}</dt>
 <dd>Wysyła zdarzenie dotknięcia do przeglądarki.</dd>
 <dt>{{domxref("HTMLIFrameElement.goBack()","HTMLIFrameElement.goBack()")}}</dt>
 <dd>Cofa przeglądarkę o 1 stronę w historii.</dd>
 <dt>{{domxref("HTMLIFrameElement.goForward()","HTMLIFrameElement.goForward()")}}</dt>
 <dd>Przechodzi dalej o 1 stronę w historii.</dd>
 <dt>{{domxref("HTMLIFrameElement.reload()","HTMLIFrameElement.reload()")}}</dt>
 <dd>Odświeża (ładuje ponownie) stronę internetową w przeglądarce.</dd>
 <dt>{{domxref("HTMLIFrameElement.stop()","HTMLIFrameElement.stop()")}}</dt>
 <dd>Zatrzymuje ładowanie zawartości ramki.</dd>
 <dt>{{domxref("HTMLIFrameElement.purgeHistory()","HTMLIFrameElement.purgeHistory()")}}</dt>
 <dd>Pozwala wyczyścić historię przeglądania.</dd>
 <dt>{{domxref("HTMLIFrameElement.getScreenshot()","HTMLIFrameElement.getScreenshot(maxWidth, maxHeight)")}}</dt>
 <dd>Robi zrzut ekranu, skalując do go rozmiaru <code>maxWidth</code> na <code>maxHeight</code> pikseli. Zwraca obiekt {{domxref("DOMRequest")}}.</dd>
 <dt>{{domxref("HTMLIFrameElement.addNextPaintListener()","HTMLIFrameElement.addNextPaintListener()")}}</dt>
 <dd>Dodaje odbiorcę zdarzenia powiadomianego, gdy ramka jest gotowa do odmalowania po raz pierwszy (Powiadamia się go, gdy pierwsze zdarzenie {{event("MozAfterPaint")}} jest odbierane z ramki.)</dd>
 <dt>{{domxref("HTMLIFrameElement.removeNextPaintListener()","HTMLIFrameElement.removeNextPaintListener()")}}</dt>
 <dd>Usuwa odbiorcę dodanego przez poprzednią funkcję.</dd>
 <dt>{{domxref("HTMLIFrameElement.getCanGoBack()","HTMLIFrameElement.getCanGoBack()")}}</dt>
 <dd>Zwraca obiekt {{domxref("DOMRequest")}} którego składowa <code>result</code> oznacza możliwość powrotu.</dd>
 <dt>{{domxref("HTMLIFrameElement.getCanGoForward()","HTMLIFrameElement.getCanGoForward()")}}</dt>
 <dd>Zwraca obiekt {{domxref("DOMRequest")}} którego składowa <code>result</code> oznacza możliwość powrotu.</dd>
</dl>

<h2 id="Zobacz_też">Zobacz też</h2>

<ul>
 <li>Element HTML implementujący ten interfejs: {{HTMLElement("iframe")}}</li>
</ul>