tabbrowser

Ten element jest stosowany dla podtrzymania ustawień tylko do odczytu przeglądania dokumentów sieciowych. Podobnym elementem jest browser, poza którym potrafi wyświetlić wiele dokumentów, każdy w osobnej karcie. Ten element jest zaimplementowany jako ustawienie przeglądarki wewnątrz elementu tabbox.

Atrybuty

autocompleteenabled, autocompletepopup, autoscroll, contentcontextmenu, contenttooltip, handleCtrlPageUpDown, onbookmarkgroup, onnewtab

Własności

browsers, canGoBack, canGoForward, contentDocument, contentTitle, contentViewerEdit, contentViewerFile, contentWindow, currentURI, docShell, documentCharsetInfo, homePage, markupDocumentViewer, securityUI, selectedBrowser, selectedTab, sessionHistory, tabContainer, webBrowserFind, webNavigation, webProgress

Metody

addProgressListener, addTab, appendGroup, getBrowserForDocument, getBrowserForTab, getNotificationBox, goBack, goBackGroup, goForward, goForwardGroup, goHome, gotoIndex, loadGroup, loadTabs, loadOneTab, loadURI, loadURIWithFlags, reload, reloadAllTabs, reloadTab, reloadWithFlags, removeAllTabsBut, removeCurrentTab, removeProgressListener, removeTab, replaceGroup, stop

Przykłady

Kod XUL

Poniższy kod jest przykładem elementu tabbox z trzema kartami, gdzie każda zawiera element browser zamiast elementów tabpanel. Pierwsza karta jest wczytana z zawartością HTML, a pozostałe dwie karty są puste:

<vbox>
  <tabbox id="tabBrowser">
    <tabs>
      <tab label="Tab1"/>
      <tab label="Tab2"/>
      <tab label="Tab3"/>
    </tabs>
    <tabpanels width="500" height="500">
      <browser id="browserTab1" src="https://www.mozilla.org"/>
      <browser id="browserTab2"/>
      <browser id="browserTab3"/>
    </tabpanels>
  </tabbox>
  <hbox>
    <button id="btnLoadBrowserContent"  
            label="Wczytaj URL" oncommand="loadURL(document.getElementById('browserTab2'),'https://developer.mozilla.org')"/>
  </hbox>
</vbox>

JavaScript

Poniższy kod ustawi atrybut src elementu browser z id="browserTab2" do adresu url https://developer.mozilla.org, kiedy zdarzenie oncommand zostanie odpalone po tym jak użytkownik naciśnie przycisk "Wczytaj URL".

function loadURL(browserElem,pUrl) {
    //modyfikuje atrybut src elementu browser
    browserElem.setAttribute("src",pUrl);
}

Atrybuty

Własności

Metody

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.

addTab( URL, referrerURI, charset, postData, owner, allowThirdPartyFixup )

Zwraca typ: element tab

Otwiera nową kartę, która ładuje stronę o określonym adresie URL. Pozostałe parametry są opcjonalne. Pasek kart pojawi się, jeśli to potrzebne.

Zobacz przykład: Fragmenty kodu:Przeglądanie w kartach.

appendGroup( group )

Zwraca typ: nie zwraca wartości

Nie w Firefoksie

Dodaje kilka nowych kart na koniec istniejących kart. Argument powinien być tablicą obiektów, jeden dla każdego dokumentu do wczytania. Obiekty mogą być definiowane w skrypcie i stanowić mogą własności URI dla adresu URL strony do wczytania. Własność referrerURI może także być opcjonalnie zastosowana do ustawienia odniesienia się do strony.

getBrowserForDocument( document )

Typ: element browser

Zwraca browser dla określonego dokumentu.

getBrowserForTab( tab )

Typ: element browser

Zwraca browser dla określonego elementu tab.

getNotificationBox( browser )

Typ: element notificationbox

Zwraca notificationbox dla określonego elementu browser.

