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