Sistema de preferencias

  • Enlace amigable (slug) de la revisión: Sistema_de_preferencias
  • Título de la revisión: Sistema de preferencias
  • Id de la revisión: 173166
  • Creada:
  • Creador: Mgjbot
  • ¿Es la revisión actual? No
  • Comentario robot Añadido: [[de:Preferences System]] <<langbot>>

Contenido de la revisión

{{ Traducción("inglés", "Preferences System", "en") }}

Este documento describe el nuevo sistema de preferencias del Toolkit de Aviary. Usando este sistema es posible crear ventanas de preferencias que se muestren y funcionen apropiadamente en varias plataformas (Windows, MacOS X y GNOME).

Ten en cuenta que el sistema de preferencias solo está disponible desde Firefox/Thunderbird 1.5 (incluyendo sus versiones alpha y beta). No puedes usarlo en las aplicaciones y extensiones basadas en Firefox 1.0.

El nuevo sistema esta implementado mediante unos pocos elementos y atributos en XUL. Puedes encontrar información sobre estos, simplemente haciendo clic en alguno de los enlaces a continuación:

{{ Sistema_de_preferencias_TOC() }}

Uso

this will eventually be moved from here

El código para una típica ventana de preferencias sería algo así:

<prefwindow id="appPreferences"
            xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul">
  <prefpane id="pane1" label="&pane1.title;">
    <preferences>
      <preference id="pref1" name="pref.name" type="bool"/>
    </preferences>
     
   .. UI elements that refer to the preferences above, e.g.:
    <checkbox id="check1" preference="pref1"
              label="&check1.label;" accesskey="&check1.accesskey;"/>
  </prefpane>

  <prefpane id="pane2" label="&pane2.title;" src="chrome://uri/to/pane.xul"/>
</prefwindow>

La hoja de contenido puede ser especificada en línea, o mediante un enlace externo que cargue dicho contenido en la misma, de manera dinámica.Presta especial atención al HIGs de las plataformas en las que estés desarrollando y al usar el preprocesador de XUL si fuera necesario para configurar apropiadamente los diferentes titulos de ventana. Debes especificar también el ancho de la ventana (en el em) así como hacer un uso correcto del preprocesador para cada plataforma que uses , así como la altura (en el em) para aquellas plataformas en donde el tamaño de la ventana no cambie cuando se cambie al panel seleccionado.(p.ej. Windows).

Uso en aplicaciones XULRunner

Cuando abras el diálogo de preferencias en una aplicación XULRunner, asegúrate de comprobar lo siguiente:

  • Las preferencias boleanas browser.preferences.animateFadeIn y browser.preferences.instantApply deben ser definidas en las preferencias por defecto (véase {{ Bug("302509") }}). Ejemplo:
pref("browser.preferences.animateFadeIn", false);
pref("browser.preferences.instantApply", true);
  • Al llamar a openDialog() para abrir las preferencias de diálogo, "toolbar" debe incluirse en la secuencia de las características. Ejemplo:
var features = "chrome,titlebar,toolbar,centerscreen,modal";
window.openDialog(url, "Preferences", features);

Bugzilla

El componente para bugs (no disponible en las opciones de la interfaz de usuario en Firefox/Thunderbird ) se encuentra en Herramientas:Preferencias (archivar un bug lista de bugs)

{{ languages( { "de": "de/Preferences_System", "en": "en/Preferences_System", "fr": "fr/Syst\u00e8me_de_pr\u00e9f\u00e9rences", "ja": "ja/Preferences_System", "pl": "pl/System_preferencji" } ) }}

Fuente de la revisión