goBack()

Zwraca typ: nie zwraca wartości

Przejście o jedną stronę wstecz w historii.

goBackGroup()

Nie w Firefoksie

Zwraca typ: nie zwraca wartości

Zwraca poprzednią grupę kart.

goForward()

Zwraca typ: nie zwraca wartości

Przejście o jedną stronę do przodu w historii.

goForwardGroup()

Nie w Firefoksie

Zwraca typ: nie zwraca wartości

Idzie dalej do następnej grupy kart.

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

loadGroup( group )

Nie w Firefoksie

Zwraca typ: pierwsza karta

Wczytuje grupę stron di wielu kart. They are either appended or replaced depending on the state of the preference browser.tabs.loadGroup. The argument should be an array of objects, one for each document to load. The objects may be defined in script and contain a URI property for the URL of the page to load. A referrerURI property may also be optionally used to set the referrer page. This function returns a reference to the first tab loaded.

loadOneTab( URL, referrerURI, charset, postData, loadInBackground, allowThirdPartyFixup )

Zwraca typ: element tab

Otwiera nową kartę, która ładuje stronę o określonym adresie URL. Pozostałe parametry są opcjonalne. Pasek kart pojawi się, jeśli to potrzebne. Metoda ta działa tak samo, jak addTab z tą różnicą, że posiada parametr loadInBackground, który pozwala wybrać, czy otworzyć nową kartę w tle lub na pierwszym planie. Nie ma również parametru owner, jako że karta-właściciel zostanie określona automatycznie.

loadTabs( uris, loadInBackground, replace )

Zwraca typ: nie zwraca wartości

Wczytuje ustawienia URI, określone przez tablicę <tt>uris</tt>, w kartach. Jeśli <tt>loadInBackground</tt> jest true, karty są wczytywane w tle i jeśli <tt>replace</tt> jest typu true, aktualnie wyświetlane karty są zastąpione przez określone URI zamiast dodawania nowych kart.

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.

reloadAllTabs()

Zwraca typ: nie zwraca wartości

Wczytuje ponownie zawartość wszystkich kart.

reloadTab( tab )

Zwraca typ: nie zwraca wartości

Wczytuje ponownie określona kartę.

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.

removeAllTabsBut( tabElement )

Zwraca typ: nie zwraca wartości

Usuwa wszystkie panele kart oprócz jednego przesyłanego do określonej karty. Jeśli tylko jedna strona karta jest wyświetlana, to ta metoda nie robi nic.

removeCurrentTab()

Zwraca typ: element tab

Usuwa bieżącą kartę wyświetlonej strony. Jeśli jest to jedyna wyświetlona karta ze stroną, metoda ta nie zostanie wykonana.

removeProgressListener( listener )

Zwraca typ: nie zwraca wartości

Usuwa element nasłuchujący postęp wczytywania z przeglądarki.

removeTab( tabElement )

Zwraca typ: nie zwraca wartości

Removes a specific tabbed page corresponding to the given tab element. If only one tab is displayed, this method does nothing. If needed, the row of tabs will collapse if only one tab remains.

replaceGroup( group )

Nie w Firefoksie

Zwraca typ: tablica obiektów historii sesji

Zastępuje istniejące karty nowymi ustawieniami. Jeśli tutaj było więcej kart przedtem, dodatkowe karty nie zostaną usunięte. Możemy zastosować metodę removeTab, aby usunąć istniejące pierwsze karty, jeśli if that is desired. The argument should be an array of objects, one for each document to load. The objects may be defined in script and contain a URI property for the URL of the page to load. A referrerURI property may also be optionally used to set the referrer page. This method returns an array of the session history objects for the tabs that were removed.

stop()

Zwraca typ: nie zwraca wartości

Odpowiednik naciśnięcia przycisku Zatrzymaj. Metoda ta zatrzymuje wczytywanie bieżącego dokumentu.

Podobne

TBD