Reference/Xul/browser

C'est un widget similaire à iframe. Son contenu est en lecture seule. Il agit comme un navigateur. Ses méthodes permettent d'agir sur le contenu, la navigation, l'historique de navigation etc..

BalisesDescriptifIncomplet

Attributs de la balise

Herités de ElementXul

Propriétés Javascript

Heritées de ElementXul, plus :

addProgressListener

canGoBack

indique si il existe une page avant la page courante, dans l'historique de navigation. (propriété en lecture seule)

canGoForward

indique si il existe une page aprés la page courante, dans l'historique de navigation. (propriété en lecture seule)

contentDocument

contient l'objet document correspondant à la page affiché dans le composant (propriété en lecture seule).

contentViewerEdit

contient l'objet nsIContentViewerEdit qui permet les opérations de copier-coller sur le document (propriété en lecture seule).

contentViewerFile

contentWindow

contient l'objet window du composant (propriété en lecture seule).

currentURI

contient l'URL courante de la page affichée (propriété en lecture seule). Pour changer l'url, utiliser la méthode loadURI.

docShell

contient l'objet nsIDocShell pour le document (propriété en lecture seule).

documentCharsetInfo

contient l'objet nsIDocumentCharsetInfo qui est utilisé pour manipuler le jeu de caractère utilisé pour l'affichage du document (propriété en lecture seule).

homePage

indique l'url de la page d'accueil de l'utilisateur

markupDocumentViewer

contient l'objet nsIMarkupDocumentViewer responsable de l'affichage de la page (propriété en lecture seule).

preferences

contient l'objet nsIPref charger de gérer les préférences de l'utilisateur (propriété en lecture seule).

sessionHistory

contient l'objet nsISHistory permettant de gérer l'historique de navigation (propriété en lecture seule)

webBrowserFind

contient l'objet nsIWebBrowserFind permettant d'effectuer des recherches dans les textes du document (propriété en lecture seule).

webNavigation

contient l'objet nsIWebNavigation permettant de gerer la navigation (propriété en lecture seule). La plupart de ses méthodes sont accessibles via les méthodes de l'élément browser (goBack, goForward etc...)

webProgress

contient l'objet nsIWebProgress permettant de suivre la progression de chargement d'un document.

Méthodes Javascript

Heritées de ElementXul, plus :

goBack()

recule d'une page, dans l'historique

goForward()

avance d'une page dans l'historique

goHome()

retourne à la page d'acceuil de l'utilisateur

gotoIndex(index)

se déplace jusqu'à la page désignée par l'index, dans l'historique. Utilisez un index positif pour avancer, négatif pour reculer

loadURI ( uri , referrer , charset )

charge l'URL donnée, avec le referrer, et l'encodage de caractères, spécifiés

loadURIWithFlags ( uri , flags , referrer , charset )

charge l'URL donnée, avec le referrer, l'encodage de caractères et les flags, spécifiés.

En plus des flags autorisés pour la méthode reloadWithFlags, les suivants sont également valides :

LOAD_FLAGS_IS_REFRESH : utilisé lorsque l'URL est chargée à cause d'un meta tag de raffraîchissement, ou de redirection,

LOAD_FLAGS_IS_LINK : utilisé lorsque l'URL est chargée par le clic de l'utilisateur sur un lien. L'entête HTTP est chargé en conséquence,

LOAD_FLAGS_BYPASS_HISTORY : ne pas ajouter l'URL à l'historique de la session,

LOAD_FLAGS_REPLACE_HISTORY : remplace l'URL courante, dans l'historique, par celle fournie. Ce flag peut être utilisé pour une redirection.

reload()

recharge le document courant du browser

reloadWithFlags ( flags )

recharge le document courant du browser, avec les flags donnés.

Les flags listés plus-bas peuvent être utilisés. Ils sont des constantes de la propriété webNavigation (ou de l'interface nsIWebNavigation)
Vous pouvez les combiner, en utilisant le symbole '|' .

LOAD_FLAGS_NONE : pas de flag spécial, le document est chargé normalement.

LOAD_FLAGS_BYPASS_CACHE : recharge la page, même si elle est déjà dans le cache. Il s'agit du flag utilisé lorsque le bouton de rechargement est pressé en maintenant la touche <Shift> enfoncée.

LOAD_FLAGS_BYPASS_PROXY : recharge la page en ignorant le server proxy.

LOAD_FLAGS_CHARSET_CHANGE : utilisé si le document a besoin d'être rechargé à cause d'un changement d'encodage des caractères.

removeProgressListener ( listener )

supprime l'écoute de la progression de chargement.

stop()

équivaut à l'action du bouton STOP : stoppe le chargement du document courant.

Balises filles

Aucune

Astuces, Notes, bogues

Références

http://www.xulplanet.com/references/elemref/ref_browser.html

Voir aussi

tabbrowser iframe editor