mozilla

browser

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

accessible
Typ: nsIAccessible
Zwraca obiekt dostępności dla elementu.
canGoBack
Typ: boolean
Własność tylko do odczytu ma wartość true, jeśli istnieje strona w historii sesji, do której można się cofnąć, a przycisk 'Wstecz' powinien być dostępny.
canGoForward
Typ: boolean
Własność tylko do odczytu ma wartość true, jeśli istnieje strona w historii sesji, do której można przejść, a przycisk 'Do przodu' powinien być dostępny.
contentDocument
Typ: document
Własność tylko do odczytu zawierająca obiekt dokumentu w danym elemencie.


contentTitle
Typ: string
Własność tylko do odczytu zawierająca tytuł obiektu dokumentu w przeglądarce.


contentViewerEdit
Typ: nsIContentViewerEdit
Własność tylko do odczytu zawierająca nsIContentViewerEdit, który zajmuje się operacjami związanymi ze schowkiem w danym dokumencie.


contentViewerFile
Typ: nsIContentViewerFile
Referencja do interfejsu nsIContentViewerFile dla dokumentu.


contentWindow
Typ: window
Własność tylko do odczytu zawierająca obiekt okna w elemencie.

currentURI
Typ: nsIURI
Własność tylko do odczytu zawierająca aktualnie wczytany adres URL. Aby zmienić adres URL, należy zastosować metodę loadURI.


docShell
Typ: nsIDocShell
Własność tylko do odczytu zawierająca obiekt nsIDocShell dla dokumentu.
documentCharsetInfo
Typ: nsIDocumentCharsetInfo
Własność tylko do odczytu zawierająca obiekt nsIDocumentCharsetInfo dla dokumentu, stosowany do określenia, które kodowanie znaków powinno być zastosowane do wyświetlenia dokumentu.


homePage
Typ: tekstowy adres URL strony domowej
Ta własność przechowuje adres strony startowej ustawionej przez użytkownika.


markupDocumentViewer
Typ: nsIMarkupDocumentViewer
Własność tylko do odczytu zawierająca nsIMarkupDocumentViewer, który jest odpowiedzialny za rysowanie dokumentu.


preferences
Typ: nsIPrefService
Własność tylko do odczytu zawierająca obiekt nsIPref służący do pobierania i ustawiania właściwości użytkownika.


securityUI
Typ: nsISecureBrowserUI
Własność tylko do odczytu przechowująca obiekt, który może zostać użyty do określenia poziomu bezpieczeństwa we wczytanym dokumencie.


sessionHistory
Typ: nsISHistory
Własność tylko do odczytu zawierająca obiekt nsISHistory, przechowujący historię sesji.


webBrowserFind
Typ: nsIWebBrowserFind
Własność tylko do odczytu zawierająca obiekt nsIWebBrowserFind, którego można użyć do szukania tekstu w dokumencie.


webNavigation
Typ: nsIWebNavigation
Własność tylko do odczytu zawiera obiekt nsIWebNavigation dla dokumentu. Wiele z jego metod może być wywoływanych bezpośrednio na dokumencie; są to takie metody jak goBack i goForward. Zawiera także stałe wczytywania wykorzystywane przez reloadWithFlags i loadURIWithFlags.


webProgress
Typ: nsIWebProgress
Własność tylko do odczytu zawierająca obiekt nsIWebProgress, który jest stosowany do monitorowania postępu podczas ładowania dokumentu.


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

Contributors to this page: lmorchard, teoli, Marcoos, Ptak82, Mgjbot
Ostatnia aktualizacja: teoli,