+---

+title: Controlo ActiveX para alojar Netscape Plugins no IE

+slug: Archive/Mozilla/ActiveX_Control_for_Hosting_Netscape_Plug-ins_in_IE

+translation_of: Archive/Mozilla/ActiveX_Control_for_Hosting_Netscape_Plug-ins_in_IE

+---

+<h2 id="Introduction" name="Introduction">Introdução</h2>

+

+<p>A Microsoft retirou o apoio aos Netscape plugins desde a versão IE 5.5 SP 2 .  Este projeto poupa muito trabalho aos desenvolvedores de plugins . </p>

+

+<p>Esta página descreve um controlo que implementa a NPAPI e aloja a maioria dos plugins compativeis com Netscape. A partir de agora pode-se usar os passados plugins nas versões recentes do IE ou em outro contentor Activex. O próprio controlo é implementado numa DLL, a "pluginhostctrl.dll" autónoma do restante projeto Mozilla.</p>

+

+<p>Quem quiser saber como a Microsoft mantinha a NPAPI deve procurar a ficha "plugin.ocx" na diretoria do sistema Windows. Este controlo Activex de 100k contem toda a implementação NPAPI e equivalia ao funcionamento  da atual "pluginhostctrl.dll".</p>

+

+<p>A secção subjacente conta como obter a fonte, construir e usar a pluginhostctrl.dll.</p>

+

+<p> </p>

+

+<h2 id="Get_the_source" name="Get_the_source">Obter a fonte</h2>

+

+<p>É preciso ter CVS para obter o código fonte.  Admitindo que tem o CVS  escreva ou copie e cole o código subjacente no  command prompt:</p>

+

+<pre>C:\&gt; set CVSROOT=:pserver:anonymous@cvs-mirror.mozilla.org:/cvsroot

+C:\&gt; set HOME=\TEMP

+C:\&gt; cvs login

+(Logging in to anonymous@cvs-mirror.mozilla.org)

+CVS password: anonymous

+C:\&gt; cvs -z3 co mozilla/embedding/browser/activex/src/pluginhostctrl

+</pre>

+

+<p> Isto coloca o código fonte do controlo  em   mozilla\embedding\browser\activex\src\pluginhostctrl.</p>

+

+<p>Também pode-se ver o código fonte  <a class="external" href="http://lxr.mozilla.org/seamonkey/source/embedding/browser/activex/src/pluginhostctrl/">online</a>.</p>

+

+<p> </p>

+

+<h2 id="Build_it" name="Build_it">Construir o controlo </h2>

+

+<p> E fácil construir o controlo:</p>

+

+<ol>

+ <li>Locatize a diretoria da pluginhostctrl :</li>

+ <li>Abra a pluginhostctrl.dsp</li>

+ <li>Faça o ficheiro  "Win32 Debug" or outro </li>

+ <li>Abra algumas das fichas de teste em  pluginhostctrl\tests no Internet Explorer e verifique se o controlo está construído e ficou registado corretamente. </li>

+</ol>

+

+<p>O controlo lê os  plugins do Netscape 4.x e  IE instalados, mas ainda não funciona  com o Mozilla ou NS 6.x .</p>

+

+<h2 id="A_note_to_developers" name="A_note_to_developers">Nota para os desenvolvedores</h2>

+

+<p> Se pretender ALTERAR  este contolo tem de OBRIGATÓRIAMENTE alterar a  CLSID from {DBB2DE32-61F1-4F7F-BEB8-A37F5BC24EE2} para algo diverso e outras GUIDs que o controlam (IID, LIBIDs etc). Isto é necessário para que possa coexistir com a versão genérica e outras versões que outros produtores de plugins que estejam ou possam ser instaladas. </p>

+

+<p>IAconselha-se a renomear o controlo e a não instalar à toa, ou na diretoria do Windows, para não ser ignorado. </p>

+

+<p>Use uma aplicação como guidgen.exe ou uuidgen.exe para fazer novas  GUIDs.</p>

+

+<h2 id="Package_it" name="Package_it">Empacotamento</h2>

+

+<p>Há uma subdirectoria  chamada cab/ com um script  e um README.txt para cada desenvolvedor fazer or seus próprios ficheiros CAB.</p>

+

+<h2 id="Manual_installation" name="Manual_installation">Instalação manual</h2>

+

+<p>Após ter precompilado a pluginhostctrl.dll, para a instalar num  computador, é preciso  registar com um script de instalação ou manualmente.:</p>

+

+<pre>regsvr32 pluginhostctrl.dll</pre>

+

+<p>Para instalar um controlo num sistema operativo Windows NT, 2000 &amp; XP precisa de autorização do nível de administrador..</p>

+

+<h2 id="Usage" name="Usage">Utilização</h2>

+

+<p>Escreva HTML como o do conteúdo.subjacente:</p>

+

+<pre> &lt;OBJECT classid="CLSID:DBB2DE32-61F1-4F7F-BEB8-A37F5BC24EE2"

+ width="500" height="300"&gt;

+ &lt;PARAM name="type" value="video/quicktime"/&gt;

+ &lt;PARAM name="src" value="http://www.foobar.com/some_movie.mov"/&gt;

+ &lt;!-- Custom arguments --&gt;

+ &lt;PARAM name="loop" value="true"/&gt;

+ &lt;/OBJECT&gt;

+</pre>

+

+<p>O atributo CLASSID diz ao IE para criar uma instància do plugin alojador do controlo. A WIDTH e a HEIGHT especificam as dimensões em pixeis.</p>

+

+<p>Pode-se optat por especificar um atributo CODEBASE se o controlo foi empacotado num ficheiro  CAB  para instalação automática. .</p>

+

+<p>Os seguintes atributos &lt;EMBED&gt; tem  &lt;PARAM&gt; tag equivalentes:</p>

+

+<ul>

+ <li>&lt;PARAM name="type" ...&gt; equivale a TYPE<br>

+ Especifica o tipo MIME do plugin. O controlo usa este valor para determinar o plugin a criar para manipular o conteúdo..</li>

+ <li>&lt;PARAM name="src" ...&gt; equivale a SRC<br>

+ Especifca a URL para a corrente de dados initial alimentar o plugin. Se não foi especificado um "tipo" PARAM, o controlo tentará usar o tipo MIME da corrente para criar o  plugin correto..</li>

+ <li>&lt;PARAM name="pluginspage" ...&gt; equivale a PLUGINSPAGE<br>

+ Especifica a URL que instala o plugin.  O plugin base redireciona a  página  quando o plugin correto não está instalado.</li>

+</ul>

+

+<p>Pode-se  colocar qualquer plugin personalizado  como elemento adicional de  &lt;PARAM&gt;.</p>

+

+<h2 id="Still_to_do" name="Still_to_do">Limitações: </h2>

+

+<ul>

+ <li>Apenas aloja plugins janelados .</li>

+ <li>Falta um ficheiro pluginhostctrl.cab oficial .</li>

+ <li>Não funciona com o Adobe Acrobat plugin .</li>

+ <li>Os Plugins não criam correntes editáveis nem procuram correntes legiveis. .</li>

+ <li>LiveConnect scripting não funciona . Para funcionar com scripting é preciso enviar a pluginhostctrl.dll modificada que  exponha os  métodos que são chamados no plugin.</li>

+</ul>

+---

+title: Archived Mozilla and build documentation

+slug: Archive/Mozilla

+tags:

+ - NeedsTranslation

+ - TopicStub

+translation_of: Archive/Mozilla

+---

+<p>These articles are archived, obsolete documents about Mozilla, Gecko, and the process of building Mozilla projects.</p>

+<p>{{SubpagesWithSummaries}}</p>

+---

+title: XPInstall

+slug: Archive/Mozilla/XPInstall

+tags:

+ - NeedsTranslation

+ - TopicStub

+ - XPInstall

+ - XPInstall_API_reference

+translation_of: Archive/Mozilla/XPInstall

+---

+<p></p><div class="warning"><p>Parts of this page show the use of the <a class="new" href="https://developer.mozilla.org/pt-BR/docs/XPInstall_API_Reference" rel="nofollow">XPInstall API</a>. The majority of this API is now deprecated and as of Gecko 1.9 no longer available. <a class="new" href="https://developer.mozilla.org/pt-BR/docs/Extensions" rel="nofollow">Extension</a>, <a class="new" href="https://developer.mozilla.org/pt-BR/docs/Themes" rel="nofollow">Theme</a>, and <a class="new" href="https://developer.mozilla.org/pt-BR/docs/Plugins" rel="nofollow">plug-in</a> developers must switch away from <code>install.js</code> based packages to the new <a class="new" href="https://developer.mozilla.org/pt-BR/docs/Bundles" rel="nofollow">packaging scheme</a> with an <code><a class="new" href="https://developer.mozilla.org/pt-BR/docs/Install_Manifests" rel="nofollow">install.rdf</a></code> manifest. In particular plugin developers should see <a class="new" href="https://developer.mozilla.org/pt-BR/docs/Shipping_a_plugin_as_a_Toolkit_bundle" rel="nofollow">how to package a plugin as an extension</a>.</p></div><p></p>

+

+<div><strong>Cross-Platform Install (XPInstall)</strong> is a technology used by Mozilla Application Suite, Mozilla Firefox, Mozilla Thunderbird and other <a href="/en-US/docs/XUL" title="XUL">XUL</a>-based applications for installing <a href="/en-US/docs/Extensions" title="Extensions">extensions</a>. An <a href="/en-US/docs/XPI" title="XPI">XPI</a> (pronounced "zippy" and derived from XPInstall) installer module is a ZIP file that contains an install script or manifest (entitled install.js or <a href="/en-US/docs/Install_Manifests" title="Install_Manifests">install.rdf</a>) at the root of the file.</div>

+

+<table class="topicpage-table">

+ <tbody>

+ <tr>

+ <td>

+ <h2 class="Documentation" id="Documentation" name="Documentation">Documentation</h2>

+

+ <dl>

+ <dt><a href="/en-US/docs/XPInstall_API_Reference" title="XPInstall_API_Reference">XPInstall API Reference</a></dt>

+ <dd>XPInstall API Reference.</dd>

+ <dt><a href="/en-US/docs/Learn_XPI_Installer_Scripting_by_Example" title="Learn_XPI_Installer_Scripting_by_Example">Learn XPI Installer Scripting by Example</a></dt>

+ <dd>This article uses the installer script from <code>browser.xpi</code> install package as the basis for discussing XPI installations in general.</dd>

+ <dt><a href="/en-US/docs/Creating_XPI_Installer_Modules" title="Creating_XPI_Installer_Modules">Creating XPI Installer Modules</a></dt>

+ <dd>This article describes the packaging scheme of the Mozilla and offers a tutorial for creating a new package that can then be redistributed, installed, and made available to users.</dd>

+ <dt><a href="/en-US/docs/Install_Wizards_(aka:_Stub_Installers)" title="Install_Wizards_(aka:_Stub_Installers)">Install Wizards (aka: Stub Installers)</a></dt>

+ </dl>

+

+ <p><span class="alllinks"><a href="/en-US/docs/tag/XPInstall" title="tag/XPInstall">View All...</a></span></p>

+ </td>

+ <td>

+ <h2 class="Community" id="Community" name="Community">Community</h2>

+

+ <ul>

+ <li>View Mozilla forums... {{ DiscussionList("dev-platform", "mozilla.dev.platform") }}</li>

+ </ul>

+

+ <h2 class="Tools" id="Tools" name="Tools">Tools</h2>

+

+ <ul>

+ <li><a class="external" href="http://www.mozilla.org/quality/smartupdate/xpinstall-trigger.html">XPInstall trigger page</a></li>

+ </ul>

+

+ <h2 class="Related_Topics" id="Related_Topics" name="Related_Topics">Related Topics</h2>

+

+ <ul>

+ <li><a href="/en-US/docs/Extensions" title="Extensions">Extensions</a>, <a href="/en-US/docs/XUL" title="XUL">XUL</a>, <a href="/en-US/docs/XPI" title="XPI">XPI</a></li>

+ </ul>

+ </td>

+ </tr>

+ </tbody>

+</table>

+

+<p> </p>

+---

+title: XPInstall API reference

+slug: Archive/Mozilla/XPInstall/Reference

+tags:

+ - NeedsTranslation

+ - TopicStub

+ - XPInstall

+ - XPInstall_API_reference

+translation_of: Archive/Mozilla/XPInstall/Reference

+---

+<p></p><div class="warning"><p>Parts of this page show the use of the <a class="new" href="https://developer.mozilla.org/pt-BR/docs/XPInstall_API_Reference" rel="nofollow">XPInstall API</a>. The majority of this API is now deprecated and as of Gecko 1.9 no longer available. <a class="new" href="https://developer.mozilla.org/pt-BR/docs/Extensions" rel="nofollow">Extension</a>, <a class="new" href="https://developer.mozilla.org/pt-BR/docs/Themes" rel="nofollow">Theme</a>, and <a class="new" href="https://developer.mozilla.org/pt-BR/docs/Plugins" rel="nofollow">plug-in</a> developers must switch away from <code>install.js</code> based packages to the new <a class="new" href="https://developer.mozilla.org/pt-BR/docs/Bundles" rel="nofollow">packaging scheme</a> with an <code><a class="new" href="https://developer.mozilla.org/pt-BR/docs/Install_Manifests" rel="nofollow">install.rdf</a></code> manifest. In particular plugin developers should see <a class="new" href="https://developer.mozilla.org/pt-BR/docs/Shipping_a_plugin_as_a_Toolkit_bundle" rel="nofollow">how to package a plugin as an extension</a>.</p></div><p></p>

+

+<h3 id="Objects" name="Objects">Objects</h3>

+

+<h4 id="Install" name="Install"><a href="/en-US/docs/XPInstall_API_Reference/Install_Object">Install</a></h4>

+

+<dl>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Properties">Properties</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods">Methods</a></dd>

+</dl>

+

+<dl>

+ <dd>

+ <dl>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/addDirectory">addDirectory</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/addFile">addFile</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/alert">alert</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/cancelInstall">cancelInstall</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/confirm">confirm</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/deleteRegisteredFile">deleteRegisteredFile</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/execute">execute</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/gestalt">gestalt</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/getComponentFolder">getComponentFolder</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/getFolder">getFolder</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/getLastError">getLastError</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/getWinProfile">getWinProfile</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/getWinRegistry">getWinRegistry</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/initInstall">initInstall</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/loadResources">loadResources</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/logComment">logComment</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/patch">patch</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/performInstall">performInstall</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/refreshPlugins">refreshPlugins</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/registerChrome">registerChrome</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/resetError">resetError</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/setPackageFolder">setPackageFolder</a></dd>

+ </dl>

+ </dd>

+</dl>

+

+<h4 id="InstallTrigger" name="InstallTrigger"><a href="/en-US/docs/XPInstall_API_Reference/InstallTrigger_Object">InstallTrigger</a></h4>

+

+<dl>

+ <dd><em>No properties</em></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/InstallTrigger_Object/Methods">Methods</a></dd>

+</dl>

+

+<dl>

+ <dd>

+ <dl>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/InstallTrigger_Object/Methods/compareVersion">compareVersion</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/InstallTrigger_Object/Methods/enabled">enabled</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/InstallTrigger_Object/Methods/getVersion">getVersion</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/InstallTrigger_Object/Methods/install">install</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/InstallTrigger_Object/Methods/installChrome">installChrome</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/InstallTrigger_Object/Methods/startSoftwareUpdate">startSoftwareUpdate</a></dd>

+ </dl>

+ </dd>

+</dl>

+

+<h4 id="InstallVersion" name="InstallVersion"><a href="/en-US/docs/XPInstall_API_Reference/InstallVersion_Object">InstallVersion</a></h4>

+

+<dl>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/InstallVersion_Object/Properties">Properties</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/InstallVersion_Object/Methods">Methods</a></dd>

+</dl>

+

+<dl>

+ <dd>

+ <dl>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/InstallVersion_Object/Methods/compareTo">compareTo</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/InstallVersion_Object/Methods/init">init</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/InstallVersion_Object/Methods/toString">toString</a></dd>

+ </dl>

+ </dd>

+</dl>

+

+<h4 id="File" name="File"><a href="/en-US/docs/XPInstall_API_Reference/File_Object">File</a></h4>

+

+<dl>

+ <dd><em>No properties</em></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/File_Object/Methods">Methods</a></dd>

+</dl>

+

+<dl>

+ <dd>

+ <dl>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/File_Object/Methods/copy">copy</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/File_Object/Methods/dirCreate">dirCreate</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/File_Object/Methods/dirGetParent">dirGetParent</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/File_Object/Methods/dirRemove">dirRemove</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/File_Object/Methods/dirRename">dirRename</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/File_Object/Methods/diskSpaceAvailable">diskSpaceAvailable</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/File_Object/Methods/execute">execute</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/File_Object/Methods/exists">exists</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/File_Object/Methods/isDirectory">isDirectory</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/File_Object/Methods/isFile">isFile</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/File_Object/Methods/macAlias">macAlias</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/File_Object/Methods/modDate">modDate</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/File_Object/Methods/modDateChanged">modDateChanged</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/File_Object/Methods/move">move</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/File_Object/Methods/remove">remove</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/File_Object/Methods/rename">rename</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/File_Object/Methods/size">size</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/File_Object/Methods/windowsGetShortName">windowsGetShortName</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/File_Object/Methods/windowsRegisterServer">windowsRegisterServer</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/File_Object/Methods/windowsShortcut">windowsShortcut</a></dd>

+ </dl>

+ </dd>

+</dl>

+

+<h4 id="WinProfile" name="WinProfile"><a href="/en-US/docs/XPInstall_API_Reference/WinProfile_Object">WinProfile</a></h4>

+

+<dl>

+ <dd><em>No properties</em></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/WinProfile_Object/Methods">Methods</a></dd>

+</dl>

+

+<dl>

+ <dd>

+ <dl>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/WinProfile_Object/Methods/getString">getString</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/WinProfile_Object/Methods/writeString">writeString</a></dd>

+ </dl>

+ </dd>

+</dl>

+

+<h4 id="WinReg" name="WinReg"><a href="/en-US/docs/XPInstall_API_Reference/WinReg_Object">WinReg</a></h4>

+

+<dl>

+ <dd><em>No properties</em></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/WinReg_Object/Methods">Methods</a></dd>

+</dl>

+

+<dl>

+ <dd>

