mozilla

Revision 343915 of browser

  • Revision slug: XUL/browser
  • Revision title: browser
  • Revision id: 343915
  • Created:
  • Creator: Laurentj
  • Is current revision? No
  • Comment Add the remote attribute

Revision Content

{{ XULRefElem() }}

A frame which is expected to contain a view of a Web document. It is similar to an {{ XULElem("iframe") }} except that it holds a page history and contains additional methods to manipulate the currently displayed page.

Most of the properties and methods of the browser will rarely be used and can only be called from chrome URLs. Other URLs will need to use the document and history objects to change the displayed document.

Attributes
{{ PrefAnch("a-", "autocompleteenabled") }}, {{ PrefAnch("a-", "autocompletepopup") }}, {{ PrefAnch("a-", "autoscroll") }}, {{ PrefAnch("a-", "disablehistory") }}, {{ PrefAnch("a-", "disableglobalhistory") }}, {{ PrefAnch("a-", "disablesecurity") }}, {{ PrefAnch("a-", "homepage") }}, {{ PrefAnch("a-", "remote") }},{{ PrefAnch("a-", "showcaret") }}, {{ PrefAnch("a-", "src") }}, {{ PrefAnch("a-", "browser.type", "type") }}
Properties
{{ PrefAnch("p-", "accessibleType") }}, {{ PrefAnch("p-", "canGoBack") }}, {{ PrefAnch("p-", "canGoForward") }}, {{ PrefAnch("p-", "contentDocument") }}, {{ PrefAnch("p-", "contentPrincipal") }}, {{ PrefAnch("p-", "contentTitle") }}, {{ PrefAnch("p-", "contentViewerEdit") }}, {{ PrefAnch("p-", "contentViewerFile") }}, {{ PrefAnch("p-", "contentWindow") }}, {{ PrefAnch("p-", "currentURI") }}, {{ PrefAnch("p-", "docShell") }}, {{ PrefAnch("p-", "documentCharsetInfo") }}, {{ PrefAnch("p-", "homePage") }}, {{ PrefAnch("p-", "markupDocumentViewer") }}, {{ PrefAnch("p-", "messageManager") }}, {{ PrefAnch("p-", "browser.preferences", "preferences") }}, {{ PrefAnch("p-", "securityUI") }}, {{ PrefAnch("p-", "sessionHistory") }}, {{ PrefAnch("p-", "webBrowserFind") }}, {{ PrefAnch("p-", "webNavigation") }}, {{ PrefAnch("p-", "webProgress") }}
Methods
{{ PrefAnch("m-", "addProgressListener") }}, {{ PrefAnch("m-", "goBack") }}, {{ PrefAnch("m-", "goForward") }}, {{ PrefAnch("m-", "goHome") }}, {{ PrefAnch("m-", "gotoIndex") }}, {{ PrefAnch("m-", "loadURI") }}, {{ PrefAnch("m-", "loadURIWithFlags") }}, {{ PrefAnch("m-", "reload") }}, {{ PrefAnch("m-", "reloadWithFlags") }}, {{ PrefAnch("m-", "removeProgressListener") }}, {{ PrefAnch("m-", "stop") }}, {{ PrefAnch("m-", "swapDocShells") }}

Examples

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>

Attributes

{{ XULAttrInherited() }}

{{ XULAttrInc("autocompleteenabled") }} {{ XULAttrInc("autocompletepopup") }} {{ XULAttrInc("autoscroll") }} {{ XULAttrInc("disablehistory") }} {{ XULAttrInc("disableglobalhistory") }} {{ XULAttrInc("disablesecurity") }} {{ XULAttrInc("homepage") }} {{ XULAttrInc("remote") }} {{ XULAttrInc("showcaret") }} {{ XULAttrInc("src") }}{{ XULAttrInc("browser.type") }}

Properties

{{ XULPropInherited() }}

