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: 173158
  • Creada:
  • Creador: M3n3chm0
  • ¿Es la revisión actual? No
  • Comentario /* Bugzilla */

Contenido de la revisión

{{wiki.template('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:

{{template.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>

El contenido del recuadro puede ser especificado en línea, o mediante un enlace externo que cargue dicho contenido en el recuadro de manera dinámica. Debes de leer cuidadosamente el HIGs de las plataformas que estés usando, y usar el preprocesador de XUL preprocessor 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 {{template.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 (file a bug list open bugs)

{{ wiki.languages( { "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>{{wiki.template('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>{{template.Sistema_de_preferencias_TOC()}}
</p>
<h3 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>El contenido del recuadro puede ser especificado en línea, o mediante un enlace externo que cargue dicho contenido en el recuadro de manera dinámica. Debes de leer cuidadosamente el HIGs de las plataformas que estés usando, y usar el preprocesador de XUL preprocessor 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 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 {{template.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 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="external" href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Toolkit">file a bug</a> <a class="external" href="https://bugzilla.mozilla.org/buglist.cgi?query_format=advanced&amp;product=Toolkit&amp;component=Preferences&amp;resolution=---&amp;chfieldto=Now">list open bugs</a>)
</p>{{ wiki.languages( { "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