+ <dl>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/WinReg_Object/Methods/createKey">createKey</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/WinReg_Object/Methods/deleteKey">deleteKey</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/WinReg_Object/Methods/deleteValue">deleteValue</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/WinReg_Object/Methods/enumKeys">enumKeys</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/WinReg_Object/Methods/enumValueNames">enumValueNames</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/WinReg_Object/Methods/getValue">getValue</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/WinReg_Object/Methods/getValueNumber">getValueNumber</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/WinReg_Object/Methods/getValueString">getValueString</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/WinReg_Object/Methods/isKeyWritable">isKeyWritable</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/WinReg_Object/Methods/keyExists">keyExists</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/WinReg_Object/Methods/setRootKey">setRootKey</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/WinReg_Object/Methods/setValue">setValue</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/WinReg_Object/Methods/setValueNumber">setValueNumber</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/WinReg_Object/Methods/setValueString">setValueString</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/WinReg_Object/Methods/valueExists">valueExists</a></dd>

+ </dl>

+ </dd>

+</dl>

+

+<dl>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/WinReg_Object/WinRegValue">WinRegValue constructor</a></dd>

+</dl>

+

+<h3 id="Other_Information" name="Other_Information">Other Information</h3>

+

+<h4 id="Return_Codes" name="Return_Codes">Return Codes</h4>

+

+<p><a href="/en-US/docs/XPInstall_API_Reference/Return_Codes">See complete list</a></p>

+

+<h4 id="Examples" name="Examples"><a href="/en-US/docs/XPInstall_API_Reference/Examples">Examples</a></h4>

+

+<dl>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/Examples/Trigger_Scripts_and_Install_Scripts">Trigger Scripts and Install Scripts</a></dd>

+</dl>

+

+<h5 id="Code_Samples" name="Code_Samples">Code Samples</h5>

+

+<dl>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/Examples/File.macAlias">File.macAlias</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/Examples/File.windowsShortcut">File.windowsShortcut</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/Examples/Install.addDirectory">Install.addDirectory</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/Examples/Install.addFile">Install.addFile</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/Examples/InstallTrigger.installChrome">InstallTrigger.installChrome</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/Examples/InstallTrigger.startSoftwareUpdate">InstallTrigger.startSoftwareUpdate</a></dd>

+ <dd><a href="/en-US/docs/XPInstall_API_Reference/Examples/Windows_Install">Windows Install</a></dd>

+</dl>

+---

+title: Install Object

+slug: Archive/Mozilla/XPInstall/Reference/Install_Object

+tags:

+ - NeedsTranslation

+ - TopicStub

+ - XPInstall_API_reference

+translation_of: Archive/Mozilla/XPInstall/Reference/Install_Object

+---

+<p></p><div class="warning"><p>Parts of this page show the use of the <a class="new" href="https://developer.mozilla.org/pt-BR/docs/XPInstall_API_Reference" rel="nofollow">XPInstall API</a>. The majority of this API is now deprecated and as of Gecko 1.9 no longer available. <a class="new" href="https://developer.mozilla.org/pt-BR/docs/Extensions" rel="nofollow">Extension</a>, <a class="new" href="https://developer.mozilla.org/pt-BR/docs/Themes" rel="nofollow">Theme</a>, and <a class="new" href="https://developer.mozilla.org/pt-BR/docs/Plugins" rel="nofollow">plug-in</a> developers must switch away from <code>install.js</code> based packages to the new <a class="new" href="https://developer.mozilla.org/pt-BR/docs/Bundles" rel="nofollow">packaging scheme</a> with an <code><a class="new" href="https://developer.mozilla.org/pt-BR/docs/Install_Manifests" rel="nofollow">install.rdf</a></code> manifest. In particular plugin developers should see <a class="new" href="https://developer.mozilla.org/pt-BR/docs/Shipping_a_plugin_as_a_Toolkit_bundle" rel="nofollow">how to package a plugin as an extension</a>.</p></div><p></p>

+

+<h2 id="Install" name="Install">Install</h2>

+

+<p>Use the <code>Install</code> object to manage the downloading and installation of software with the XPI Installation Manager.</p>

+

+<h3 id="Overview" name="Overview">Overview</h3>

+

+<p>The Install object is used primarily in installation scripts. In all cases, the <code>Install</code> object is implicit--like the <code>window</code> object in regular web page scripts--and needn't be prefixed to the object methods. The following two lines, for example, are equivalent:</p>

+

+<pre>f = getFolder("Program");

+f = Install.getFolder("Program");

+</pre>

+

+<p>An installation script is composed of calls to the Install object, and generally takes the following form:</p>

+

+<dl>

+ <dt>Initialize the installation</dt>

+ <dd>Call <a href="en/XPInstall_API_Reference/Install_Object/Methods/initInstall"> initInstall</a> with the name of the installation and the necessary registry and version information.</dd>

+ <dt>Add the files to the installation</dt>

+ <dd>Add files to the installation by calling <a href="en/XPInstall_API_Reference/Install_Object/Methods/getFolder"> getFolder</a> to get file objects and passing those object refs to <a href="en/XPInstall_API_Reference/Install_Object/Methods/addFile"> addFile</a> as many times as necessary.</dd>

+ <dt>Perform installation</dt>