<p>
</p><p>{{ Traducción("inglés", "Preferences System", "en") }}
</p><p>Este documento describe el nuevo sistema de preferencias del Toolkit de Aviary. Usando este sistema es posible crear ventanas de preferencias que se muestren y funcionen apropiadamente en varias plataformas (Windows, MacOS X y GNOME).
</p><p><b>Ten en cuenta</b> que el sistema de preferencias solo está disponible desde Firefox/Thunderbird 1.5 (incluyendo sus versiones alpha y beta). No puedes usarlo en las aplicaciones y extensiones basadas en Firefox 1.0.
</p><p>El nuevo sistema esta implementado mediante unos pocos elementos y atributos en <a href="es/XUL">XUL</a>. Puedes encontrar información sobre estos, simplemente haciendo clic en alguno de los enlaces a continuación:
</p><p>{{ Sistema_de_preferencias_TOC() }}
</p>
<h3 id="Uso" name="Uso"> Uso </h3>
<p><span class="comment">this will eventually be moved from here</span>
</p><p>El código para una típica ventana de preferencias sería algo así:
</p>
<pre>&lt;prefwindow id="appPreferences"
            xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"&gt;
  &lt;prefpane id="pane1" label="&amp;pane1.title;"&gt;
    &lt;preferences&gt;
      &lt;preference id="pref1" name="pref.name" type="bool"/&gt;
    &lt;/preferences&gt;
     
   .. UI elements that refer to the preferences above, e.g.:
    &lt;checkbox id="check1" preference="pref1"
              label="&amp;check1.label;" accesskey="&amp;check1.accesskey;"/&gt;
  &lt;/prefpane&gt;

  &lt;prefpane id="pane2" label="&amp;pane2.title;" src="chrome://uri/to/pane.xul"/&gt;
&lt;/prefwindow&gt;
</pre>
<p>La hoja de contenido puede ser especificada en línea, o mediante un enlace externo que cargue dicho contenido en la misma, de manera dinámica.Presta especial atención al HIGs de las plataformas en las que estés desarrollando y al usar el preprocesador de XUL si fuera necesario para configurar apropiadamente los diferentes titulos de ventana. Debes especificar también el ancho de la ventana (en el em) así como hacer un uso correcto del preprocesador para cada plataforma que uses , así como la altura (en el em) para aquellas plataformas en donde el tamaño de la ventana no cambie cuando se cambie al panel seleccionado.(p.ej. Windows).
</p>
<h3 id="Uso_en_aplicaciones_XULRunner" name="Uso_en_aplicaciones_XULRunner"> Uso en aplicaciones XULRunner </h3>
<p>Cuando abras el diálogo de preferencias en una aplicación XULRunner, asegúrate de comprobar lo siguiente:
</p>
<ul><li> Las preferencias boleanas browser.preferences.animateFadeIn y browser.preferences.instantApply deben ser definidas en las preferencias por defecto (véase {{ Bug("302509") }}). Ejemplo:
</li></ul>
<pre class="eval">pref("browser.preferences.animateFadeIn", false);
pref("browser.preferences.instantApply", true);
</pre>
<ul><li> Al llamar a openDialog() para abrir las preferencias de diálogo, "toolbar" debe incluirse en la secuencia de las características. Ejemplo:
</li></ul>
<pre class="eval">var features = "chrome,titlebar,toolbar,centerscreen,modal";
window.openDialog(url, "Preferences", features);
</pre>
<h3 id="Bugzilla" name="Bugzilla"> Bugzilla </h3>
<p>El componente para bugs (no disponible en las opciones de la interfaz de usuario en Firefox/Thunderbird ) se encuentra en Herramientas:Preferencias (<a class="link-https" href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Toolkit">archivar un bug</a> <a class="link-https" href="https://bugzilla.mozilla.org/buglist.cgi?query_format=advanced&amp;product=Toolkit&amp;component=Preferences&amp;resolution=---&amp;chfieldto=Now">lista de bugs</a>)
</p>
<div class="noinclude">
</div>
{{ languages( { "de": "de/Preferences_System", "en": "en/Preferences_System", "fr": "fr/Syst\u00e8me_de_pr\u00e9f\u00e9rences", "ja": "ja/Preferences_System", "pl": "pl/System_preferencji" } ) }}
Revertir a esta revisión