Ramka, która powinna wyświetlać dokument WWW. Element ten jest podobny do elementu iframe z tą różnicą, że podtrzymuje historię stron i zawiera dodatkowe metody do manipulacji aktualnie wyświetlaną stroną.

Większość własności i metod przeglądarki będzie rzadko używana i będzie je można wywołać tylko z poziomu dokumentu o adresie URL chrome. Dokumenty z innych adresów URL będą do zmiany wyświetlanego dokumentu musiały stosować obiekty dokumentu i historii.

Atrybuty
autocompleteenabled, autocompletepopup, autoscroll, disablehistory, disablesecurity, homepage, src, type
Własności
accessible, canGoBack, canGoForward, contentDocument, contentTitle, contentViewerEdit, contentViewerFile, contentWindow, currentURI, docShell, documentCharsetInfo, homePage, markupDocumentViewer, preferences, securityUI, sessionHistory, webBrowserFind, webNavigation, webProgress
Metody
addProgressListener, goBack, goForward, goHome, gotoIndex, loadURI, loadURIWithFlags, reload, reloadWithFlags, removeProgressListener, stop

Przykłady

Image:XUL_ref_browser.png
<!-- shows Mozilla homepage inside a groupbox -->
<groupbox flex="1">
  <caption label="Mozilla homepage"/>
  <browser type="content" src="http://www.mozilla.org" flex="1"/>
</groupbox>

Atrybuty

autocompleteenabled
Tylko Firefox
Typ: boolean
Wartość true włącza automatyczne uzupełnianie pól tekstowych.


autocompletepopup
Typ: id elementu wyskakującego (popup)
id elementu popup wykorzystywanego do przechowywania wyników automatycznego uzupełniania dla tego elementu.


autoscroll
Tylko Firefox
Typ: boolean
Wartość false wyłącza automatyczne przewijanie dla danej przeglądarki. Jeśli atrybut jest ustawiony na true lub zostanie pominięty, automatyczne przewijanie zostanie włączone lub będzie zależne od wartości opcji general.autoScroll.


disablehistory
Typ: boolean
Jeśli atrybut ma wartość false, przycisk ze strzałką wyświetli się na końcu pola tekstowego, które otworzy menu rozwijane wszystkich dostępnych wyników. Domyślna wartością jest true, ukrywające przycisk rozwijania.


disablesecurity
Typ: boolean
Wartość true wyłącza UI bezpieczeństwa dla tej przeglądarki. Pominięcie tego atrybutu włącza je.


homepage
Typ: adres URL strony startowej
Atrybut ten pozwala ustawić stronę startową dla elementu browser. Nie ma to żadnego związku ze stroną startową użytkownika przeglądarki. Pozwala za to na wygodne przechowywanie adresu strony startowej. Stronę startową można otworzyć przy użyciu metody goHome.


src
Typ: URL
Adres URL zawartości do wyświetlenia w elemencie.

 

type
Typ: jedna z wartości poniżej
Typ przeglądarki, który może zostać użyty do ustawienia dostępu do dokumentu wczytywanego wewnątrz przeglądarki. Jeśli nie jest ustawiony, wczytywany dokument posiada taki sam dostęp jak okno zawierające <browser>.
  • content: Przeglądarka zawartości. Zawartość, która jest wczytywana wewnątrz przeglądarki, nie ma dostępu do warstwy chrome ponad nią.
  • content-primary: Główna przeglądarka dla zawartości. Zawartość, która jest wczytywana wewnątrz przeglądarki, nie ma dostępu do warstwy chrome ponad nią. Przykładowo, w przeglądarce WWW będzie to element, który wyświetla stronę internetową. Wygodniejszy dostęp do okna dla głównej zawartości zapewnia window.content.

Zobacz także

Dodatkowe informacje znaleźć można kursie XUL i iframe


Własności

Metody

Dziedziczy z elementu XUL
blur, click, doCommand, focus, getElementsByAttribute getElementsByAttributeNS

Dziedziczy z elementu DOM
addEventListener(), appendChild(), dispatchEvent(), getAttribute(), getAttributeNode(), getAttributeNodeNS(), getAttributeNS(), getElementsByTagName(), getElementsByTagNameNS(), hasAttribute(), hasAttributeNS(), hasAttributes(), hasChildNodes(), insertBefore(), isSupported(), normalize(), removeAttribute(), removeAttributeNode(), removeAttributeNS(), removeChild(), removeEventListener(), replaceChild(), setAttribute(), setAttributeNode(), setAttributeNodeNS(), setAttributeNS()