+ <dd>Check that the files have been added successfully (e.g., by checking the error <a href="en/XPInstall_API_Reference/Return_Codes"> Return Codes</a> from many of the main installation methods, and go ahead with the install if everything is in order:</dd>

+</dl>

+

+<pre>performOrCancel();

+function performOrCancel()

+{

+ if (0 == getLastError())

+ performInstall();

+ else

+ cancelInstall();

+}

+</pre>

+

+<p>For complete script examples, see <a href="en/XPInstall_API_Reference/Examples"> Script Examples</a>.</p>

+---

+title: alert

+slug: Archive/Mozilla/XPInstall/Reference/Install_Object/Methods/alert

+translation_of: Archive/Mozilla/XPInstall/Reference/Install_Object/Methods/alert

+---

+<h2 id="Summary" name="Summary">Sumário</h2>

+<p>A função <em>alert</em> mostra uma caixa de diálogo modal com uma mensagem.</p>

+<h3 id="Method_of" name="Method_of">Método de</h3>

+<p><a href="/en-US/docs/XPInstall_API_Reference/Install_Object">Install</a> object</p>

+<h2 id="Syntax" name="Syntax">Sintaxe</h2>

+<pre class="syntaxbox">void alert ( String <var>message</var> );

+</pre>

+<h3 id="Parameters" name="Parameters">Parâmetros</h3>

+<p>O parâmetro <em>message</em> é exibido como uma string na caixa de diálogo. Se <em>message</em> não é uma string, é convertido em uma e é exibido.</p>

+<h3 id="Returns" name="Returns">Retorna</h3>

+<p>Nada.</p>

+---

+title: Methods

+slug: Archive/Mozilla/XPInstall/Reference/Install_Object/Methods

+tags:

+ - NeedsTranslation

+ - TopicStub

+translation_of: Archive/Mozilla/XPInstall/Reference/Install_Object/Methods

+---

+<p></p><div class="warning"><p>Parts of this page show the use of the <a class="new" href="https://developer.mozilla.org/pt-BR/docs/XPInstall_API_Reference" rel="nofollow">XPInstall API</a>. The majority of this API is now deprecated and as of Gecko 1.9 no longer available. <a class="new" href="https://developer.mozilla.org/pt-BR/docs/Extensions" rel="nofollow">Extension</a>, <a class="new" href="https://developer.mozilla.org/pt-BR/docs/Themes" rel="nofollow">Theme</a>, and <a class="new" href="https://developer.mozilla.org/pt-BR/docs/Plugins" rel="nofollow">plug-in</a> developers must switch away from <code>install.js</code> based packages to the new <a class="new" href="https://developer.mozilla.org/pt-BR/docs/Bundles" rel="nofollow">packaging scheme</a> with an <code><a class="new" href="https://developer.mozilla.org/pt-BR/docs/Install_Manifests" rel="nofollow">install.rdf</a></code> manifest. In particular plugin developers should see <a class="new" href="https://developer.mozilla.org/pt-BR/docs/Shipping_a_plugin_as_a_Toolkit_bundle" rel="nofollow">how to package a plugin as an extension</a>.</p></div><p></p>

+

+<h3 id="Methods" name="Methods">Methods</h3>

+

+<dl>

+ <dt><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/addDirectory" title="en/XPInstall_API_Reference/Install_Object/Methods/addDirectory">addDirectory</a></dt>

+ <dd>Unpacks an entire subdirectory.</dd>

+ <dt><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/addFile" title="en/XPInstall_API_Reference/Install_Object/Methods/addFile">addFile</a></dt>

+ <dd>Unpacks a single file.</dd>

+ <dt><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/alert" title="en/XPInstall_API_Reference/Install_Object/Methods/alert">alert</a></dt>

+ <dd>Displays an Alert dialog box with a message and an OK button.</dd>

+ <dt><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/cancelInstall" title="en/XPInstall_API_Reference/Install_Object/Methods/cancelInstall">cancelInstall</a></dt>

+ <dd>Aborts the installation of the software.</dd>

+ <dt><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/confirm" title="en/XPInstall_API_Reference/Install_Object/Methods/confirm">confirm</a></dt>

+ <dd>Displays a Confirm dialog box with the specified message and OK and Cancel buttons. Also allows custom button labels and a checkbox.</dd>

+ <dt><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/deleteRegisteredFile" title="en/XPInstall_API_Reference/Install_Object/Methods/deleteRegisteredFile">deleteRegisteredFile</a></dt>

+ <dd>Deletes the specified file and its entry in the Client Version Registry.</dd>

+ <dt><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/execute" title="en/XPInstall_API_Reference/Install_Object/Methods/execute">execute</a></dt>

+ <dd>Extracts a file from the XPI file to a temporary location and schedules it for later execution.</dd>

+ <dt><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/gestalt" title="en/XPInstall_API_Reference/Install_Object/Methods/gestalt">gestalt</a></dt>

+ <dd>Retrieves information about the operating environment. (Mac OS only)</dd>

+ <dt><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/getComponentFolder" title="en/XPInstall_API_Reference/Install_Object/Methods/getComponentFolder">getComponentFolder</a></dt>

+ <dd>Returns an object representing the directory in which a component is installed.</dd>

+ <dt><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/getFolder" title="en/XPInstall_API_Reference/Install_Object/Methods/getFolder">getFolder</a></dt>

+ <dd>Returns an object representing a directory, for use with the <code>addFile</code> method.</dd>

+ <dt><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/getLastError" title="en/XPInstall_API_Reference/Install_Object/Methods/getLastError">getLastError</a></dt>

+ <dd>Returns the most recent non-zero error code.</dd>

+ <dt><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/getWinProfile" title="en/XPInstall_API_Reference/Install_Object/Methods/getWinProfile">getWinProfile</a></dt>

+ <dd>Constructs an object for working with a Windows .ini file.</dd>

+ <dt><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/getWinRegistry" title="en/XPInstall_API_Reference/Install_Object/Methods/getWinRegistry">getWinRegistry</a></dt>

+ <dd>Constructs an object for working with the Windows Registry.</dd>

+ <dt><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/initInstall" title="en/XPInstall_API_Reference/Install_Object/Methods/initInstall">initInstall</a></dt>

+ <dd>Initializes installation for the given software and version.</dd>

+ <dt><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/loadResources" title="en/XPInstall_API_Reference/Install_Object/Methods/loadResources">loadResources</a></dt>

+ <dd>Returns an object whose properties are localized strings loaded from the specified property file.</dd>

+ <dt><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/logComment" title="en/XPInstall_API_Reference/Install_Object/Methods/logComment">logComment</a></dt>

+ <dd>Add a comment line to the install log.</dd>

+ <dt><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/patch" title="en/XPInstall_API_Reference/Install_Object/Methods/patch">patch</a></dt>

+ <dd>Applies a set of differences between two versions.</dd>

+ <dt><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/performInstall" title="en/XPInstall_API_Reference/Install_Object/Methods/performInstall">performInstall</a></dt>

+ <dd>Finalizes the installation of the software.</dd>

+ <dt><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/refreshPlugins" title="en/XPInstall_API_Reference/Install_Object/Methods/refreshPlugins">refreshPlugins</a></dt>

+ <dd>Refreshes the list of plug-ins registered for the browser.</dd>

+ <dt><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/registerChrome" title="en/XPInstall_API_Reference/Install_Object/Methods/registerChrome">registerChrome</a></dt>

+ <dd>Registers chrome with the chrome registry.</dd>

+ <dt><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/resetError" title="en/XPInstall_API_Reference/Install_Object/Methods/resetError">resetError</a></dt>

+ <dd>Resets a saved error code to zero.</dd>

+ <dt><a href="/en-US/docs/XPInstall_API_Reference/Install_Object/Methods/setPackageFolder" title="en/XPInstall_API_Reference/Install_Object/Methods/setPackageFolder">setPackageFolder</a></dt>

+ <dd>Sets the default package folder that is saved with the root node.</dd>

+</dl>

+---

+title: XUL

+slug: Archive/Mozilla/XUL

+tags:

+ - NeedsTranslation

+ - TopicStub

+ - XUL

+translation_of: Archive/Mozilla/XUL

+---

+<div class="callout-box"><strong><a href="/en-US/docs/XUL_Tutorial" title="en-US/docs/XUL_Tutorial">Tutorial XUL</a></strong><br>

+Um tutorial guiado que o ajudará a começar com XUL, originario do XULPlanet.</div>

+

+<div>

+<p><strong>XUL </strong> (XML Linguagem de Interface do usuário) é a<a href="/en-US/docs/XML" title="en-US/docs/XML"> linguagem baseada em XML </a> da Mozilla, para construir interfaces de usuário. Em particular, é usado pelo Firefox. Os desenvolvedores da Web já familiarizados com <a href="/en-US/docs/HTML" title="en-US/docs/HTML"> HTML </a> aprenderão XUL rapidamente e podem começar a criar aplicativos de imediato. Abra a <a class="external" href="http://www.hevanet.com/acorbin/xul/top.xul">Tabela Periódica XUL </a> no Firefox ou em outro <a href="/en-US/Docs/Gecko" title="en-US/docs/Gecko"> navegador baseado em Gecko </a> para ver alguns demos da XUL.</p>

+

+<div class="warning"><strong>Nota:</strong> Esta "Tabela Periódica XUL" não pode ser mostrada nas versões recentes do Gecko porque ele usa o XUL remoto, uma tecnologia cujo suporte foi descartado devido a possíveis problemas de segurança. Existe uma aplicação XULRunner que contém a tabela periódica XUL que pode ser aberta com navegadores baseados em Gecko. <a href="https://github.com/matthewkastor/XULRunner-Examples" title="https://github.com/matthewkastor/XULRunner-Examples"> Você pode obtê-la aqui</a>. Veja: <a href="/en-US/docs/XULRunner_tips#Using_Firefox_3_to_run_XULRunner_applications" title="/en-US/docs/XULRunner_tips#Using_Firefox_3_to_run_XULRunner_applications"> XULRunner_tips#Using_Firefox_3_to_run_XULRunner_applications </a> para obter instruções sobre a execução de aplicativos XULRunner no Firefox.</div>

+</div>

+

+<table class="topicpage-table">

+ <tbody>

+ <tr>

+ <td>

+ <h2 class="Documentation" id="Documentação">Documentação</h2>

+

+ <dl>

+ <dt><a href="/en-US/docs/XUL_Reference" title="en-US/docs/XUL_Reference">Referencias XUL</a></dt>

+ <dd>Elementos XUL, atributos, propriedades, métodos e manipuladores de eventos.</dd>

+ <dt><a href="/en-US/docs/XUL_controls" title="en-US/docs/XUL_controls">Controle XUL</a></dt>

+ <dd>Uma lista rápida de todos os controles XUL disponíveis.</dd>

+ <dt><a href="/en-US/docs/XUL_School" title="en-US/docs/XUL School">Escola XUL</a></dt>

+ <dd>Um tutorial abrangente sobre o desenvolvimento de add-on no Mozilla.</dd>

+ <dt><a href="/en-US/docs/The_Joy_of_XUL" title="en-US/docs/The_Joy_of_XUL">A Alegria de XUL</a></dt>

+ <dd>Descreve os principais recursos e componentes do XUL.</dd>

+ <dt><a href="/en-US/docs/XUL/PopupGuide" title="en-US/docs/XUL/PopupGuide">Guia de menus e Popups</a></dt>

+ <dd>Um guia sobre o uso de menus e painéis popups.</dd>

+ <dt><a href="/en-US/docs/XUL/Template_Guide" title="en-US/docs/XUL/Template_Guide">Guia de Template</a></dt>

+ <dd>Um guia detalhado sobre modelos XUL, que é um meio de gerar conteúdo de uma base de dados.</dd>

+ <dt><a href="/en-US/docs/DragDrop/Drag_and_Drop" title="Drag and Drop">Drag e Drop</a></dt>

+ <dd>Como executar operações de Drag e Drop.</dd>

+ <dt><a href="/en-US/docs/XUL_improvements_in_Firefox_3" title="en-US/docs/XUL_improvements_in_Firefox_3">Adaptando aplicações XUL para o Firefox 3.0</a></dt>

+ <dd>Uma lista de alterações em <a href="/en-US/docs/Firefox_3_for_developers" title="en-US/docs/Firefox_3_for_developers"> Firefox 3.0</a>, afetando os desenvolvedores XUL.</dd>

+ <dt><a href="/en-US/docs/Firefox_2_for_developers#For_XUL_and_extension_developers" title="en-US/docs/Firefox_2_for_developers#For_XUL_and_extension_developers">Adaptando aplicações XUL para o Firefox 2.0</a></dt>

+ <dd>Uma lista de alterações em <a href="/en-US/docs/Firefox_2_for_developers" title="en-US/docs/Firefox_2_for_developers"> Firefox 2.0</a>, afetando os desenvolvedores XUL.</dd>

+ <dt><a href="/en-US/docs/Adapting_XUL_Applications_for_Firefox_1.5" title="en-US/docs/Adapting_XUL_Applications_for_Firefox_1.5">Adaptando aplicações XUL para Firefox 1.5</a></dt>

+ <dd>Uma lista de alterações em <a href="/en-US/docs/Firefox_1.5_for_developers" title="en-US/docs/Firefox_1.5_for_developers">Firefox 1.5</a>, afetando os desenvolvedores XUL.</dd>

+ </dl>

+

+ <p><a href="/en-US/docs/tag/XUL" title="tag/XUL">Veja mais...</a></p>

+ </td>

+ <td>

+ <h2 class="Community" id="Comunidade">Comunidade</h2>

+

+ <ul>

+ <li>Veja os fóruns de Mozilla...{{ DiscussionList("dev-tech-xul", "mozilla.dev.tech.xul") }}</li>

+ <li><a class="link-irc" href="irc://irc.mozilla.org/xul">#xul no irc.mozilla.org</a></li>

+ </ul>

+

+ <h2 class="Tools" id="Ferramentas">Ferramentas</h2>

+

+ <ul>

+ <li><a class="external" href="/en-US/docs/XUL_Explorer" title="en-US/docs/XUL_Explorer">XUL Explorer</a> (uma IDE leve XUL)</li>

+ <li><a href="https://github.com/matthewkastor/XULExplorer" title="https://github.com/matthewkastor/XULExplorer">XULExplorer</a> (Versão remendada do XUL explorer)</li>

+ <li><a class="external" href="http://ted.mielczarek.org/code/mozilla/extensiondev/">Extensão para desenvolvedor de extensão</a> (Apresentando um eficaz Editor XUL)</li>

+ <li><a class="external" href="http://forum.addonsmirror.net/index.php?showtopic=751" title="http://forum.addonsmirror.net/index.php?showtopic=751">XULRef sidebar</a></li>

+ <li><a class="external" href="http://www.getfirebug.com/">Firebug</a></li>

+ <li><a href="/en-US/docs/DOM_Inspector" title="en-US/docs/DOM_Inspector">DOM Inspector</a></li>

+ <li><a class="external" href="http://www.spket.com/">Spket IDE</a>, IDE para XUL/XBL</li>

+ <li><a class="external" href="http://www.amplesdk.com" title="http://www.amplesdk.com/">Ample SDK</a>, (Cross-browser XUL renderizador em JavaScript/HTML )</li>

+ </ul>

+

+ <p><a href="/en-US/docs/tag/tools" title="tag/tools">Veja mais...</a></p>

+

+ <h2 class="Related_Topics" id="Tópicos_Relacionados">Tópicos Relacionados</h2>

+

+ <ul>

+ <li><a href="/en-US/docs/JavaScript" title="en-US/docs/JavaScript">JavaScript</a>, <a href="/en-US/docs/XBL" title="en-US/docs/XBL">XBL</a>, <a href="/en-US/docs/CSS" title="en-US/docs/CSS">CSS</a>, <a href="/en-US/docs/RDF" title="en-US/docs/RDF">RDF</a>, <a href="/en-US/docs/Extensions" title="en-US/docs/Extensions"> Extension</a>, <a href="/en-US/docs/XULRunner" title="en-US/docs/XULRunner">XULRunner</a></li>

+ </ul>

+ </td>

+ </tr>

+ </tbody>

+</table>

+---

+title: Namespaces

+slug: Archive/Mozilla/XUL/Namespaces

+tags:

+ - Add-ons

+ - Extensions

+translation_of: Archive/Mozilla/XUL/Namespaces

+---

+<p> </p>

+

+<p>Em adição a este documento, veja <a href="/pt-BR/docs/Web/SVG/Intensivo_de_Namespaces">Intensivo de Namespaces</a>.</p>

+

+<p><strong>Namespaces em XML</strong> fornecem uma forma de distinguir elementos duplicados e nomes de atributos. Elementos duplicados e nomes de atributos podem ocorrer quando um documento XML contêm elementos de dois ou mais esquemas XML (ou DTDs, Definição de Tipo de Documento). Citando a <a href="https://pt.wikipedia.org/wiki/Espa%C3%A7o_de_nomes">Wikipedia</a>:  "Em geral, um namespace é um recipiente abstrato fornecendo contexto para os itens ... detém e permite desambiguação de itens que tem o mesmo nome."</p>

+

+<p>Se você se sente familiar com namespaces em C++, pacotes Java, pacotes Perl, ou módulo de importação em Python, você já é familiar com o conceito de namespace.</p>

+

+<p>Um namespace é identificado por um nome únco (chamado de URI, não uma URL, apesar de poder parecer com uma URL). Um URI é qualquer string, apesar de que a maioria das pessoas escolhem um URI baseado em uma URL pois URLs são uma forma fácil de esperar por singularidade. Apesarde que não há nada prevenindo alguém de usar o namespace <code>http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul</code>, é bastante improvável que alguém iria escolhê-lo acidentalmente. Mesmo se alguém acidentalmente o escolhe, pode talvez não definir os mesmos elementos como XUL de qualquer forma (e.g., <code>&lt;textbox/&gt;</code>) em seu esquema/DTD.</p>

+

+<p>Qualquer tipo de elemento ou nome de elemento em um namespace XML pode ser identificado por seu namespace XML e seu "nome local". Juntos, estes dois definem um <em>nome qualificado</em>, ou <a class="external" href="http://www.w3.org/TR/REC-xml-names/#dt-qualname">QName</a>.</p>

+

+<p>Por exemplo, <code>&lt;xul:textbox/&gt;</code> usa um namespace chamado "xul" e um nome local "textbox". Isto o distingue de, por exemplo, <code>&lt;foobar:textbox/&gt;</code> que pode ocorrer no mesmo documento. Os namespaces <strong>xul</strong> e <strong>foobar</strong> devem ser definidos no topo do documento XML em que estão sendo usados, como:</p>

+

+<pre> &lt;foobar:algum-elemento

+ xmlns:xul="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"

+ xmlns:foobar="o-namespace-foobar"&gt;

+ &lt;xul:textbox id="foo" value="bar"/&gt;

+ &lt;foobar:textbox comida-favorita="pizza"/&gt;

+ &lt;/foobar:algum-elemento&gt;

+</pre>

+

+<p>Note que misturei dois <code>&lt;textbox/&gt;</code> no mesmo documento. A única forma de distinguir que eles tem significados diferentes é com namespaces.</p>

+

+<p>Há mais uma outra coisa a saber: "namespace padrão", e é usado com elementos XUL por todo o tempo. Em documentos XUL, você normalmente vê isto:</p>

+

+<pre> &lt;window

+ id="foo"

+ xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"&gt;

+ ...

+ ...

+ &lt;/window&gt;

+</pre>

+

+<p>e documentos XHTML você vê isto:</p>

+

+<pre> &lt;html xmlns="http://www.w3.org/1999/xhtml"&gt;

+ ...

+ ...

+ &lt;/html&gt;

+</pre>

+

+<p>Há uma diferença muito sutil aqui em comparação com o anterior. Antes eu escrevi <code>xmlns<strong>:xul</strong>="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"</code> mas aqui a peça <strong>:xul</strong> é omitida. Isto mostra ao analisador XML que <code>http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul</code>é o <strong>namespace padrão</strong> para o elemento e seus elementos descendentes (até que seja substituído posteriormente por um namespace padrão em um elemento descendente), e que qualquer elemento sem um namespace (ex.: sem prefixo e vírgula) pertence ao namespace padrão. Por isto que podemos escrever de forma abreviada <code>&lt;textbox/&gt;</code> ao invés de <code>&lt;xul:textbox/&gt;</code> em XUL (embora o último é tão correcto quando não usamos <code>http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul</code> como namespace padrão) -- o namespace XUL é definido como o padrão no elemento mais elevado. Em outras palavras, um namespace padrão permite um tipo de forma abreviada a ser usada por todos os descendentes de um elemento.</p>

+

+<p>Aqui vai uma pergunta: qual namespace contêm o elemento <code>foo</code> no documento XML abaixo?</p>

+

+<pre> &lt;foo/&gt;

+</pre>

+

+<p>A resposta é que é em <strong>nenhum</strong> namespace, ou alternadamente, está no namespace denotado pela string vazia:</p>

+

+<pre> &lt;foo xmlns=""/&gt;

+</pre>

+

+<p>Este segundo exemplo é semanticamente equivalente ao primeiro. This second example is semantically equivalent to the first.</p>

+

+<p>Agora, uma segunda pergunta: em quais namespaces estão os atributos <code>bar</code>, <code>baz</code> e <code>quux</code>?</p>

+

+<pre> &lt;foo bar="value"&gt;

+ &lt;element xmlns="namespace!" baz="value"&gt;

+ &lt;element quux="value"/&gt;

+ &lt;/element&gt;

+ &lt;/foo&gt;

+</pre>

+

+<p><code>bar</code> não é, obviamente, um namespace. E <code>baz</code> e <code>quux</code>? A resposta é que eles não são um namespace também. Na verdade nenhum atributo não pré-fixado é um namespace, principalmente porque XML originalmente não tinha namespaces, e todos os XML's do tempo tinham que ficar sem namespace. Isto é uma fonte de confusão geral em volta de namespaces em XML.</p>

+---

+title: Navegador

+slug: Archive/Mozilla/XUL/Navegador

+translation_of: Archive/Mozilla/XUL/browser

+---

+<div class="noinclude"><span class="breadcrumbs XULRef_breadcrumbs">

+ « <a href="/pt-BR/docs/XUL_Reference">XUL Reference home</a> [

+ <a href="#Examples">Examples</a> |

+ <a href="#Attributes">Attributes</a> |

+ <a href="#Properties">Properties</a> |

+ <a href="#Methods">Methods</a> |

+ <a href="#Related">Related</a> ]

+</span></div>

+

+<p>Um quadro que deverá conter uma visão de um documento da Web. É semelhante a <code><a href="/pt-BR/docs/Mozilla/Tech/XUL/iframe" title="iframe">iframe</a></code>, exceto que ele contém um histórico de páginas e contém métodos adicionais para manipular a página atualmente exibida.</p>

+

+<p>A maioria das propriedades e métodos do navegador raramente serão usados e só podem ser chamados de Chrome URLs. Outros URLs precisarão usar os objetos do documento e do histórico para alterar o documento exibido.</p>

+

+<dl>

+ <dt>Atributos</dt>

+ <dd><a href="#a-autocompleteenabled">autocompleteenabled</a>, <a href="#a-autocompletepopup">autocompletepopup</a>, <a href="#a-autoscroll">autoscroll</a>, <a href="#a-disablehistory">disablehistory</a>, <a href="#a-disableglobalhistory">disableglobalhistory</a>, <a href="#a-disablesecurity">disablesecurity</a>, <a href="#a-droppedLinkHandler">droppedLinkHandler</a>, <a href="#a-homepage">homepage</a>, <a href="#a-remote">remote</a>,<a href="#a-showcaret">showcaret</a>, <a href="#a-src">src</a>, <a href="#a-browser.type">type</a></dd>

+</dl>

+

+<dl>

+ <dt>Propriedades</dt>

+ <dd><a href="#p-accessibleType">accessibleType</a>, <a href="#p-canGoBack">canGoBack</a>, <a href="#p-canGoForward">canGoForward</a>, <a href="#p-contentDocument">contentDocument</a>, <a href="#p-contentPrincipal">contentPrincipal</a>, <a href="#p-contentTitle">contentTitle</a>, <a href="#p-contentViewerEdit">contentViewerEdit</a>, <a href="#p-contentViewerFile">contentViewerFile</a>, <a href="#p-contentWindow">contentWindow</a>, <a href="#p-currentURI">currentURI</a>, <a href="#p-docShell">docShell</a>, <a href="#p-documentCharsetInfo">documentCharsetInfo</a>, <a href="#p-homePage">homePage</a>, <a href="#p-markupDocumentViewer">markupDocumentViewer</a>, <a href="#p-messageManager">messageManager</a>, <a href="#p-browser.preferences">preferences</a>, <a href="#p-securityUI">securityUI</a>, <a href="#p-sessionHistory">sessionHistory</a>, <a href="#p-webBrowserFind">webBrowserFind</a>, <a href="#p-webNavigation">webNavigation</a>, <a href="#p-webProgress">webProgress</a></dd>

+</dl>

+

+<dl>

+ <dt>Métodos</dt>

+ <dd><a href="#m-addProgressListener">addProgressListener</a>, <a href="#m-goBack">goBack</a>, <a href="#m-goForward">goForward</a>, <a href="#m-goHome">goHome</a>, <a href="#m-gotoIndex">gotoIndex</a>, <a href="#m-loadURI">loadURI</a>, <a href="#m-loadURIWithFlags">loadURIWithFlags</a>, <a href="#m-reload">reload</a>, <a href="#m-reloadWithFlags">reloadWithFlags</a>, <a href="#m-removeProgressListener">removeProgressListener</a>, <a href="#m-stop">stop</a>, <a href="#m-swapDocShells">swapDocShells</a></dd>

+</dl>

+

+<h3 id="Examples" name="Examples">Exemplos</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;!-- Mostra a página inicial do Mozilla dentro de um 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">Atributos</h3>

+

+

+

+<div id="a-autocompleteenabled">

+

+

+<dl>

+ <dt><code id="a-autocompleteenabled"><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Attribute/autocompleteenabled">autocompleteenabled</a></code></dt>

+ <dd>Type: <em>boolean</em></dd>

+ <dd>Set to <code>true</code> to enable autocomplete of fields.</dd>

+</dl>

+</div> <div id="a-autocompletepopup">

+

+<dl>

+ <dt>

+ <code id="a-autocompletepopup"><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Attribute/autocompletepopup">autocompletepopup</a></code></dt>

+ <dd>

+ Type: <em>id</em></dd>

+ <dd>

+ The <code id="a-id"><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Attribute/id">id</a></code> of a <code><a href="/en-US/docs/Mozilla/Tech/XUL/popup" title="popup">popup</a></code> element used to hold autocomplete results for the element.</dd>

+</dl>

+

+</div> <div id="a-autoscroll">

+

+

+<dl>

+ <dt><code id="a-autoscroll"><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Attribute/autoscroll">autoscroll</a></code></dt>

+ <dd>Type: <em>boolean</em></dd>

+ <dd>Set to <code>false</code> to disable autoscroll for this browser. If this attribute is set to <code>true</code> or omitted, autoscroll will be enabled or depending on the user preference <code>general.autoScroll</code>.</dd>

+</dl>

+</div> <div id="a-disablehistory">

+

+<dl> <dt><code id="a-disablehistory"><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Attribute/disablehistory">disablehistory</a></code></dt> <dd>Type: <em>boolean</em></dd> <dd>Disables both session and global history for the docshell attached to the browser.</dd>

+</dl>

+</div> <div id="a-disableglobalhistory">

+

+<dl> <dt><code id="a-disableglobalhistory"><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Attribute/disableglobalhistory">disableglobalhistory</a></code></dt> <dd>Type: <em>boolean</em></dd> <dd>Disables global history for the docshell attached to the browser while keeping session history active.</dd>

+</dl>

+</div> <div id="a-disablesecurity">

+

+

+<dl>

+ <dt><code id="a-disablesecurity"><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Attribute/disablesecurity">disablesecurity</a></code></dt>

+ <dd>Type: <em>boolean</em></dd>

+ <dd>Set this attribute to <code>true</code> to disable the security UI for this browser. Omit this attribute off to enable it.</dd>

+</dl>

+</div> <div id="a-droppedLinkHandler">

+

+

+<dl>

+ <dt><code id="a-droppedLinkHandler"><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Attribute/droppedLinkHandler">droppedLinkHandler</a></code></dt>

+ <dd>Type: <em>function</em></dd>

+ <dd>

+ <p>This function is called when links are dropped to the <a href="/en-US/docs/Mozilla/Tech/XUL/browser">browser</a> element, with the following arguments.</p>

+

+ <pre>droppedLinkHandler(event, uri, name) -- Firefox 51 or older

+droppedLinkHandler(event, links) -- Firefox 52 or newer</pre>

+

+ <ul>

+ <li><code>event</code> -- drop event, or <code>null</code> if no event is available</li>

+ <li><code>uri</code> -- uri string of the dropped link</li>

+ <li><code>name</code> -- name string of the dropped link</li>

+ <li><code>links</code> -- array of the dropped items with <a href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIDroppedLinkItem" title="nsIDroppedLinkItem">nsIDroppedLinkItem</a> interface</li>

+ </ul>

+ </dd>

+</dl>

+</div> <div id="a-homepage">

+

+

+<dl>

+ <dt><code id="a-homepage"><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Attribute/homepage">homepage</a></code></dt>

+ <dd>Type: <em>URL</em></dd>

+ <dd>This attribute allows you to set a homepage for the browser element. It does not have any correlation with the user's browser homepage; instead it is a convenient property to hold a home page. You can switch to this home page using the <span id="m-goHome"><code><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Method/goHome">goHome</a></code></span> method.</dd>

+</dl>

+</div> <div id="a-remote">

+

+<dl>

+ <dt>

+ <code id="a-remote"><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Attribute/remote">remote</a></code></dt>

+ <dd>

+ Type:<em> Boolean</em></dd>

+ <dd>

+ If true, the content of the XUL &lt;browser&gt; will be processed inside its own process. The document is then accessible from the chrome content only through <a href="/en-US/docs/The_message_manager" title="/en-US/docs/The_message_manager">the message manager</a>.</dd>

+</dl>

+</div> <div id="a-showcaret">

+

+

+<dl>

+ <dt><code id="a-showcaret"><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Attribute/showcaret">showcaret</a></code></dt>

+ <dd>Type: <em>boolean</em></dd>

+ <dd>Whether or not to cause a typing caret to be visible in the content area. Default is <code>false</code>.</dd>

+</dl>

+

+

+</div> <div id="a-src">

+

+<dl>

+ <dt>

+ <code id="a-src"><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Attribute/src">src</a></code></dt>

+ <dd>

+ Type: <em>URI</em></dd>

+ <dd>

+ The URI of the content to appear in the element.</dd>

+</dl>

+

+

+</div><div id="a-browser.type">

+

+

+<dl>

+ <dt><code id="a-browser.type"><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Attribute/browser.type">type</a></code></dt>

+ <dd><span class="seoSummary">Type: <em>one of the values below</em>.</span></dd>

+ <dd><span class="seoSummary">The type of browser, which can be used to set access of the document loaded inside the browser.</span> If this is not set, the loaded document has the same access as the window containing the <code><code><a href="/en-US/docs/Mozilla/Tech/XUL/browser" title="browser">browser</a></code></code>. More precisely: The document loaded into a chrome window is always of chrome type. Subdocuments of chrome documents are of chrome type, unless the container element (one of iframe, browser or editor) has one of the special type attribute values (the common ones are content, content-targetable and content-primary) indicating that the subdocument is of content type. This boundary has a number of special effects, such as making window.top == window (unless the <code><code><a href="/en-US/docs/Mozilla/Tech/XUL/browser" title="browser">browser</a></code></code> is added to a chrome document), and preventing documents from inheriting the principal of the parent document. The type attribute on all frames in content documents is ignored; subdocuments of content documents are always content documents.</dd>

+ <dt>

+ <div class="warning"><strong>Warning: </strong>The type attribute must be set before the element is inserted into the document.</div>

+ </dt>

+ <dd>

+ <dl>

+ <dt><code>content</code></dt>

+ <dd>A browser for content. The content that is loaded inside the browser is not allowed to access the chrome above it.</dd>

+ <dt><code>content-primary</code></dt>

+ <dd>The primary browser for content. The content that is loaded inside the browser is not allowed to access the chrome above it. For instance, in a web browser, this would be the element that displays the web page. The window for the primary content can be retrieved more conveniently using <a href="/en/DOM/window.content" title="en/DOM/window.content">window.content</a>.</dd>

+ <dt><code>content-targetable</code></dt>

+ <dd>One browser among many for content. The content that is loaded inside the browser is not allowed to access the chrome above it. This is the preferred value for any <code><code><a href="/en-US/docs/Mozilla/Tech/XUL/browser" title="browser">browser</a></code></code> element in an application, which will use multiple browsers of equal privileges, and is unselected at the moment.</dd>

+ <dt><code>chrome</code></dt>

+ <dd>(default behaviour): A browser, intended to be used for loading privileged content using a chrome:// URI. Don't use for content from web, as this may cause serious security problems!</dd>

+ </dl>

+ </dd>

+</dl>

+

+

+</div>

+

+<h3 id="Properties" name="Properties">Propriedades</h3>

+

+

+

+<div id="p-accessibleType">

+<dl>

+ <dt>

+ <code><span><a href="https://developer.mozilla.org/en-US/docs/XUL/Property/accessibleType">accessibleType</a></span></code></dt>

+ <dd>

+ Type: <em>integer</em></dd>

+ <dd>

+ A value indicating the type of accessibility object for the element.</dd>

+</dl>

+</div> <div id="p-canGoBack">

+<dl>

+ <dt>

+ <code><span><a href="https://developer.mozilla.org/en-US/docs/XUL/Property/canGoBack">canGoBack</a></span></code></dt>

+ <dd>

+ Type: <em>boolean</em></dd>

+ <dd>

+ This read-only property is <code>true</code> if there is a page to go back to in the session history and the Back button should be enabled.</dd>

+</dl></div> <div id="p-canGoForward">

+

+<dl>

+ <dt><code><span><a href="https://developer.mozilla.org/en-US/docs/XUL/Property/canGoForward">canGoForward</a></span></code></dt>

+ <dd>Type: <em>boolean</em></dd>

+ <dd>This read-only property is <code>true</code> if there is a page to go forward to in the session history and the Forward button should be enabled.</dd>

+</dl></div> <div id="p-contentDocument">

+<dl>

+ <dt>

+ <code><span><a href="https://developer.mozilla.org/en-US/docs/XUL/Property/contentDocument">contentDocument</a></span></code></dt>

+ <dd>

+ Type: <em>document</em></dd>

+ <dd>

+ This read-only property contains the document object in the element.</dd>

+</dl></div> <div id="p-contentPrincipal">

+

+<dl>

+ <dt><code><span><a href="https://developer.mozilla.org/en-US/docs/XUL/Property/contentPrincipal">contentPrincipal</a></span></code></dt>

+ <dd>Type: <em><code><a href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIPrincipal" title="">nsIPrincipal</a></code></em></dd>

+ <dd>This read-only property contains the principal for the content loaded in the browser, which provides security context information.</dd>

+</dl></div> <div id="p-contentTitle">

+<dl>

+ <dt>

+ <code><span><a href="https://developer.mozilla.org/en-US/docs/XUL/Property/contentTitle">contentTitle</a></span></code></dt>

+ <dd>

+ Type: <em>string</em></dd>

+ <dd>

+ This read-only property contains the title of the document object in the browser.</dd>

+</dl></div> <div id="p-contentViewerEdit">

+<dl>

+ <dt>

+ <code><span><a href="https://developer.mozilla.org/en-US/docs/XUL/Property/contentViewerEdit">contentViewerEdit</a></span></code></dt>

+ <dd>

+ Type: <em><code><a href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIContentViewerEdit" title="">nsIContentViewerEdit</a></code></em></dd>

+ <dd>

+ This read-only property contains the <code><a href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIContentViewerEdit" title="">nsIContentViewerEdit</a></code> which handles clipboard operations on the document.</dd>

+</dl></div> <div id="p-contentViewerFile">

+<dl>

+ <dt>

+ <code><span><a href="https://developer.mozilla.org/en-US/docs/XUL/Property/contentViewerFile">contentViewerFile</a></span></code></dt>

+ <dd>

+ Type: <em><code><a href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIContentViewerFile" title="">nsIContentViewerFile</a></code></em></dd>

+ <dd>

+ Reference to the <code><a href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIContentViewerFile" title="">nsIContentViewerFile</a></code> interface for the document.</dd>

+</dl></div> <div id="p-contentWindow">

+<dl> <dt><code><span><a href="https://developer.mozilla.org/en-US/docs/XUL/Property/contentWindow">contentWindow</a></span></code></dt> <dd>Type: <em>TODO</em></dd> <dd>Use the contentWindow.wrappedJSObject to obtain a DOM(html) window object</dd>

+</dl></div> <div id="p-currentURI">

+<dl>

+ <dt>

+ <code><span><a href="https://developer.mozilla.org/en-US/docs/XUL/Property/currentURI">currentURI</a></span></code></dt>

+ <dd>

+ Type: <em><code><a href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIURI" title="">nsIURI</a></code></em></dd>

+ <dd>

+ This read-only property contains the currently loaded URL. To change the URL, use the <span id="m-loadURI"><code><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Method/loadURI">loadURI</a></code></span> method.</dd>

+</dl></div> <div id="p-docShell">

+<dl>

+ <dt>

+ <code><span><a href="https://developer.mozilla.org/en-US/docs/XUL/Property/docShell">docShell</a></span></code></dt>

+ <dd>

+ Type: <em><code><a href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIDocShell" title="">nsIDocShell</a></code></em></dd>

+ <dd>

+ This read-only property contains the <code><a href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIDocShell" title="">nsIDocShell</a></code> object for the document.</dd>

+</dl></div> <div id="p-documentCharsetInfo">

+<dl>

+ <dt>

+ <code><span><a href="https://developer.mozilla.org/en-US/docs/XUL/Property/documentCharsetInfo">documentCharsetInfo</a></span></code> <span class="inlineIndicator obsolete obsoleteInline" title="(Firefox 12.0 / Thunderbird 12.0 / SeaMonkey 2.9)">Obsolete since Gecko 12.0</span></dt>

+ <dd>

+ Type: <em><code><a href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIDocumentCharsetInfo" title="">nsIDocumentCharsetInfo</a></code></em></dd>

+ <dd>

+ This read-only property contains the <code><a href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIDocumentCharsetInfo" title="">nsIDocumentCharsetInfo</a></code> object for the document which is used to handle which character set should be used to display the document. The properties of the <code><a href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIDocumentCharsetInfo" title="">nsIDocumentCharsetInfo</a></code> object were merged into the docshell in Gecko 12.0 (Firefox 12.0 / Thunderbird 12.0 / SeaMonkey 2.9).</dd>

+</dl></div> <div id="p-homePage">

+<dl>

+ <dt>

+ <code><span><a href="https://developer.mozilla.org/en-US/docs/XUL/Property/homePage">homePage</a></span></code></dt>

+ <dd>

+ Type: <em>string home page URL</em></dd>

+ <dd>

+ This property holds the value of the user's home page setting.</dd>

+</dl></div> <div id="p-markupDocumentViewer">

+<dl>

+ <dt>

+ <code><span><a href="https://developer.mozilla.org/en-US/docs/XUL/Property/markupDocumentViewer">markupDocumentViewer</a></span></code></dt>

+ <dd>

+ Type: <em><code><a href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIMarkupDocumentViewer" title="">nsIMarkupDocumentViewer</a></code></em></dd>

+ <dd>

+ This read-only property contains the <code><a href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIMarkupDocumentViewer" title="">nsIMarkupDocumentViewer</a></code> which is responsible for drawing the document.</dd>

+</dl></div> <div id="p-messageManager">

+<dl>

+ <dt>

+ <code><span><a href="https://developer.mozilla.org/en-US/docs/XUL/Property/messageManager">messageManager</a></span></code> </dt>

+ <dd>

+ Type: <em>message manager object</em></dd>

+ <dd>

+ This read-only property returns the <a href="/en/The_message_manager" title="en/The message manager">message manager</a> object for the <code><a href="/en-US/docs/Mozilla/Tech/XUL/browser" title="browser">browser</a></code> element.</dd>

+</dl></div> <div id="p-browser.preferences">

+<dl>

+ <dt>

+ <code><span><a href="https://developer.mozilla.org/en-US/docs/XUL/Property/browser.preferences">preferences</a></span></code></dt>

+ <dd>

+ Type: <em><code><a href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIPrefService" title="">nsIPrefService</a></code></em></dd>

+ <dd>

+ This read-only property contains an <code><a href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIPref" title="">nsIPref</a></code> object for getting and setting user preferences.</dd>

+</dl></div> <div id="p-securityUI">

+<dl>

+ <dt>

+ <code><span><a href="https://developer.mozilla.org/en-US/docs/XUL/Property/securityUI">securityUI</a></span></code></dt>

+ <dd>

+ Type: <em><code><a href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsISecureBrowserUI" title="">nsISecureBrowserUI</a></code></em></dd>

+ <dd>

+ The read-only property holds an object which may be used to determine the security level of the loaded document.</dd>

+</dl></div> <div id="p-sessionHistory">

+<dl>

+ <dt>

+ <code><span><a href="https://developer.mozilla.org/en-US/docs/XUL/Property/sessionHistory">sessionHistory</a></span></code></dt>

+ <dd>

+ Type: <em><code><a href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsISHistory" title="">nsISHistory</a></code></em></dd>

+ <dd>

+ This read-only property contains the <code><a href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsISHistory" title="">nsISHistory</a></code> object which holds the session history.</dd>

+</dl></div> <div id="p-webBrowserFind">

+<dl>

+ <dt>

+ <code><span><a href="https://developer.mozilla.org/en-US/docs/XUL/Property/webBrowserFind">webBrowserFind</a></span></code></dt>

+ <dd>

+ Type: <em><code><a href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIWebBrowserFind" title="">nsIWebBrowserFind</a></code></em></dd>

+ <dd>

+ This read-only property contains an <code><a href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIWebBrowserFind" title="">nsIWebBrowserFind</a></code> object which can be used to search for text in the document.</dd>

+</dl></div> <div id="p-webNavigation">

+<dl>

+ <dt>

+ <code><span><a href="https://developer.mozilla.org/en-US/docs/XUL/Property/webNavigation">webNavigation</a></span></code></dt>

+ <dd>

+ Type: <em><code><a href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIWebNavigation" title="">nsIWebNavigation</a></code></em></dd>

+ <dd>

+ This read-only property contains the <code><a href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIWebNavigation" title="">nsIWebNavigation</a></code> object for the document. Most of its methods are callable directly on the element itself, such as <span id="m-goBack"><code><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Method/goBack">goBack</a></code></span> and <span id="m-goForward"><code><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Method/goForward">goForward</a></code></span>. It also contains the load constants used by <span id="m-reloadWithFlags"><code><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Method/reloadWithFlags">reloadWithFlags</a></code></span> and <span id="m-loadURIWithFlags"><code><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Method/loadURIWithFlags">loadURIWithFlags</a></code></span>.</dd>

+</dl></div> <div id="p-webProgress">

+<dl>

+ <dt>

+ <code><span><a href="https://developer.mozilla.org/en-US/docs/XUL/Property/webProgress">webProgress</a></span></code></dt>

+ <dd>

+ Type: <em><code><a href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIWebProgress" title="">nsIWebProgress</a></code></em></dd>

+ <dd>

+ This read-only property contains an <code><a href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIWebProgress" title="">nsIWebProgress</a></code> object which is used to monitor the progress of a document loading.</dd>

+</dl></div>

+

+<h3 id="Methods" name="Methods">Métodos</h3>

+

+<table style="border: 1px solid rgb(204, 204, 204); margin: 0 0 10px 10px; padding: 0 10px; background: rgb(238, 238, 238); float: right; width: 250px;">

+<tbody>

+<tr>

+<td>

+<p><strong>Inherited Methods</strong><br>

+<small><code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.addEventListener">addEventListener()</a></code>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.appendChild">appendChild()</a></code>, <span id="m-blur"><code><a href="https://developer.mozilla.org/pt-BR/docs/Mozilla/Tech/XUL/Method/blur">blur</a></code></span>, <span id="m-click"><code><a href="https://developer.mozilla.org/pt-BR/docs/Mozilla/Tech/XUL/Method/click">click</a></code></span>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.cloneNode">cloneNode()</a></code>, <a href="/En/DOM/Node.compareDocumentPosition" title="En/DOM/Node.compareDocumentPosition">compareDocumentPosition</a>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.dispatchEvent">dispatchEvent()</a></code>, <span id="m-doCommand"><code><a href="https://developer.mozilla.org/pt-BR/docs/Mozilla/Tech/XUL/Method/doCommand">doCommand</a></code></span>, <span id="m-focus"><code><a href="https://developer.mozilla.org/pt-BR/docs/Mozilla/Tech/XUL/Method/focus">focus</a></code></span>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.getAttribute">getAttribute()</a></code>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.getAttributeNode">getAttributeNode()</a></code>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.getAttributeNodeNS">getAttributeNodeNS()</a></code>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.getAttributeNS">getAttributeNS()</a></code>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.getBoundingClientRect">getBoundingClientRect()</a></code>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.getClientRects">getClientRects()</a></code>, <span id="m-getElementsByAttribute"><code><a href="https://developer.mozilla.org/pt-BR/docs/Mozilla/Tech/XUL/Method/getElementsByAttribute">getElementsByAttribute</a></code></span>, <span id="m-getElementsByAttributeNS"><code><a href="https://developer.mozilla.org/pt-BR/docs/Mozilla/Tech/XUL/Method/getElementsByAttributeNS">getElementsByAttributeNS</a></code></span>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.getElementsByClassName">getElementsByClassName()</a></code>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.getElementsByTagName">getElementsByTagName()</a></code>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.getElementsByTagNameNS">getElementsByTagNameNS()</a></code>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.getFeature">getFeature()</a></code>, <a href="/En/DOM/Node.getUserData" title="En/DOM/Node.getUserData">getUserData</a>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.hasAttribute">hasAttribute()</a></code>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.hasAttributeNS">hasAttributeNS()</a></code>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.hasAttributes">hasAttributes()</a></code>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.hasChildNodes">hasChildNodes()</a></code>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.insertBefore">insertBefore()</a></code>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.isDefaultNamespace">isDefaultNamespace()</a></code>, <a href="/En/DOM/Node.isEqualNode" title="En/DOM/Node.isEqualNode">isEqualNode</a>, <a href="/En/DOM/Node.isSameNode" title="En/DOM/Node.isSameNode">isSameNode</a>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.isSupported">isSupported()</a></code>, <a href="/En/DOM/Node.lookupNamespaceURI" title="En/DOM/Node.lookupNamespaceURI">lookupNamespaceURI</a>, <a href="/En/DOM/Node.lookupPrefix" title="En/DOM/Node.lookupPrefix">lookupPrefix</a>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.normalize">normalize()</a></code>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.querySelector">querySelector()</a></code>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.querySelectorAll">querySelectorAll()</a></code>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.removeAttribute">removeAttribute()</a></code>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.removeAttributeNode">removeAttributeNode()</a></code>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.removeAttributeNS">removeAttributeNS()</a></code>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.removeChild">removeChild()</a></code>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.removeEventListener">removeEventListener()</a></code>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.replaceChild">replaceChild()</a></code>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.setAttribute">setAttribute()</a></code>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.setAttributeNode">setAttributeNode()</a></code>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.setAttributeNodeNS">setAttributeNodeNS()</a></code>, <code><a href="https://developer.mozilla.org/pt-BR/docs/DOM/element.setAttributeNS">setAttributeNS()</a></code>, <a href="/En/DOM/Node.setUserData" title="En/DOM/Node.setUserData">setUserData</a></small></p>

+

+</td>

+</tr>

+</tbody>

+</table>

+

+<dl>

+ <dt>

+ <span id="m-addProgressListener"><code><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Method/addProgressListener">addProgressListener( listener )</a></code></span></dt>

+ <dd>

+ Return type: <em>no return value</em></dd>

+ <dd>

+ Add a progress listener to the browser which will monitor loaded documents. The progress listener should implement the <code><a href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIWebProgressListener" title="">nsIWebProgressListener</a></code> interface.</dd>

+</dl> <dl>

+ <dt><span id="m-goBack"><code><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Method/goBack">goBack()</a></code></span></dt>

+ <dd>Return type: <em>no return value</em></dd>

+ <dd>Go back one page in the history.</dd>

+</dl> <dl>

+ <dt><span id="m-goForward"><code><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Method/goForward">goForward()</a></code></span></dt>

+ <dd>Return type: <em>no return value</em></dd>

+ <dd>Go forward one page in the history.</dd>

+</dl> <dl>

+ <dt><span id="m-goHome"><code><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Method/goHome">goHome()</a></code></span></dt>

+ <dd>Return type: <em>no return value</em></dd>

+ <dd>Load the user's home page into the browser.</dd>

+</dl> <dl>

+ <dt><span id="m-gotoIndex"><code><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Method/gotoIndex">gotoIndex( index )</a></code></span></dt>

+ <dd>Return type: <em>no return value</em></dd>

+ <dd>Navigate to the page in the history with the given index. Use a positive number to go forward and a negative number to go back.</dd>

+</dl> <p><span class="comment">NOTE: This is the XUL method on &lt;browser&gt; / &lt;tabbrowser&gt;, not the global function in <a class="external" rel="freelink">chrome://browser/content/browser.js</a>. Please check which one you're documenting! (This one has no post data parameter, see loadURIWithFlags for a version that does)</span></p>

+<dl>

+ <dt>

+ <span id="m-loadURI"><code><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Method/loadURI">loadURI( uri, referrer, charset )</a></code></span></dt>

+ <dd>

+ Return type: <em>no return value</em></dd>

+ <dd>

+ Load a URL into the document, with the given referrer and character set.</dd>

+ <dd>

+ The first argument should be a string, not a <code><a href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIURI" title="">nsIURI</a></code> object. To get a string from an <code><a href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIURI" title="">nsIURI</a></code>, use <code>nsIURI.spec</code> or <code>nsIURI.asciiSpec</code></dd>

+</dl> <dl>

+ <dt><span id="m-loadURIWithFlags"><code><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Method/loadURIWithFlags">loadURIWithFlags( uri, flags, referrer, charset, postData )</a></code></span></dt>

+ <dd>Return type: <em>no return value</em></dd>

+ <dd>Load a URL into the document, with the specified load flags, the given referrer, character set, and POST data. In addition to the flags allowed for the <span id="m-reloadWithFlags"><code><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Method/reloadWithFlags">reloadWithFlags</a></code></span> method, the following flags are also valid:

+ <ul>

+ <li><code>LOAD_FLAGS_IS_REFRESH</code>: This flag is used when the URL is loaded because of a meta tag refresh or redirect.</li>

+ <li><code>LOAD_FLAGS_IS_LINK</code>: This flag is used when the URL is loaded because a user clicked on a link. The HTTP Referer header is set accordingly.</li>

+ <li><code>LOAD_FLAGS_BYPASS_HISTORY</code>: Do not add the URL to the session history.</li>

+ <li><code>LOAD_FLAGS_REPLACE_HISTORY</code>: Replace the current URL in the session history with a new one. This flag might be used for a redirect.</li>

+ </ul>

+ </dd>

+</dl>

+

+<p>(See <code><a href="https://developer.mozilla.org/en-US/docs/XPCOM_Interface_Reference/nsIWebNavigation#loadURI()">nsIWebNavigation.loadURI()</a></code> for details on the <code>referrer</code> and <code>postData</code> parameters.)</p> <dl>

+ <dt><span id="m-reload"><code><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Method/reload">reload()</a></code></span></dt>

+ <dd>Return type: <em>no return value</em></dd>

+ <dd>Reloads the document in the <code><a href="/en-US/docs/Mozilla/Tech/XUL/browser" title="browser">browser</a></code> element on which you call this method.</dd>

+</dl> <dl>

+ <dt><span id="m-reloadWithFlags"><code><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Method/reloadWithFlags">reloadWithFlags( flags )</a></code></span></dt>

+ <dd>Return type: <em>no return value</em></dd>

+ <dd>Reloads the document in the browser with the given load flags. The flags listed below may be used, which are all constants of the <code><span><a href="https://developer.mozilla.org/en-US/docs/XUL/Property/webNavigation">webNavigation</a></span></code> property (or the <code><a href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIWebNavigation" title="">nsIWebNavigation</a></code> interface). You may combine flags using a or symbol ( <code>|</code> ).

+ <ul>

+ <li><code>LOAD_FLAGS_NONE</code>: No special flags. The document is loaded normally.</li>

+ <li><code>LOAD_FLAGS_BYPASS_CACHE</code>: Reload the page, ignoring if it is already in the cache. This is the flag used when the reload button is pressed while the Shift key is held down.</li>

+ <li><code>LOAD_FLAGS_BYPASS_PROXY</code>: Reload the page, ignoring the proxy server.</li>

+ <li><code>LOAD_FLAGS_CHARSET_CHANGE</code>: This flag is used if the document needs to be reloaded because the character set changed.</li>

+ </ul>

+ </dd>

+</dl> <dl>

+ <dt><span id="m-removeProgressListener"><code><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Method/removeProgressListener">removeProgressListener( listener )</a></code></span></dt>

+ <dd>Return type: <em>no return value</em></dd>

+ <dd>Remove a <code><a href="/en-US/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIWebProgressListener" title="">nsIWebProgressListener</a></code> from the browser.</dd>

+</dl> <dl>

+ <dt>

+ <span id="m-stop"><code><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Method/stop">stop()</a></code></span></dt>

+ <dd>

+ Return type: <em>no return value</em></dd>

+ <dd>

+ Equivalent to pressing the Stop button, this method stops the currently loading document.</dd>

+</dl> <dl>

+ <dt>

+ <span id="m-swapDocShells"><code><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/Method/swapDocShells">swapDocShells( otherBrowser )</a></code></span></dt>

+ <dd>

+ Return type: <em>no return value</em></dd>

+ <dd>

+ Swaps the content, history and current state of this <code><a href="/en-US/docs/Mozilla/Tech/XUL/browser" title="browser">browser</a></code> with another browser. During the swap, pagehide and pageshow events are fired on both browsers. This method can be used to move browser between windows or tear off a browser into a new window.</dd>

+</dl>

+

+<div class="note">

+<p><strong>Note:</strong> Both browsers must be either standalone browsers or embedded in a <a href="/en-US/docs/XUL/tabbrowser"><code>tabbrowser</code></a>. You can't mix them.</p></div>

+

+<h3 id="Related" name="Related">Relações</h3>

+

+<dl>

+ <dt>Interfaces</dt>

+ <dd><code><a href="/pt-BR/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIAccessibleProvider" title="">nsIAccessibleProvider</a></code></dd>

+</dl>

+---

+title: XUL Tutorial

+slug: Archive/Mozilla/XUL/Tutorial

+tags:

+ - NeedsTranslation

+ - TopicStub

+ - Tutorials

+ - XUL

+ - XUL_Tutorial

+translation_of: Archive/Mozilla/XUL/Tutorial

+---

+<p>This tutorial describes <a href="/en-US/docs/XUL" title="/en-US/docs/XUL">XUL</a>, the <a href="/en-US/docs/XML" title="/en-US/docs/XML">XML</a> User-interface Language. This language was created for the Mozilla application and is used to describe its user interface.</p>

+<h2 id="Introduction" name="Introduction">Introduction</h2>

+<ul>

+ <li><a href="/en-US/docs/XUL/Tutorial/Introduction" title="/en-US/docs/XUL/Tutorial/Introduction">Introduction</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/XUL_Structure" title="/en-US/docs/XUL/Tutorial/XUL_Structure">XUL Structure</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/The_Chrome_URL" title="/en-US/docs/XUL/Tutorial/The_Chrome_URL">The Chrome URL</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Manifest_Files" title="/en-US/docs/XUL/Tutorial/Manifest_Files">Manifest Files</a></li>

+</ul>

+<h2 id="Simple_Elements" name="Simple_Elements">Simple Elements</h2>

+<ul>

+ <li><a href="/en-US/docs/XUL/Tutorial/Creating_a_Window" title="/en-US/docs/XUL/Tutorial/Creating_a_Window">Creating a Window</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Adding_Buttons" title="/en-US/docs/XUL/Tutorial/Adding_Buttons">Adding Buttons</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Adding_Labels_and_Images" title="/en-US/docs/XUL/Tutorial/Adding_Labels_and_Images">Adding Labels and Images</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Input_Controls" title="/en-US/docs/XUL/Tutorial/Input_Controls">Input Controls</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Numeric_Controls" title="/en-US/docs/XUL/Tutorial/Numeric_Controls">Numeric Controls</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/List_Controls" title="/en-US/docs/XUL/Tutorial/List_Controls">List Controls</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Progress_Meters" title="/en-US/docs/XUL/Tutorial/Progress_Meters">Progress Meters</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Adding_HTML_Elements" title="/en-US/docs/XUL/Tutorial/Adding_HTML_Elements">Adding HTML Elements</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Using_Spacers" title="/en-US/docs/XUL/Tutorial/Using_Spacers">Using Spacers</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/More_Button_Features" title="/en-US/docs/XUL/Tutorial/More_Button_Features">More Button Features</a></li>

+</ul>

+<h2 id="The_Box_Model" name="The_Box_Model">The Box Model</h2>

+<ul>

+ <li><a href="/en-US/docs/XUL/Tutorial/The_Box_Model" title="/en-US/docs/XUL/Tutorial/The_Box_Model">The Box Model</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Element_Positioning" title="/en-US/docs/XUL/Tutorial/Element_Positioning">Element Positioning</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Box_Model_Details" title="/en-US/docs/XUL/Tutorial/Box_Model_Details">Box Model Details</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Groupboxes" title="/en-US/docs/XUL/Tutorial/Groupboxes">Groupboxes</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Adding_More_Elements" title="/en-US/docs/XUL/Tutorial/Adding_More_Elements">Adding More Elements</a></li>

+</ul>

+<h2 id="More_Layout_Elements" name="More_Layout_Elements">More Layout Elements</h2>

+<ul>

+ <li><a href="/en-US/docs/XUL/Tutorial/Stacks_and_Decks" title="/en-US/docs/XUL/Tutorial/Stacks_and_Decks">Stacks and Decks</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Stack_Positioning" title="/en-US/docs/XUL/Tutorial/Stack_Positioning">Stack Positioning</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Tabboxes" title="/en-US/docs/XUL/Tutorial/Tabboxes">Tabboxes</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Grids" title="/en-US/docs/XUL/Tutorial/Grids">Grids</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Content_Panels" title="/en-US/docs/XUL/Tutorial/Content_Panels">Content Panels</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Splitters" title="/en-US/docs/XUL/Tutorial/Splitters">Splitters</a></li>

+</ul>

+<h2 id="Toolbars_and_Menus" name="Toolbars_and_Menus">Toolbars and Menus</h2>

+<ul>

+ <li><a href="/en-US/docs/XUL/Tutorial/Toolbars" title="/en-US/docs/XUL/Tutorial/Toolbars">Toolbars</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Simple_Menu_Bars" title="/en-US/docs/XUL/Tutorial/Simple_Menu_Bars">Simple Menu Bars</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/More_Menu_Features" title="/en-US/docs/XUL/Tutorial/More_Menu_Features">More Menu Features</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Popup_Menus" title="/en-US/docs/XUL/Tutorial/Popup_Menus">Popup Menus</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Scrolling_Menus" title="/en-US/docs/XUL/Tutorial/Scrolling_Menus">Scrolling Menus</a></li>

+</ul>

+<h2 id="Events_and_Scripts" name="Events_and_Scripts">Events and Scripts</h2>

+<ul>

+ <li><a href="/en-US/docs/XUL/Tutorial/Adding_Event_Handlers" title="/en-US/docs/XUL/Tutorial/Adding_Event_Handlers">Adding Event Handlers</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/More_Event_Handlers" title="/en-US/docs/XUL/Tutorial/More_Event_Handlers">More Event Handlers</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Keyboard_Shortcuts" title="/en-US/docs/XUL/Tutorial/Keyboard_Shortcuts">Keyboard Shortcuts</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Focus_and_Selection" title="/en-US/docs/XUL/Tutorial/Focus_and_Selection">Focus and Selection</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Commands" title="/en-US/docs/XUL/Tutorial/Commands">Commands</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Updating_Commands" title="/en-US/docs/XUL/Tutorial/Updating_Commands">Updating Commands</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Broadcasters_and_Observers" title="/en-US/docs/XUL/Tutorial/Broadcasters_and_Observers">Broadcasters and Observers</a></li>

+</ul>

+<h2 id="Document_Object_Model" name="Document_Object_Model">Document Object Model</h2>

+<ul>

+ <li><a href="/en-US/docs/XUL/Tutorial/Document_Object_Model" title="/en-US/docs/XUL/Tutorial/Document_Object_Model">Document Object Model</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Modifying_a_XUL_Interface" title="/en-US/docs/XUL/Tutorial/Modifying_a_XUL_Interface">Modifying a XUL Interface</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Manipulating_Lists" title="/en-US/docs/XUL/Tutorial/Manipulating_Lists">Manipulating Lists</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Box_Objects" title="/en-US/docs/XUL/Tutorial/Box_Objects">Box Objects</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/XPCOM_Interfaces" title="/en-US/docs/XUL/Tutorial/XPCOM_Interfaces">XPCOM Interfaces</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/XPCOM_Examples" title="/en-US/docs/XUL/Tutorial/XPCOM_Examples">XPCOM Examples</a></li>

+</ul>

+<h2 id="Trees" name="Trees">Trees</h2>

+<ul>

+ <li><a href="/en-US/docs/XUL/Tutorial/Trees" title="/en-US/docs/XUL/Tutorial/Trees">Trees</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/More_Tree_Features" title="/en-US/docs/XUL/Tutorial/More_Tree_Features">More Tree Features</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Tree_Selection" title="/en-US/docs/XUL/Tutorial/Tree_Selection">Tree Selection</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Custom_Tree_Views" title="/en-US/docs/XUL/Tutorial/Custom_Tree_Views">Custom Tree Views</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Tree_View_Details" title="/en-US/docs/XUL/Tutorial/Tree_View_Details">Tree View Details</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Tree_Box_Objects" title="/en-US/docs/XUL/Tutorial/Tree_Box_Objects">Tree Box Objects</a></li>

+</ul>

+<h2 id="RDF_and_Templates" name="RDF_and_Templates">RDF and Templates</h2>

+<ul>

+ <li><a href="/en-US/docs/XUL/Tutorial/Introduction_to_RDF" title="/en-US/docs/XUL/Tutorial/Introduction_to_RDF">Introduction to RDF</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Templates" title="/en-US/docs/XUL/Tutorial/Templates">Templates</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Trees_and_Templates" title="/en-US/docs/XUL/Tutorial/Trees_and_Templates">Trees and Templates</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/RDF_Datasources" title="/en-US/docs/XUL/Tutorial/RDF_Datasources">RDF Datasources</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Advanced_Rules" title="/en-US/docs/XUL/Tutorial/Advanced_Rules">Advanced Rules</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Persistent_Data" title="/en-US/docs/XUL/Tutorial/Persistent_Data">Persistent Data</a></li>

+</ul>

+<h2 id="Skins_and_Locales" name="Skins_and_Locales">Skins and Locales</h2>

+<ul>

+ <li><a href="/en-US/docs/XUL/Tutorial/Adding_Style_Sheets" title="/en-US/docs/XUL/Tutorial/Adding_Style_Sheets">Adding Style Sheets</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Styling_a_Tree" title="/en-US/docs/XUL/Tutorial/Styling_a_Tree">Styling a Tree</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Modifying_the_Default_Skin" title="/en-US/docs/XUL/Tutorial/Modifying_the_Default_Skin">Modifying the Default Skin</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Creating_a_Skin" title="/en-US/docs/XUL/Tutorial/Creating_a_Skin">Creating a Skin</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Localization" title="/en-US/docs/XUL/Tutorial/Localization">Localization</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Property_Files" title="/en-US/docs/XUL/Tutorial/Property_Files">Property Files</a></li>

+</ul>

+<h2 id="Bindings" name="Bindings">Bindings</h2>

+<ul>

+ <li><a href="/en-US/docs/XUL/Tutorial/Introduction_to_XBL" title="/en-US/docs/XUL/Tutorial/Introduction_to_XBL">Introduction to XBL</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Anonymous_Content" title="/en-US/docs/XUL/Tutorial/Anonymous_Content">Anonymous Content</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/XBL_Attribute_Inheritance" title="/en-US/docs/XUL/Tutorial/XBL_Attribute_Inheritance">XBL Attribute Inheritance</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Adding_Properties_to_XBL-defined_Elements" title="/en-US/docs/XUL/Tutorial/Adding_Properties_to_XBL-defined_Elements">Adding Properties</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Adding_Methods_to_XBL-defined_Elements" title="/en-US/docs/XUL/Tutorial/Adding_Methods_to_XBL-defined_Elements">Adding Methods</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Adding_Event_Handlers_to_XBL-defined_Elements" title="/en-US/docs/XUL/Tutorial/Adding_Event_Handlers_to_XBL-defined_Elements">Adding Event Handlers</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/XBL_Inheritance" title="/en-US/docs/XUL/Tutorial/XBL_Inheritance">XBL Inheritance</a></li>

+ <li><a href="/en-US/docs/Mozilla/Tech/XUL/Tutorial/Using_XBL_from_stylesheets">Creating reusable content using CSS and XBL</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/XBL_Example" title="/en-US/docs/XUL/Tutorial/XBL_Example">XBL Example</a></li>

+</ul>

+<h2 id="Specialized_Window_Types" name="Specialized_Window_Types">Specialized Window Types</h2>

+<ul>

+ <li><a href="/en-US/docs/XUL/Tutorial/Features_of_a_Window" title="/en-US/docs/XUL/Tutorial/Features_of_a_Window">Features of a Window</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Creating_Dialogs" title="/en-US/docs/XUL/Tutorial/Creating_Dialogs">Creating Dialogs</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Open_and_Save_Dialogs" title="/en-US/docs/XUL/Tutorial/Open_and_Save_Dialogs">Open and Save Dialogs</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Creating_a_Wizard" title="/en-US/docs/XUL/Tutorial/Creating_a_Wizard">Creating a Wizard</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/More_Wizards" title="/en-US/docs/XUL/Tutorial/More_Wizards">More Wizards</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Overlays" title="/en-US/docs/XUL/Tutorial/Overlays">Overlays</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Cross_Package_Overlays" title="/en-US/docs/XUL/Tutorial/Cross_Package_Overlays">Cross Package Overlays</a></li>

+</ul>

+<h2 id="Installation" name="Installation">Installation</h2>

+<ul>

+ <li><a href="/en-US/docs/XUL/Tutorial/Creating_an_Installer" title="/en-US/docs/XUL/Tutorial/Creating_an_Installer">Creating an Installer</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Install_Scripts" title="/en-US/docs/XUL/Tutorial/Install_Scripts">Install Scripts</a></li>

+ <li><a href="/en-US/docs/XUL/Tutorial/Additional_Install_Features" title="/en-US/docs/XUL/Tutorial/Additional_Install_Features">Additional Install Features</a></li>

+</ul>

+<div class="note">

+ <p>This XUL tutorial was originally created by <a class="external" href="http://www.xulplanet.com/ndeakin/">Neil Deakin</a>. He has graciously given us permission to use it as part of the <a href="/en-US/docs/Project:About" title="Project:About">MDN</a>.</p>

+</div>

+<div class="originaldocinfo">

+ <h2 id="Original_Document_Information" name="Original_Document_Information">Original Document Information</h2>

+ <ul>

+ <li>Author: <a class="external" href="http://www.xulplanet.com/ndeakin/">Neil Deakin</a></li>

+ <li>Copyright Information: © 1999-2005 XULPlanet.com</li>

+ </ul>

+</div>

+<p> </p>

+---

+title: Localização

+slug: Archive/Mozilla/XUL/Tutorial/Localização

+tags:

+ - Internacionalização

+ - Localização

+ - Tutoriais

+ - XUL

+ - XUL_Tutorial

+translation_of: Archive/Mozilla/XUL/Tutorial/Localization

+---

+<p>XUL e XML fornecem entidades, que são uma forma conveniente de permitir localização.</p>

+

+<h3 id="Entities" name="Entities">Entidades</h3>

+

+<p>Muitos aplicativos são compilados de forma que a tradução da interface para um idioma diferente seja o mais simples possível. Geralmente, uma tabela de strings é criada para cada idioma. Em vez de codificar texto diretamente para um aplicativo, cada pedaço de texto só é uma referência na tabela de strings. <a href="/pt-BR/XML" title="en/XML">XML</a> fornece entidades que podem ser usadas para um propósito similar.</p>

+

+<p>Você já deve ser familiar com entidades se você escreveu <a href="/pt-BR/HTML" title="en/HTML">HTML</a>. Os códigos <code>&amp;lt;</code> e <code>&amp;gt;</code> são exemplos de entidades que podem ser usadas para colocar sinais de menor que e maior que no texto. XML possui uma sintaxe que lhe permite declarar entidades personalizadas. Você pode usá-las, de forma que a entidade seja substituída com seu valor, que pode ser uma string de texto. Entidades podem ser usados sempre que houver texto, inclundo os valores de atributos. O exemplo abaixo demonstra o uso de uma entidade em um botão.</p>

+

+<pre>&lt;button label="&amp;findLabel;"/&gt;

+</pre>

+

+<p>O texto que aparecerá no rótulo será o valor que a entidade <code>&amp;findLabel;</code> tem. Um arquivo é criado contendo as declarações da entidade para cada idioma suportado. Em ingçês, a entidade <code>&amp;findLabel;</code> provavelmente será declarada para ter o texto "Find" ("localizar", "encontrar").</p>

+

+<h3 id="DTD_Files" name="DTD_Files">DTD Files</h3>

+

+<p>Entities are declared in <em>Document Type Definition</em> (DTD) files. Files of this type are normally used to declare the syntax and semantics of a particular XML file, but they also let you declare entities. In the Mozilla chrome system, you will find DTD files located in the <code>locales</code> subdirectory. You would normally have one DTD file (with an extension <code>.dtd</code>) per XUL file.</p>

+

+<p>If you look in the chrome directory, you should see an archive for your language. (<code>en-US.jar</code> is the default for English.) You might have locale files in multiple languages, for example, US English (en-US) and French (fr). Inside these archives, you will find the files that hold the localized text for each window. The structure of the archives is very similar to the directory structure used for <a href="/en/XUL_Tutorial/Creating_a_Skin" title="en/XUL_Tutorial/Creating_a_Skin">skins</a>.</p>

+

+<p>Inside the archives, you would place the DTD files in which you declare entities. Typically, you will have one DTD file for each XUL file, usually with the same filename except with a <code>.dtd</code> extension. So, for the find files dialog, we will need a file called <code>findfile.dtd</code>.</p>

+

+<p>For non-installed chrome files, you can just put the DTD file in the same directory as the XUL file.</p>

+

+<div class="note"><strong>Note:</strong> You should encode DTD files as UTF-8 for non-ASCII characters. That is, you should save them in UTF-8 format (<a class="external" href="http://www.mozdev.org/notes/l10n/unicode/editors-en.html">without BOM</a>). For more information, see <a class="external" href="http://www.mozilla.org/projects/l10n/mlp_chrome.html#text">Mozilla Language Packs</a>.</div>

+

+<p>Once you have created a DTD file for your XUL, you will need to add a line to the XUL file which indicates that you want to use the DTD file. Otherwise, errors will occur as it won't be able to find the entities. To do this, add a line of the following form somewhere near the top of the XUL file:</p>

+

+<pre>&lt;!DOCTYPE window SYSTEM "chrome://findfile/locale/findfile.dtd"&gt;

+</pre>

+

+<p>This line specifies that the URL indicated is to be used as a DTD for the file. In this case, we have declared that we want to use the <code>findfile.dtd</code> DTD file. This line is typically placed just before the <code><code><a href="/pt-BR/docs/Mozilla/Tech/XUL/window" title="window">window</a></code></code> element.</p>

+

+<p>You also need to add the locale to the <a href="/en/Chrome_Registration#locale" title="en/Chrome_Registration#locale">chrome.manifest</a> file, for example:</p>

+

+<pre class="eval">locale findfile en-US locale/

+</pre>

+

+<h3 id="Declaring_Entities" name="Declaring_Entities">Declaring Entities</h3>

+

+<p>The entities are declared using a simple syntax as shown below:</p>

+

+<pre>&lt;!ENTITY findLabel "Find"&gt;

+</pre>

+

+<p>This example creates an entity with the name <code>findLabel</code> and the value "Find". This means that wherever the text "&amp;findLabel;" appears in the XUL file, it will be replaced with the text "Find". Note that entity declarations do not have a trailing slash at the end of them. In the DTD file for a different language, the text for that language will be used instead.</p>

+

+<pre class="eval"><strong>for Japanese:</strong>

+&lt;!ENTITY findLabel "検索"&gt;

+</pre>

+

+<p>For example, the following text:</p>

+

+<pre>&lt;description value="&amp;findLabel;"/&gt;

+</pre>

+

+<p>is translated as:</p>

+

+<pre class="eval"><strong>English version:</strong>

+&lt;description value="Find"/&gt;

+

+<strong>Japanese version:</strong>

+&lt;description value="検索"/&gt;

+</pre>

+

+<p>You would declare an entity for each label or string of text that you use in your interface. You should not have any directly displayed text in the XUL file at all.</p>

+

+<p>In addition to using entities for text labels, you should use them for any value that could be different in a different language. <a href="/en/XUL_Tutorial/Keyboard_Shortcuts" title="en/XUL_Tutorial/Keyboard_Shortcuts">Access keys and keyboard shortcuts </a> for example.</p>

+

+<pre class="eval"> <strong>XUL</strong>

+ &lt;menuitem label="&amp;undo.label;" accesskey="&amp;undo.key;"/&gt;

+ <strong>DTD</strong>

+ &lt;!ENTITY undo.label "Undo"&gt;

+ &lt;!ENTITY undo.key "u"&gt;

+</pre>

+

+<p>The example above uses two entities, one for the label on the Undo menu item and the second for the access key.</p>

+

+<p> </p>

+

+<div class="highlight">

+<h3 id="Changing_the_Find_Files_example" name="Changing_the_Find_Files_example">Changing the Find Files example</h3>

+

+<p>Let's take a look at how we would put all of this together by modifying the find files dialog so that it uses a DTD file for all of its text strings. The entire XUL file is shown below with the changes shown in red.</p>

+

+<pre class="eval">&lt;?xml version="1.0"?&gt;

+

+&lt;?xml-stylesheet href="<a class="external" rel="freelink">chrome://global/skin/</a>" type="text/css"?&gt;

+&lt;?xml-stylesheet href="findfile.css" type="text/css"?&gt;

+

+<span class="highlightred">&lt;!DOCTYPE window SYSTEM "<a class="external" rel="freelink">chrome://findfile/locale/findfile.dtd</a>"&gt;</span>

+

+&lt;window

+ id="findfile-window"

+ title="<span class="highlightred">&amp;findWindow.title;</span>"

+ persist="screenX screenY width height"

+ orient="horizontal"

+ onload="initSearchList()"

+ xmlns="<span class="nowiki">http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul</span>"&gt;

+

+&lt;script src="findfile.js"/&gt;

+

+&lt;popupset&gt;

+ &lt;menupopup id="editpopup"&gt;

+ &lt;menuitem label="<span class="highlightred">&amp;cutCmd.label;</span>" accesskey="<span class="highlightred">&amp;cutCmd.accesskey;</span>"/&gt;

+ &lt;menuitem label="<span class="highlightred">&amp;copyCmd.label;</span>" accesskey="<span class="highlightred">&amp;copyCmd.accesskey;</span>"/&gt;

+ &lt;menuitem label="<span class="highlightred">&amp;pasteCmd.label;</span>" accesskey="<span class="highlightred">&amp;pasteCmd.accesskey;</span>" disabled="true"/&gt;

+ &lt;/menupopup&gt;

+&lt;/popupset&gt;

+

+&lt;keyset&gt;

+ &lt;key id="cut_cmd" modifiers="accel" key="<span class="highlightred">&amp;cutCmd.commandkey;</span>"/&gt;

+ &lt;key id="copy_cmd" modifiers="accel" key="<span class="highlightred">&amp;copyCmd.commandkey;</span>"/&gt;

+ &lt;key id="paste_cmd" modifiers="accel" key="<span class="highlightred">&amp;pasteCmd.commandkey;</span>"/&gt;

+ &lt;key id="close_cmd" keycode="VK_ESCAPE" oncommand="window.close();"/&gt;

+&lt;/keyset&gt;

+

+&lt;vbox flex="1"&gt;

+

+ &lt;toolbox&gt;

+

+ &lt;menubar id="findfiles-menubar"&gt;

+ &lt;menu id="file-menu" label="<span class="highlightred">&amp;fileMenu.label;</span>"

+ accesskey="<span class="highlightred">&amp;fileMenu.accesskey;</span>"&gt;

+ &lt;menupopup id="file-popup"&gt;

+ &lt;menuitem label="<span class="highlightred">&amp;openCmd.label;</span>"

+ accesskey="<span class="highlightred">&amp;openCmd.accesskey;</span>"/&gt;

+ &lt;menuitem label="<span class="highlightred">&amp;saveCmd.label;</span>"

+ accesskey="<span class="highlightred">&amp;saveCmd.accesskey;</span>"/&gt;

+ &lt;menuseparator/&gt;

+ &lt;menuitem label="<span class="highlightred">&amp;closeCmd.label;</span>"

+ accesskey="<span class="highlightred">&amp;closeCmd.accesskey;" key="close_cmd" oncommand="window.close();</span>"/&gt;

+ &lt;/menupopup&gt;

+ &lt;/menu&gt;

+ &lt;menu id="edit-menu" label="<span class="highlightred">&amp;editMenu.label;</span>"

+ accesskey="<span class="highlightred">&amp;editMenu.accesskey;</span>"&gt;

+ &lt;menupopup id="edit-popup"&gt;

+ &lt;menuitem label="<span class="highlightred">&amp;cutCmd.label;</span>"

+ accesskey="<span class="highlightred">&amp;cutCmd.accesskey;</span>" key="cut_cmd"/&gt;

+ &lt;menuitem label="<span class="highlightred">&amp;copyCmd.label;</span>"

+ accesskey="<span class="highlightred">&amp;copyCmd.accesskey;</span>" key="copy_cmd"/&gt;

+ &lt;menuitem label="<span class="highlightred">&amp;pasteCmd.label;</span>"

+ accesskey="<span class="highlightred">&amp;pasteCmd.accesskey;</span>" key="paste_cmd" disabled="true"/&gt;

+ &lt;/menupopup&gt;

+ &lt;/menu&gt;

+ &lt;/menubar&gt;

+

+ &lt;toolbar id="findfiles-toolbar"&gt;

+ &lt;toolbarbutton id="opensearch" label="<span class="highlightred">&amp;openCmdToolbar.label;</span>"/&gt;

+ &lt;toolbarbutton id="savesearch" label="<span class="highlightred">&amp;saveCmdToolbar.label;</span>"/&gt;

+ &lt;/toolbar&gt;

+ &lt;/toolbox&gt;

+

+ &lt;tabbox&gt;

+ &lt;tabs&gt;

+ &lt;tab label="<span class="highlightred">&amp;searchTab;</span>" selected="true"/&gt;

+ &lt;tab label="<span class="highlightred">&amp;optionsTab;</span>"/&gt;

+ &lt;/tabs&gt;

+

+ &lt;tabpanels&gt;

+

+ &lt;tabpanel id="searchpanel" orient="vertical" context="editpopup"&gt;

+

+ &lt;description&gt;

+ <span class="highlightred">&amp;findDescription;</span>

+ &lt;/description&gt;

+

+ &lt;spacer class="titlespace"/&gt;

+

+ &lt;groupbox orient="horizontal"&gt;

+ &lt;caption label="<span class="highlightred">&amp;findCriteria;</span>"/&gt;

+

+ &lt;menulist id="searchtype"&gt;

+ &lt;menupopup&gt;

+ &lt;menuitem label="<span class="highlightred">&amp;type.name;</span>"/&gt;

+ &lt;menuitem label="<span class="highlightred">&amp;type.size;</span>"/&gt;

+ &lt;menuitem label="<span class="highlightred">&amp;type.date;</span>"/&gt;

+ &lt;/menupopup&gt;

+ &lt;/menulist&gt;

+ &lt;spacer class="springspace"/&gt;

+ &lt;menulist id="searchmode"&gt;

+ &lt;menupopup&gt;

+ &lt;menuitem label="<span class="highlightred">&amp;mode.is;</span>"/&gt;

+ &lt;menuitem label="<span class="highlightred">&amp;mode.isnot;</span>"/&gt;

+ &lt;/menupopup&gt;

+ &lt;/menulist&gt;

+ &lt;spacer class="springspace"/&gt;

+

+ &lt;menulist id="find-text" flex="1"

+ editable="true"

+ datasources="<a class="external" rel="freelink">file:///mozilla/recents.rdf</a>"

+ ref="<span class="nowiki">http://www.xulplanet.com/rdf/recent/all</span>"&gt;

+ &lt;template&gt;

+ &lt;menupopup&gt;

+ &lt;menuitem label="<span class="nowiki">rdf:http://www.xulplanet.com/rdf/recent#Label</span>" uri="rdf:*"/&gt;

+ &lt;/menupopup&gt;

+ &lt;/template&gt;

+ &lt;/menulist&gt;

+

+ &lt;/groupbox&gt;

+

+ &lt;/tabpanel&gt;

+

+ &lt;tabpanel id="optionspanel" orient="vertical"&gt;

+ &lt;checkbox id="casecheck" label="<span class="highlightred">&amp;casesensitive;</span>"/&gt;

+ &lt;checkbox id="wordscheck" label="<span class="highlightred">&amp;matchfilename;</span>"/&gt;

+ &lt;/tabpanel&gt;

+

+ &lt;/tabpanels&gt;

+ &lt;/tabbox&gt;

+

+ &lt;tree id="results" style="display: none;" flex="1"&gt;

+ &lt;treecols&gt;

+ &lt;treecol id="name" label="<span class="highlightred">&amp;results.filename;</span>" flex="1"/&gt;

+ &lt;treecol id="location" label="<span class="highlightred">&amp;results.location;</span>" flex="2"/&gt;

+ &lt;treecol id="size" label="<span class="highlightred">&amp;results.size;</span>" flex="1"/&gt;

+ &lt;/treecols&gt;

+

+ &lt;treechildren&gt;

+ &lt;treeitem&gt;

+ &lt;treerow&gt;

+ &lt;treecell label="mozilla"/&gt;

+ &lt;treecell label="/usr/local"/&gt;

+ &lt;treecell label="<span class="highlightred">&amp;bytes.before;</span>2520<span class="highlightred">&amp;bytes.after;</span>"/&gt;

+ &lt;/treerow&gt;

+ &lt;/treeitem&gt;

+ &lt;/treechildren&gt;

+ &lt;/tree&gt;

+

+ &lt;splitter id="splitbar" resizeafter="grow" style="display: none;"/&gt;

+

+ &lt;spacer class="titlespace"/&gt;

+

+ &lt;hbox&gt;

+ &lt;progressmeter id="progmeter" value="50%" style="display: none;"/&gt;

+ &lt;spacer flex="1"/&gt;

+ &lt;button id="find-button" label="<span class="highlightred">&amp;button.find;</span>"

+ oncommand="doFind()"/&gt;

+ &lt;button id="cancel-button" label="<span class="highlightred">&amp;button.cancel;</span>"

+ oncommand="window.close();"/&gt;

+ &lt;/hbox&gt;

+&lt;/vbox&gt;

+

+&lt;/window&gt;

+</pre>

+

+<p>Each text string has been replaced by an entity reference. A DTD file has been included near the beginning of the XUL file. Each entity that was added should be declared in the DTD file. The window will not be displayed if an entity is found in the XUL file that hasn't been declared.</p>

+

+<p>Note that the name of the entity is not important. In the example above, words in entities have been separated with periods. You don't have to do this. The entity names here follow similar conventions as the rest of the Mozilla code.</p>

+

+<p>You might notice that the text '2520 bytes' has been replaced by two entities. This is because the phrase structure may be different in another locale. For example, the number might need to appear before the equivalent of 'bytes' instead of after. Of course, this might need to be more complicated in order to display KB or MB as needed.</p>

+

+<p>The access keys and keyboard shortcuts have also been translated into entities because they will likely be different in a different locale.</p>

+

+<p>Next, the DTD file - findfile.dtd:</p>

+

+<pre>&lt;!ENTITY findWindow.title "Find Files"&gt;

+&lt;!ENTITY fileMenu.label "File"&gt;

+&lt;!ENTITY editMenu.label "Edit"&gt;

+&lt;!ENTITY fileMenu.accesskey "f"&gt;

+&lt;!ENTITY editMenu.accesskey "e"&gt;

+&lt;!ENTITY openCmd.label "Open Search..."&gt;

+&lt;!ENTITY saveCmd.label "Save Search..."&gt;

+&lt;!ENTITY closeCmd.label "Close"&gt;

+&lt;!ENTITY openCmd.accesskey "o"&gt;

+&lt;!ENTITY saveCmd.accesskey "s"&gt;

+&lt;!ENTITY closeCmd.accesskey "c"&gt;

+&lt;!ENTITY cutCmd.label "Cut"&gt;

+&lt;!ENTITY copyCmd.label "Copy"&gt;

+&lt;!ENTITY pasteCmd.label "Paste"&gt;

+&lt;!ENTITY cutCmd.accesskey "t"&gt;

+&lt;!ENTITY copyCmd.accesskey "c"&gt;

+&lt;!ENTITY pasteCmd.accesskey "p"&gt;

+&lt;!ENTITY cutCmd.commandkey "X"&gt;

+&lt;!ENTITY copyCmd.commandkey "C"&gt;

+&lt;!ENTITY pasteCmd.commandkey "V"&gt;

+&lt;!ENTITY openCmdToolbar.label "Open"&gt;

+&lt;!ENTITY saveCmdToolbar.label "Save"&gt;

+&lt;!ENTITY searchTab "Search"&gt;

+&lt;!ENTITY optionsTab "Options"&gt;

+&lt;!ENTITY findDescription "Enter your search criteria below and select the Find button to begin the search."&gt;

+&lt;!ENTITY findCriteria "Search Criteria"&gt;

+&lt;!ENTITY type.name "Name"&gt;

+&lt;!ENTITY type.size "Size"&gt;

+&lt;!ENTITY type.date "Date Modified"&gt;

+&lt;!ENTITY mode.is "Is"&gt;

+&lt;!ENTITY mode.isnot "Is Not"&gt;

+&lt;!ENTITY casesensitive "Case Sensitive Search"&gt;

+&lt;!ENTITY matchfilename "Match Entire Filename"&gt;

+&lt;!ENTITY results.filename "Filename"&gt;

+&lt;!ENTITY results.location "Location"&gt;

+&lt;!ENTITY results.size "Size"&gt;

+&lt;!ENTITY bytes.before ""&gt;

+&lt;!ENTITY bytes.after "bytes"&gt;

+&lt;!ENTITY button.find "Find"&gt;

+&lt;!ENTITY button.cancel "Cancel"&gt;

+</pre>

+

+<p>Now, to add text for a new language all you need to do is create another DTD file. By using the chrome system to add the DTD file to a different locale, the same XUL file can be used in any language.</p>

+

+<p>Find files example so far: <a href="https://developer.mozilla.org/samples/xultu/examples/findfile/findfile-locale.xul.txt">Source</a></p>

+</div>

+

+<p>Next, we'll look at <a href="/en/XUL_Tutorial/Property_Files" title="en/XUL_Tutorial/Property_Files">property files</a>.</p>

+

+<div class="prevnext" style="text-align: right;">

+ <p><a href="/pt-BR/docs/XUL_Tutorial/Creating_a_Skin" style="float: left;">« Previous</a><a href="/pt-BR/docs/XUL_Tutorial/Property_Files">Next »</a></p>

+</div>

+

+

+

+<h2 id="See_Also">See Also</h2>

+

+<ul>

+ <li>How to localize html pages, xul files, and js/jsm files from bootstrapped add-ons: <a href="/en-US/Add-ons/Bootstrapped_extensions#Localization_%28L10n%29">Bootstrapped Extensions :: Localization (L10n)</a></li>

+</ul>

+---

+title: Referência XUL

+slug: Archive/Mozilla/XUL/XUL_Reference

+translation_of: Archive/Mozilla/XUL/XUL_Reference

+---

+<p>« <a href="https://developer.mozilla.org/docs/en-US/XUL" title="en-US/XUL">Referência XUL</a> «</p>

+<h2 id="Lista_em_ordem_alfabética_de_todos_os_elementos_XUL">Lista em ordem alfabética de todos os elementos XUL</h2>

+<ul>

+ <li><code><a href="/en/XUL/action" title="en/XUL/action">action</a></code></li>

+ <li><code><a href="/en/XUL/arrowscrollbox" title="en/XUL/arrowscrollbox">arrowscrollbox</a></code></li>

+ <li><code><a href="/en/XUL/assign" title="en/XUL/assign">assign</a></code></li>

+ <li><code><a href="/en/XUL/bbox" title="en/XUL/bbox">bbox</a></code></li>

+ <li><code><a href="/en/XUL/binding" title="en/XUL/binding">binding</a></code></li>

+ <li><code><a href="/en/XUL/bindings" title="en/XUL/bindings">bindings</a></code></li>

+ <li><code><a href="/en/XUL/box" title="en/XUL/box">box</a></code></li>

+ <li><code><a href="/en/XUL/broadcaster" title="en/XUL/broadcaster">broadcaster</a></code></li>

+ <li><code><a href="/en/XUL/broadcasterset" title="en/XUL/broadcasterset">broadcasterset</a></code></li>

+ <li><code><a href="/en/XUL/button" title="en/XUL/button">button</a></code></li>

+ <li><code><a href="/en/XUL/browser" title="en/XUL/browser">browser</a></code></li>

+ <li><code><a href="/en/XUL/checkbox" title="en/XUL/checkbox">checkbox</a></code></li>

+ <li><code><a href="/en/XUL/caption" title="en/XUL/caption">caption</a></code></li>

+ <li><code><a href="/en/XUL/colorpicker" title="en/XUL/colorpicker">colorpicker</a></code></li>

+ <li><code><a href="/en/XUL/column" title="en/XUL/column">column</a></code></li>

+ <li><code><a href="/en/XUL/columns" title="en/XUL/columns">columns</a></code></li>

+ <li><code><a href="/en/XUL/commandset" title="en/XUL/commandset">commandset</a></code></li>

+ <li><code><a href="/en/XUL/command" title="en/XUL/command">command</a></code></li>

+ <li><code><a href="/en/XUL/conditions" title="en/XUL/conditions">conditions</a></code></li>

+ <li><code><a href="/en/XUL/content" title="en/XUL/content">content</a></code></li>

+ <li><code><a href="/en/XUL/datepicker" title="en/XUL/datepicker">datepicker</a></code></li>

+ <li><code><a href="/en/XUL/deck" title="en/XUL/deck">deck</a></code></li>

+ <li><code><a href="/en/XUL/description" title="en/XUL/description">description</a></code></li>

+ <li><code><a href="/en/XUL/dialog" title="en/XUL/dialog">dialog</a></code></li>

+ <li><code><a href="/en/XUL/dialogheader" title="en/XUL/dialogheader">dialogheader</a></code></li>

+ <li><code><a href="/en/XUL/dropmarker" title="en/XUL/dropmarker">dropmarker</a></code></li>

+ <li><code><a href="/en/XUL/editor" title="en/XUL/editor">editor</a></code></li>

+ <li><code><a href="/en/XUL/grid" title="en/XUL/grid">grid</a></code></li>

+ <li><code><a href="/en/XUL/grippy" title="en/XUL/grippy">grippy</a></code></li>

+ <li><code><a href="/en/XUL/groupbox" title="en/XUL/groupbox">groupbox</a></code></li>

+ <li><code><a href="/en/XUL/hbox" title="en/XUL/hbox">hbox</a></code></li>

+ <li><code><a href="/en/XUL/iframe" title="en/XUL/iframe">iframe</a></code></li>

+ <li><code><a href="/en/XUL/image" title="en/XUL/image">image</a></code></li>

+ <li><code><a href="/en/XUL/key" title="en/XUL/key">key</a></code></li>

+ <li><code><a href="/en/XUL/keyset" title="en/XUL/keyset">keyset</a></code></li>

+ <li><code><a href="/en/XUL/label" title="en/XUL/label">label</a></code></li>

+ <li><code><a href="/en/XUL/listbox" title="en/XUL/listbox">listbox</a></code></li>

+ <li><code><a href="/en/XUL/listcell" title="en/XUL/listcell">listcell</a></code></li>

+ <li><code><a href="/en/XUL/listcol" title="en/XUL/listcol">listcol</a></code></li>

+ <li><code><a href="/en/XUL/listcols" title="en/XUL/listcols">listcols</a></code></li>

+ <li><code><a href="/en/XUL/listhead" title="en/XUL/listhead">listhead</a></code></li>

+ <li><code><a href="/en/XUL/listheader" title="en/XUL/listheader">listheader</a></code></li>

+ <li><code><a href="/en/XUL/listitem" title="en/XUL/listitem">listitem</a></code></li>

+ <li><code><a href="/en/XUL/member" title="en/XUL/member">member</a></code></li>

+ <li><code><a href="/en/XUL/menu" title="en/XUL/menu">menu</a></code></li>

+ <li><code><a href="/en/XUL/menubar" title="en/XUL/menubar">menubar</a></code></li>

+ <li><code><a href="/en/XUL/menuitem" title="en/XUL/menuitem">menuitem</a></code></li>

+ <li><code><a href="/en/XUL/menulist" title="en/XUL/menulist">menulist</a></code></li>

+ <li><code><a href="/en/XUL/menupopup" title="en/XUL/menupopup">menupopup</a></code></li>

+ <li><code><a href="/en/XUL/menuseparator" title="en/XUL/menuseparator">menuseparator</a></code></li>

+ <li><code><a href="/en/XUL/notification" title="en/XUL/notification">notification</a></code></li>

+ <li><code><a href="/en/XUL/notificationbox" title="en/XUL/notificationbox">notificationbox</a></code></li>

+ <li><code><a href="/en/XUL/observes" title="en/XUL/observes">observes</a></code></li>

+ <li><code><a href="/en/XUL/overlay" title="en/XUL/overlay">overlay</a></code></li>

+ <li><code><a href="/en/XUL/page" title="en/XUL/page">page</a></code></li>

+ <li><code><a href="/en/XUL/panel" title="en/XUL/panel">panel</a></code></li>

+ <li><code><a href="/en/XUL/param" title="en/XUL/param">param</a></code></li>

+ <li><code><a href="/en/XUL/popupset" title="en/XUL/popupset">popupset</a></code></li>

+ <li><code><a href="/en/XUL/preference" title="en/XUL/preference">preference</a></code></li>

+ <li><code><a href="/en/XUL/preferences" title="en/XUL/preferences">preferences</a></code></li>

+ <li><code><a href="/en/XUL/prefpane" title="en/XUL/prefpane">prefpane</a></code></li>

+ <li><code><a href="/en/XUL/prefwindow" title="en/XUL/prefwindow">prefwindow</a></code></li>

+ <li><code><a href="/en/XUL/progressmeter" title="en/XUL/progressmeter">progressmeter</a></code></li>

+ <li><code><a href="/en/XUL/query" title="en/XUL/query">query</a></code></li>

+ <li><code><a href="/en/XUL/queryset" title="en/XUL/queryset">queryset</a></code></li>

+ <li><code><a href="/en/XUL/radio" title="en/XUL/radio">radio</a></code></li>

+ <li><code><a href="/en/XUL/radiogroup" title="en/XUL/radiogroup">radiogroup</a></code></li>

+ <li><code><a href="/en/XUL/resizer" title="en/XUL/resizer">resizer</a></code></li>

+ <li><code><a href="/en/XUL/richlistbox" title="en/XUL/richlistbox">richlistbox</a></code></li>

+ <li><code><a href="/en/XUL/richlistitem" title="en/XUL/richlistitem">richlistitem</a></code></li>

+ <li><code><a href="/en/XUL/row" title="en/XUL/row">row</a></code></li>

+ <li><code><a href="/en/XUL/rows" title="en/XUL/rows">rows</a></code></li>

+ <li><code><a href="/en/XUL/rule" title="en/XUL/rule">rule</a></code></li>

+ <li><code><a href="/en/XUL/scale" title="en/XUL/scale">scale</a></code></li>

+ <li><code><a href="/en/XUL/script" title="en/XUL/script">script</a></code></li>

+ <li><code><a href="/en/XUL/scrollbar" title="en/XUL/scrollbar">scrollbar</a></code></li>

+ <li><code><a href="/en/XUL/scrollbox" title="en/XUL/scrollbox">scrollbox</a></code></li>

+ <li><code><a href="/en/XUL/scrollcorner" title="en/XUL/scrollcorner">scrollcorner</a></code></li>

+ <li><code><a href="/en/XUL/separator" title="en/XUL/separator">separator</a></code></li>

+ <li><code><a href="/en/XUL/spacer" title="en/XUL/spacer">spacer</a></code></li>

+ <li><code><a href="/en/XUL/spinbuttons" title="en/XUL/spinbuttons">spinbuttons</a></code></li>

+ <li><code><a href="/en/XUL/splitter" title="en/XUL/splitter">splitter</a></code></li>

+ <li><code><a href="/en/XUL/stack" title="en/XUL/stack">stack</a></code></li>

+ <li><code><a href="/en/XUL/statusbar" title="en/XUL/statusbar">statusbar</a></code></li>

+ <li><code><a href="/en/XUL/statusbarpanel" title="en/XUL/statusbarpanel">statusbarpanel</a></code></li>

+ <li><code><a href="/en/XUL/stringbundle" title="en/XUL/stringbundle">stringbundle</a></code></li>

+ <li><code><a href="/en/XUL/stringbundleset" title="en/XUL/stringbundleset">stringbundleset</a></code></li>

+ <li><code><a href="/en/XUL/tab" title="en/XUL/tab">tab</a></code></li>

+ <li><code><a href="/en/XUL/tabbrowser" title="en/XUL/tabbrowser">tabbrowser</a> (somente Firefox iniciando com Firefox 3/Gecko 1.9)</code></li>

+ <li><code><a href="/en/XUL/tabbox" title="en/XUL/tabbox">tabbox</a></code></li>

+ <li><code><a href="/en/XUL/tabpanel" title="en/XUL/tabpanel">tabpanel</a></code></li>

+ <li><code><a href="/en/XUL/tabpanels" title="en/XUL/tabpanels">tabpanels</a></code></li>

+ <li><code><a href="/en/XUL/tabs" title="en/XUL/tabs">tabs</a></code></li>

+ <li><code><a href="/en/XUL/template" title="en/XUL/template">template</a></code></li>

+ <li><code><a href="/en/XUL/textnode" title="en/XUL/textnode">textnode</a></code></li>

+ <li><code><a href="/en/XUL/textbox" title="en/XUL/textbox">textbox</a></code></li>

+ <li><code><a href="/En/XUL/Textbox_(Toolkit_autocomplete)" title="en/XUL/textbox_(Firefox_autocomplete)">textbox (Firefox autocomplete)</a></code></li>

+ <li><code><a href="/En/XUL/Textbox_(XPFE_autocomplete)" title="en/XUL/textbox_(Mozilla_autocomplete)">textbox (Mozilla autocomplete)</a></code></li>

+ <li><code><a href="/en/XUL/timepicker" title="en/XUL/timepicker">timepicker</a></code></li>

+ <li><code><a href="/en/XUL/titlebar" title="en/XUL/titlebar">titlebar</a></code></li>

+ <li><code><a href="/en/XUL/toolbar" title="en/XUL/toolbar">toolbar</a></code></li>

+ <li><code><a href="/en/XUL/toolbarbutton" title="en/XUL/toolbarbutton">toolbarbutton</a></code></li>

+ <li><code><a href="/en/XUL/toolbargrippy" title="en/XUL/toolbargrippy">toolbargrippy</a></code></li>

+ <li><code><a href="/en/XUL/toolbaritem" title="en/XUL/toolbaritem">toolbaritem</a></code></li>

+ <li><code><a href="/en/XUL/toolbarpalette" title="en/XUL/toolbarpalette">toolbarpalette</a></code></li>

+ <li><code><a href="/en/XUL/toolbarseparator" title="en/XUL/toolbarseparator">toolbarseparator</a></code></li>

+ <li><code><a href="/en/XUL/toolbarset" title="en/XUL/toolbarset">toolbarset</a></code></li>

+ <li><code><a href="/en/XUL/toolbarspacer" title="en/XUL/toolbarspacer">toolbarspacer</a></code></li>

+ <li><code><a href="/en/XUL/toolbarspring" title="en/XUL/toolbarspring">toolbarspring</a></code></li>

+ <li><code><a href="/en/XUL/toolbox" title="en/XUL/toolbox">toolbox</a></code></li>

+ <li><code><a href="/en/XUL/tooltip" title="en/XUL/tooltip">tooltip</a></code></li>

+ <li><code><a href="/en/XUL/tree" title="en/XUL/tree">tree</a></code></li>

+ <li><code><a href="/en/XUL/treecell" title="en/XUL/treecell">treecell</a></code></li>

+ <li><code><a href="/en/XUL/treechildren" title="en/XUL/treechildren">treechildren</a></code></li>

+ <li><code><a href="/en/XUL/treecol" title="en/XUL/treecol">treecol</a></code></li>

+ <li><code><a href="/en/XUL/treecols" title="en/XUL/treecols">treecols</a></code></li>

+ <li><code><a href="/en/XUL/treeitem" title="en/XUL/treeitem">treeitem</a></code></li>

+ <li><code><a href="/en/XUL/treerow" title="en/XUL/treerow">treerow</a></code></li>

+ <li><code><a href="/en/XUL/treeseparator" title="en/XUL/treeseparator">treeseparator</a></code></li>

+ <li><code><a href="/en/XUL/triple" title="en/XUL/triple">triple</a></code></li>

+ <li><code><a href="/en/XUL/vbox" title="en/XUL/vbox">vbox</a></code></li>

+ <li><code><a href="/en/XUL/where" title="en/XUL/where">where</a></code></li>

+ <li><code><a href="/en/XUL/window" title="en/XUL/window">window</a></code></li>

+ <li><code><a href="/en/XUL/wizard" title="en/XUL/wizard">wizard</a></code></li>

+ <li><code><a href="/en/XUL/wizardpage" title="en/XUL/wizardpage">wizardpage</a></code></li>

+</ul>

+<h2 id="Lista_por_categoria_de_todos_os_elementos_XUL">Lista por categoria de todos os elementos XUL</h2>

+<p>« <a href="https://developer.mozilla.org/docs/en-US/XUL" title="en-US/XUL">Referência XUL</a> «</p>

+<h3 id="Windows">Windows</h3>

+<h3 id="Estrutura_da_Janela">Estrutura da Janela</h3>

+<h3 id="Menus_e_popups">Menus e popups</h3>

+<h3 id="Barra_de_Ferramentas">Barra de Ferramentas</h3>

+<h3 id="Abas_e_agrupamento">Abas e  agrupamento</h3>

+<h3 id="Controles">Controles</h3>

+<h3 id="Textos_e_imagens">Textos e imagens</h3>

+<h3 id="Listas">Listas</h3>

+<h3 id="Árvores">Árvores</h3>

+<h3 id="Layout">Layout</h3>

+<h3 id="Modelos">Modelos</h3>

+<h3 id="Scripting">Scripting</h3>

+<h3 id="Elementos_auxiliares">Elementos auxiliares</h3>

+<h2 id="Other_XUL_lists" name="Other_XUL_lists">Outras listas XUL</h2>

+<ol style="list-style-type: square;">

+ <li><a href="/en/XUL/dialog" title="en/XUL/dialog">dialog</a></li>

+ <li><a href="/en/XUL/overlay" title="en/XUL/overlay">overlay</a></li>

+ <li><a href="/en/XUL/page" title="en/XUL/page">page</a></li>

+ <li><a href="/en/XUL/window" title="en/XUL/window">window</a></li>

+ <li><a href="/en/XUL/wizard" title="en/XUL/wizard">wizard</a></li>

+ <li><a href="/en/XUL/wizardpage" title="en/XUL/wizardpage">wizardpage</a></li>

+ <li><a href="/en/XUL/preference" title="en/XUL/preference">preference</a></li>

+ <li><a href="/en/XUL/preferences" title="en/XUL/preferences">preferences</a></li>

+ <li><a href="/en/XUL/prefpane" title="en/XUL/prefpane">prefpane</a></li>

+ <li><a href="/en/XUL/prefwindow" title="en/XUL/prefwindow">prefwindow</a></li>

+ <li><a href="/en/XUL/browser" title="en/XUL/browser">browser</a></li>

+ <li><a href="/en/XUL/tabbrowser" title="en/XUL/tabbrowser">tabbrowser</a></li>

+ <li><a href="/en/XUL/editor" title="en/XUL/editor">editor</a></li>

+ <li><a href="/en/XUL/iframe" title="en/XUL/iframe">iframe</a></li>

+ <li><a href="/en/XUL/titlebar" title="en/XUL/titlebar">titlebar</a></li>

+ <li><a href="/en/XUL/resizer" title="en/XUL/resizer">resizer</a></li>

+ <li><a href="/en/XUL/statusbar" title="en/XUL/statusbar">statusbar</a></li>

+ <li><a href="/en/XUL/statusbarpanel" title="en/XUL/statusbarpanel">statusbarpanel</a></li>

+ <li><a href="/en/XUL/dialogheader" title="en/XUL/dialogheader">dialogheader</a></li>

+ <li><a href="/en/XUL/notification" title="en/XUL/notification">notification</a></li>

+ <li><a href="/en/XUL/notificationbox" title="en/XUL/notificationbox">notificationbox</a></li>

+ <li><a href="/en/XUL/menubar" title="en/XUL/menubar">menubar</a></li>

+ <li><a href="/en/XUL/menu" title="en/XUL/menu">menu</a></li>

+ <li><a href="/en/XUL/menuitem" title="en/XUL/menuitem">menuitem</a></li>

+ <li><a href="/en/XUL/menuseparator" title="en/XUL/menuseparator">menuseparator</a></li>

+ <li><a href="/en/XUL/menupopup" title="en/XUL/menupopup">menupopup</a></li>

+ <li><a href="/en/XUL/panel" title="en/XUL/panel">panel</a></li>

+ <li><a href="/en/XUL/tooltip" title="en/XUL/tooltip">tooltip</a></li>

+ <li><a href="/en/XUL/popupset" title="en/XUL/popupset">popupset</a></li>

+ <li><a href="/en/XUL/toolbar" title="en/XUL/toolbar">toolbar</a></li>

+ <li><a href="/en/XUL/toolbarbutton" title="en/XUL/toolbarbutton">toolbarbutton</a></li>

+ <li><a href="/en/XUL/toolbargrippy" title="en/XUL/toolbargrippy">toolbargrippy</a></li>

+ <li><a href="/en/XUL/toolbaritem" title="en/XUL/toolbaritem">toolbaritem</a></li>

+ <li><a href="/en/XUL/toolbarpalette" title="en/XUL/toolbarpalette">toolbarpalette</a></li>

+ <li><a href="/en/XUL/toolbarseparator" title="en/XUL/toolbarseparator">toolbarseparator</a></li>

+ <li><a href="/en/XUL/toolbarset" title="en/XUL/toolbarset">toolbarset</a></li>

+ <li><a href="/en/XUL/toolbarspacer" title="en/XUL/toolbarspacer">toolbarspacer</a></li>

+ <li><a href="/en/XUL/toolbarspring" title="en/XUL/toolbarspring">toolbarspring</a></li>

+ <li><a href="/en/XUL/toolbox" title="en/XUL/toolbox">toolbox</a></li>

+ <li><a href="/en/XUL/tabbox" title="en/XUL/tabbox">tabbox</a></li>

+ <li><a href="/en/XUL/tabs" title="en/XUL/tabs">tabs</a></li>

+ <li><a href="/en/XUL/tab" title="en/XUL/tab">tab</a></li>

+ <li><a href="/en/XUL/tabpanels" title="en/XUL/tabpanels">tabpanels</a></li>

+ <li><a href="/en/XUL/tabpanel" title="en/XUL/tabpanel">tabpanel</a></li>

+ <li><a href="/en/XUL/groupbox" title="en/XUL/groupbox">groupbox</a></li>

+ <li><a href="/en/XUL/caption" title="en/XUL/caption">caption</a></li>

+ <li><a href="/en/XUL/separator" title="en/XUL/separator">separator</a></li>

+ <li><a href="/en/XUL/spacer" title="en/XUL/spacer">spacer</a></li>

+ <li><a href="/en/XUL/button" title="en/XUL/button">button</a></li>

+ <li><a href="/en/XUL/checkbox" title="en/XUL/checkbox">checkbox</a></li>

+ <li><a href="/en/XUL/colorpicker" title="en/XUL/colorpicker">colorpicker</a></li>

+ <li><a href="/en/XUL/datepicker" title="en/XUL/datepicker">datepicker</a></li>

+ <li><a href="/en/XUL/menulist" title="en/XUL/menulist">menulist</a></li>

+ <li><a href="/en/XUL/progressmeter" title="en/XUL/progressmeter">progressmeter</a></li>

+ <li><a href="/en/XUL/radio" title="en/XUL/radio">radio</a></li>

+ <li><a href="/en/XUL/radiogroup" title="en/XUL/radiogroup">radiogroup</a></li>

+ <li><a href="/en/XUL/scale" title="en/XUL/scale">scale</a></li>

+ <li><a href="/en/XUL/splitter" title="en/XUL/splitter">splitter</a></li>

+ <li><a href="/en/XUL/textbox" title="en/XUL/textbox">textbox</a></li>

+ <li><a href="/En/XUL/Textbox_(Toolkit_autocomplete)" title="en/XUL/textbox_(Firefox_autocomplete)">textbox (Firefox autocomplete)</a></li>

+ <li><a href="/En/XUL/Textbox_(XPFE_autocomplete)" title="en/XUL/textbox_(Mozilla_autocomplete)">textbox (Mozilla autocomplete)</a></li>

+ <li><a href="/en/XUL/timepicker" title="en/XUL/timepicker">timepicker</a></li>

+ <li><a href="/en/XUL/description" title="en/XUL/description">description</a></li>

+ <li><a href="/en/XUL/label" title="en/XUL/label">label</a></li>

+ <li><a href="/en/XUL/image" title="en/XUL/image">image</a></li>

+ <li><a href="/en/XUL/listbox" title="en/XUL/listbox">listbox</a></li>

+ <li><a href="/en/XUL/listitem" title="en/XUL/listitem">listitem</a></li>

+ <li><a href="/en/XUL/listcell" title="en/XUL/listcell">listcell</a></li>

+ <li><a href="/en/XUL/listcol" title="en/XUL/listcol">listcol</a></li>

+ <li><a href="/en/XUL/listcols" title="en/XUL/listcols">listcols</a></li>

+ <li><a href="/en/XUL/listhead" title="en/XUL/listhead">listhead</a></li>

+ <li><a href="/en/XUL/listheader" title="en/XUL/listheader">listheader</a></li>

+ <li><a href="/en/XUL/richlistbox" title="en/XUL/richlistbox">richlistbox</a></li>

+ <li><a href="/en/XUL/richlistitem" title="en/XUL/richlistitem">richlistitem</a></li>

+ <li><a href="/en/XUL/tree" title="en/XUL/tree">tree</a></li>

+ <li><a href="/en/XUL/treecell" title="en/XUL/treecell">treecell</a></li>

+ <li><a href="/en/XUL/treechildren" title="en/XUL/treechildren">treechildren</a></li>

+ <li><a href="/en/XUL/treecol" title="en/XUL/treecol">treecol</a></li>

+ <li><a href="/en/XUL/treecols" title="en/XUL/treecols">treecols</a></li>

+ <li><a href="/en/XUL/treeitem" title="en/XUL/treeitem">treeitem</a></li>

+ <li><a href="/en/XUL/treerow" title="en/XUL/treerow">treerow</a></li>

+ <li><a href="/en/XUL/treeseparator" title="en/XUL/treeseparator">treeseparator</a></li>

+ <li><a href="/en/XUL/box" title="en/XUL/box">box</a></li>

+ <li><a href="/en/XUL/hbox" title="en/XUL/hbox">hbox</a></li>

+ <li><a href="/en/XUL/vbox" title="en/XUL/vbox">vbox</a></li>

+ <li><a href="/en/XUL/bbox" title="en/XUL/bbox">bbox</a></li>

+ <li><a href="/en/XUL/deck" title="en/XUL/deck">deck</a></li>

+ <li><a href="/en/XUL/stack" title="en/XUL/stack">stack</a></li>

+ <li><a href="/en/XUL/grid" title="en/XUL/grid">grid</a></li>

+ <li><a href="/en/XUL/columns" title="en/XUL/columns">columns</a></li>

+ <li><a href="/en/XUL/column" title="en/XUL/column">column</a></li>

+ <li><a href="/en/XUL/rows" title="en/XUL/rows">rows</a></li>

+ <li><a href="/en/XUL/row" title="en/XUL/row">row</a></li>

+ <li><a href="/en/XUL/scrollbox" title="en/XUL/scrollbox">scrollbox</a></li>

+ <li><a href="/en/XUL/action" title="en/XUL/action">action</a></li>

+ <li><a href="/en/XUL/assign" title="en/XUL/assign">assign</a></li>

+ <li><a href="/en/XUL/binding" title="en/XUL/binding">binding</a></li>

+ <li><a href="/en/XUL/bindings" title="en/XUL/bindings">bindings</a></li>

+ <li><a href="/en/XUL/conditions" title="en/XUL/conditions">conditions</a></li>

+ <li><a href="/en/XUL/content" title="en/XUL/content">content</a></li>

+ <li><a href="/en/XUL/member" title="en/XUL/member">member</a></li>

+ <li><a href="/en/XUL/param" title="en/XUL/param">param</a></li>

+ <li><a href="/en/XUL/query" title="en/XUL/query">query</a></li>

+ <li><a href="/en/XUL/queryset" title="en/XUL/queryset">queryset</a></li>

+ <li><a href="/en/XUL/rule" title="en/XUL/rule">rule</a></li>

+ <li><a href="/en/XUL/template" title="en/XUL/template">template</a></li>

+ <li><a href="/en/XUL/textnode" title="en/XUL/textnode">textnode</a></li>

+ <li><a href="/en/XUL/triple" title="en/XUL/triple">triple</a></li>

+ <li><a href="/en/XUL/where" title="en/XUL/where">where</a></li>

+ <li><a href="/en/XUL/script" title="en/XUL/script">script</a></li>

+ <li><a href="/en/XUL/commandset" title="en/XUL/commandset">commandset</a></li>

+ <li><a href="/en/XUL/command" title="en/XUL/command">command</a></li>

+ <li><a href="/en/XUL/broadcaster" title="en/XUL/broadcaster">broadcaster</a></li>

+ <li><a href="/en/XUL/broadcasterset" title="en/XUL/broadcasterset">broadcasterset</a></li>

+ <li><a href="/en/XUL/observes" title="en/XUL/observes">observes</a></li>

+ <li><a href="/en/XUL/key" title="en/XUL/key">key</a></li>

+ <li><a href="/en/XUL/keyset" title="en/XUL/keyset">keyset</a></li>

+ <li><a href="/en/XUL/stringbundle" title="en/XUL/stringbundle">stringbundle</a></li>

+ <li><a href="/en/XUL/stringbundleset" title="en/XUL/stringbundleset">stringbundleset</a></li>

+ <li><a href="/en/XUL/scrollbar" title="en/XUL/scrollbar">arrowscrollbox</a></li>

+ <li><a href="/en/XUL/dropmarker" title="en/XUL/dropmarker">dropmarker</a></li>

+ <li><a href="/en/XUL/grippy" title="en/XUL/grippy">grippy</a></li>

+ <li><a href="/en/XUL/scrollbar" title="en/XUL/scrollbar">scrollbar</a></li>

+ <li><a href="/en/XUL/scrollcorner" title="en/XUL/scrollcorner">scrollcorner</a></li>

+ <li><a href="/en/XUL/spinbuttons" title="en/XUL/spinbuttons">spinbuttons</a></li>

+</ol>

+<ul>

+ <li><a href="/en/XUL/Attribute" title="en/XUL/Attribute">Todos os Atributos</a></li>

+ <li><a href="/en/XUL/Property" title="en/XUL/Property">Todas as Propriedades</a></li>

+ <li><a href="/en/XUL/Method" title="en/XUL/Method">Todos os Métofos</a></li>

+ <li><a href="/en/XUL_element_attributes" title="en/XUL_element_attributes">Atributos definidos para todos os elemetos XUL</a></li>

+ <li><a href="/en/XUL/Style" title="en/XUL/Style">Classes de Estilo</a></li>

+ <li><a href="/en/XUL/Events" title="en/XUL/Events">Eventos Manuais</a></li>

+ <li><a href="/en/XUL/Deprecated_and_defunct_markup" title="en/XUL/Deprecated//Defunct_Markup">Obsoleto/Markup</a> <a href="/en/XUL/Deprecated_and_defunct_markup" title="en/XUL/Deprecated//Defunct_Markup">Extinta</a></li>

+</ul>

+---

+title: XULRunner

+slug: Archive/Mozilla/XULRunner

+translation_of: Archive/Mozilla/XULRunner

+---

+<div class="callout-box">

+ <strong><a href="/en-US/docs/Getting_started_with_XULRunner" title="Getting_started_with_XULRunner">Começando com o XULRunner</a></strong><br>

+ Uma breve introduçao ao XULRunner.</div>

+<div>

+ <strong>XULRunner</strong> é um ambiente de execução fornecido pela Mozilla que pode ser utilizado para inicializar aplicações <a href="/en-US/docs/XUL" title="XUL">XUL</a>+<a href="/en-US/docs/XPCOM" title="XPCOM">XPCOM</a> com interfaces ricas como do Firefox e Thunderbird. Ele provê mecanismos para instalação, atualização e desinstalação de aplicações. XULRunner também fornece a libxul, uma solução que permite embarcar tecnologias da Mozilla em outros projetos e produtos.</div>

+<table class="topicpage-table">

+ <tbody>

+ <tr>

+ <td>

+ <h2 id="Releases" name="Releases">Lançamentos</h2>

+ <div class="note">

+ <p>XULRunner 22.0 foi lançado e pode ser baixado em <a class="external" href="http://ftp.mozilla.org/pub/mozilla.org/xulrunner/releases/" title="http://ftp.mozilla.org/pub/mozilla.org/xulrunner/releases/">ftp.mozilla.org</a>. Leia as <a class="internal" href="/en-US/docs/XULRunner_1.9.2_Release_Notes" title="XULRunner 1.9.2 Release Notes">notas de lançamento</a> para instalação, desinstalação e outras informações.</p>

+ <p>Firefox 3 e versões recentes trazem um pacote privado do XULRunner, que pode rodar qualquer aplicação compatível com XULRunner usando <code>-app</code> switch.</p>

+ <p><a href="/en-US/docs/XULRunner/Old_Releases" title="XULRunner/Old_Releases">Compilações antigas </a>também estão disponíveis.</p>

+ </div>

+ <h2 id="Overview" name="Overview">Visão geral</h2>

+ <ul>

+ <li>{{ interwiki('wikimo', 'XULRunner', 'Plano de Desenvolvimento') }}</li>

+ <li><a href="/en-US/docs/XULRunner/What_XULRunner_Provides" title="XULRunner/What_XULRunner_Provides">O que XULRunner proporciona</a></li>

+ <li><a href="/en-US/docs/XULRunner_FAQ" title="XULRunner_FAQ">XULRunner FAQ</a></li>

+ <li>Nightly builds: <a class="external" href="http://ftp.mozilla.org/pub/mozilla.org/xulrunner/nightly/latest-trunk/">unstable-trunk</a></li>

+ </ul>

+ <h2 class="Documentation" id="Documentation" name="Documentation">DocumentaÇÃO</h2>

+ <dl>

+ <dt>

+ <a href="/en-US/docs/Getting_started_with_XULRunner" title="Getting_started_with_XULRunner">Iniciando com XULRunner</a></dt>

+ <dd>

+ Breve tutorial sobre desenvolvimento de aplicações desktop com XULRunner.</dd>

+ <dt>

+ <a href="/en-US/docs/XUL_Tutorial" title="XUL Tutorial">Tutorial XUL</a></dt>

+ <dd>

+ Assim que você tiver uma aplicação XULRunner em funcionamento, utilize o tutorial XUL para expandí-la em uma fantástica aplicação XUL.</dd>

+ <dt>

+ <a href="/en-US/docs/XULRunner_tips" title="XULRunner_tips">Dicas XULRunner</a></dt>

+ <dd>

+ Uma coleção de dicas para trabalhar com o XULRunner.</dd>

+ <dt>

+ <a href="/en-US/docs/XULRunner/Deploying_XULRunner_1.8" title="XULRunner/Deploying_XULRunner_1.8">Deploy com XULRunner</a></dt>

+ <dd>

+ Uma introdução em como empacotar sua aplicação com XULRunner.</dd>

+ <dt>

+ <a href="/en-US/docs/XULRunner_Hall_of_Fame" title="XULRunner_Hall_of_Fame">Hall da Fama do XULRunner</a></dt>

+ <dd>

+ Siga todas as aplicações baseadas em XULRunner disponíveis.</dd>

+ <dt>

+ <a href="/en-US/docs/Developer_Guide/Build_Instructions" title="Build_Documentation">Documentação para build</a></dt>

+ <dd>

+ Aprenda como obter os códigos-fonte e efetuar o build.</dd>

+ <dt>

+ <a href="/en-US/docs/Debugging_a_XULRunner_Application" title="Debugging_a_XULRunner_Application">Documentação de Debug</a></dt>

+ <dd>

+ Etapas para configurar Venkman para debugar sua aplicação</dd>

+ <dt>

+ <a class="external" href="http://zenit.senecac.on.ca/wiki/index.php/XULRunner_Guide">Guia XULRunner</a></dt>

+ <dd>

+ Introdução e tutorial bastante completos, porém desatualizados para o XULRunner, que agregam grande parte da documentação encontrada aqui.</dd>

+ </dl>

+ <p><span class="alllinks"><a href="/en-US/docs/tag/XULRunner" title="tag/XULRunner">Ver todos...</a></span></p>

+ </td>

+ <td>

+ <h2 class="Community" id="Community" name="Community">COMUNIDADE</h2>

+ <ul>

+ <li>Ver fóruns da Mozilla... {{ DiscussionList("dev-platform", "mozilla.dev.platform") }}</li>

+ <li><a class="link-irc" href="irc://irc.mozilla.org/#xulrunner">#xulrunner no irc.mozilla.org</a></li>

+ <li><a href="/en-US/docs/XULRunner/Community" title="XULRunner/Community">Outros links da comunidade...</a></li>

+ </ul>

+ <h2 class="Related_Topics" id="Related_Topics" name="Related_Topics">TÓPICOS RELACIONADOS</h2>

+ <ul>

+ <li><a href="/en-US/docs/XUL" title="XUL">XUL</a></li>

+ </ul>

+ <h2 id="See_also" name="See_also">Ver também</h2>

+ <ul>

+ <li><a class="external" href="http://www.kodewerx.org/wiki/A_Brief_Introduction_To_XULRunner:_Part_1" title="http://www.kodewerx.org/wiki/A_Brief_Introduction_To_XULRunner:_Part_1">Uma breve introdução ao XULRunner</a></li>

+ </ul>

+ </td>

+ </tr>

+ </tbody>

+</table>

+<p> </p>