{{ XULPropInc("accessibleType") }} {{ XULPropInc("canGoBack") }} {{ XULPropInc("canGoForward") }} {{ XULPropInc("contentDocument") }} {{ XULPropInc("contentPrincipal") }} {{ XULPropInc("contentTitle") }} {{ XULPropInc("contentViewerEdit") }} {{ XULPropInc("contentViewerFile") }} {{ XULPropInc("contentWindow") }} {{ XULPropInc("currentURI") }} {{ XULPropInc("docShell") }} {{ XULPropInc("documentCharsetInfo") }} {{ XULPropInc("homePage") }} {{ XULPropInc("markupDocumentViewer") }} {{ XULPropInc("messageManager") }} {{ XULPropInc("browser.preferences") }} {{ XULPropInc("securityUI") }} {{ XULPropInc("sessionHistory") }} {{ XULPropInc("webBrowserFind") }} {{ XULPropInc("webNavigation") }} {{ XULPropInc("webProgress") }}

Methods

{{ XULMethInherited() }}

{{ XULMethInc("addProgressListener") }} {{ XULMethInc("goBack") }} {{ XULMethInc("goForward") }} {{ XULMethInc("goHome") }} {{ XULMethInc("gotoIndex") }} {{ XULMethInc("loadURI") }} {{ XULMethInc("loadURIWithFlags") }} {{ XULMethInc("reload") }} {{ XULMethInc("reloadWithFlags") }} {{ XULMethInc("removeProgressListener") }} {{ XULMethInc("stop") }} {{ XULMethInc("swapDocShells") }}

Interfaces
{{ interface("nsIAccessibleProvider") }}

{{ languages( { "ja": "ja/XUL/browser", "pl": "pl/XUL/browser" } ) }}

Revision Source

<div class="noinclude">
  {{ XULRefElem() }}</div>
<p>A frame which is expected to contain a view of a Web document. It is similar to an {{ XULElem("iframe") }} except that it holds a page history and contains additional methods to manipulate the currently displayed page.</p>
<p>Most of the properties and methods of the browser will rarely be used and can only be called from chrome URLs. Other URLs will need to use the document and history objects to change the displayed document.</p>
<dl>
  <dt>
    Attributes</dt>
  <dd>
    {{ PrefAnch("a-", "autocompleteenabled") }}, {{ PrefAnch("a-", "autocompletepopup") }}, {{ PrefAnch("a-", "autoscroll") }}, {{ PrefAnch("a-", "disablehistory") }}, {{ PrefAnch("a-", "disableglobalhistory") }}, {{ PrefAnch("a-", "disablesecurity") }}, {{ PrefAnch("a-", "homepage") }}, {{ PrefAnch("a-", "remote") }},{{ PrefAnch("a-", "showcaret") }}, {{ PrefAnch("a-", "src") }}, {{ PrefAnch("a-", "browser.type", "type") }}</dd>
</dl>
<dl>
  <dt>
    Properties</dt>
  <dd>
    {{ PrefAnch("p-", "accessibleType") }}, {{ PrefAnch("p-", "canGoBack") }}, {{ PrefAnch("p-", "canGoForward") }}, {{ PrefAnch("p-", "contentDocument") }}, {{ PrefAnch("p-", "contentPrincipal") }}, {{ PrefAnch("p-", "contentTitle") }}, {{ PrefAnch("p-", "contentViewerEdit") }}, {{ PrefAnch("p-", "contentViewerFile") }}, {{ PrefAnch("p-", "contentWindow") }}, {{ PrefAnch("p-", "currentURI") }}, {{ PrefAnch("p-", "docShell") }}, {{ PrefAnch("p-", "documentCharsetInfo") }}, {{ PrefAnch("p-", "homePage") }}, {{ PrefAnch("p-", "markupDocumentViewer") }}, {{ PrefAnch("p-", "messageManager") }}, {{ PrefAnch("p-", "browser.preferences", "preferences") }}, {{ PrefAnch("p-", "securityUI") }}, {{ PrefAnch("p-", "sessionHistory") }}, {{ PrefAnch("p-", "webBrowserFind") }}, {{ PrefAnch("p-", "webNavigation") }}, {{ PrefAnch("p-", "webProgress") }}</dd>