addProgressListener( listener )
Zwraca typ: nie zwraca wartości
Dodaje do przeglądarki element nasłuchujący postęp, który będzie monitorował wczytywane dokumenty. Element nasłuchujący powinien implementować interfejs nsIWebProgressListener.
goBack()
Zwraca typ: nie zwraca wartości
Przejście o jedną stronę wstecz w historii.


goForward()
Zwraca typ: nie zwraca wartości
Przejście o jedną stronę do przodu w historii.


goHome()
Zwraca typ: nie zwraca wartości
Wczytuje stronę startową użytkownika do przeglądarki.


gotoIndex( index )
Zwraca typ: nie zwraca wartości
Przechodzi do strony o podanym indeksie w historii. Użyj wartości dodatniej, by przejść w przód, a ujemnej by w tył.


loadURI( uri, adres-odsyłający, kodowanie-znaków )
Zwraca typ: nie zwraca wartości
Wczytuje dokument spod danego adresu URL, z danym kodowaniem i adresem odsyłającym.


loadURIWithFlags( uri, flagi, adres-odsyłający, kodowanie-znaków, postData )
Zwraca typ: nie zwraca wartości
Wczytuje adres URL do dokumentu z określonymi flagami wczytywania, pozwala określić adres odsyłający, kodowanie znaków oraz dane przesyłane metodą POST. Poza flagami dozwolonymi dla metody reloadWithFlags, dostępne są także:
  • LOAD_FLAGS_IS_REFRESH: Ta flaga jest stosowana, kiedy adres URL jest wczytywany ponieważ znacznik meta jest ustawiony na odświeżanie lub przekierowanie.
  • LOAD_FLAGS_IS_LINK: Ta flaga jest stosowana, kiedy adres URL jest wczytywany po kliknięciu odnośnika przez użytkownika. Nagłówek HTTP Referer jest odpowiednio ustawiany.
  • LOAD_FLAGS_BYPASS_HISTORY: Nie dodaje adresu URL do historii sesji.
  • LOAD_FLAGS_REPLACE_HISTORY: Zamienia bieżący adres URL w historii sesji na nowy. Ta flaga może zostać użyta przy przekierowywaniu.


reload()
Zwraca typ: nie zwraca wartości
Wczytuje ponownie dokument w przeglądarce.


reloadWithFlags( flags )
Zwraca typ: nie zwraca wartości
Wczytuje ponownie dokument w przeglądarce z danymi flagami wczytywania. Można użyć poniższych flag; wszystkie one są stałymi własności webNavigation (lub interfejsu nsIWebNavigation). Flagi te można łączyć przy użyciu symbolu ( | ).
  • LOAD_FLAGS_NONE: Bez specjalnych flag. Dokument wczytywany jest normalnie.
  • LOAD_FLAGS_BYPASS_CACHE: Ponownie wczytuje stronę, bez względu na to, czy strona znajduje się w pamięci podręcznej. Flaga ta jest stosowana, kiedy użytkownik naciśnie przycisk Odśwież przytrzymując wciśnięty klawisz Shift.
  • LOAD_FLAGS_BYPASS_PROXY: Ponownie wczytuje stronę, ignorując serwery proxy.
  • LOAD_FLAGS_CHARSET_CHANGE: Flaga ta jest stosowana, gdy zachodzi konieczność odświeżenia dokumentu, ponieważ zmieniono kodowanie znaków.


removeProgressListener( listener )
Zwraca typ: nie zwraca wartości
Usuwa element nasłuchujący postęp wczytywania z przeglądarki.


stop()
Zwraca typ: nie zwraca wartości
Odpowiednik naciśnięcia przycisku Zatrzymaj. Metoda ta zatrzymuje wczytywanie bieżącego dokumentu.



Podobne

Interfejsy
nsIAccessibleProvider

Autorzy i etykiety dokumentu

Autorzy tej strony: teoli, lmorchard, Marcoos, Mgjbot, Ptak82
Ostatnia aktualizacja: teoli,