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