</dl>
<dl>
  <dt>
    Methods</dt>
  <dd>
    {{ PrefAnch("m-", "addProgressListener") }}, {{ PrefAnch("m-", "goBack") }}, {{ PrefAnch("m-", "goForward") }}, {{ PrefAnch("m-", "goHome") }}, {{ PrefAnch("m-", "gotoIndex") }}, {{ PrefAnch("m-", "loadURI") }}, {{ PrefAnch("m-", "loadURIWithFlags") }}, {{ PrefAnch("m-", "reload") }}, {{ PrefAnch("m-", "reloadWithFlags") }}, {{ PrefAnch("m-", "removeProgressListener") }}, {{ PrefAnch("m-", "stop") }}, {{ PrefAnch("m-", "swapDocShells") }}</dd>
</dl>
<h3 id="Examples" name="Examples">Examples</h3>
<div class="float-right">
  <img alt="Image:XUL_ref_browser.png" class="internal" src="/@api/deki/files/447/=XUL_ref_browser.png" /></div>
<pre>
&lt;!-- shows Mozilla homepage inside a groupbox --&gt;
&lt;groupbox flex="1"&gt;
  &lt;caption label="Mozilla homepage"/&gt;
  &lt;browser type="content" src="http://www.mozilla.org" flex="1"/&gt;
&lt;/groupbox&gt;
</pre>
<h3 id="Attributes" name="Attributes">Attributes</h3>
<p>{{ XULAttrInherited() }}</p>
<p>{{ XULAttrInc("autocompleteenabled") }} {{ XULAttrInc("autocompletepopup") }} {{ XULAttrInc("autoscroll") }} {{ XULAttrInc("disablehistory") }} {{ XULAttrInc("disableglobalhistory") }} {{ XULAttrInc("disablesecurity") }} {{ XULAttrInc("homepage") }} {{ XULAttrInc("remote") }} {{ XULAttrInc("showcaret") }} {{ XULAttrInc("src") }}{{ XULAttrInc("browser.type") }}</p>
<h3 id="Properties" name="Properties">Properties</h3>
<p>{{ XULPropInherited() }}</p>
<p>{{ XULPropInc("accessibleType") }} {{ XULPropInc("canGoBack") }} {{ XULPropInc("canGoForward") }} {{ XULPropInc("contentDocument") }} {{ XULPropInc("contentPrincipal") }} {{ XULPropInc("contentTitle") }} {{ XULPropInc("contentViewerEdit") }} {{ XULPropInc("contentViewerFile") }} {{ XULPropInc("contentWindow") }} {{ XULPropInc("currentURI") }} {{ XULPropInc("docShell") }} {{ XULPropInc("documentCharsetInfo") }} {{ XULPropInc("homePage") }} {{ XULPropInc("markupDocumentViewer") }} {{ XULPropInc("messageManager") }} {{ XULPropInc("browser.preferences") }} {{ XULPropInc("securityUI") }} {{ XULPropInc("sessionHistory") }} {{ XULPropInc("webBrowserFind") }} {{ XULPropInc("webNavigation") }} {{ XULPropInc("webProgress") }}</p>
<h3 id="Methods" name="Methods">Methods</h3>
<p>{{ XULMethInherited() }}</p>
<p>{{ XULMethInc("addProgressListener") }} {{ XULMethInc("goBack") }} {{ XULMethInc("goForward") }} {{ XULMethInc("goHome") }} {{ XULMethInc("gotoIndex") }} {{ XULMethInc("loadURI") }} {{ XULMethInc("loadURIWithFlags") }} {{ XULMethInc("reload") }} {{ XULMethInc("reloadWithFlags") }} {{ XULMethInc("removeProgressListener") }} {{ XULMethInc("stop") }} {{ XULMethInc("swapDocShells") }}</p>
<h3 id="Related" name="Related">Related</h3>
<dl>
  <dt>
    Interfaces</dt>
  <dd>
    {{ interface("nsIAccessibleProvider") }}</dd>
</dl>
<p>{{ languages( { "ja": "ja/XUL/browser", "pl": "pl/XUL/browser" } ) }}</p>
Revert to this revision