path: root/files/fr/archive/mozilla/xul/preference/index.html

---
title: preference
slug: Archive/Mozilla/XUL/preference
tags:
  - Éléments_XUL
translation_of: Archive/Mozilla/XUL/preference
---
<div class="noinclude"><span class="breadcrumbs XULRef_breadcrumbs">
 « <a href="/fr/docs/Référence_XUL">Accueil de la référence XUL</a>    [
 <a href="#Exemples">Exemples</a> |
 <a href="#Attributs">Attributs</a> |
 <a href="#Propri.C3.A9t.C3.A9s">Propriétés</a> |
 <a href="#M.C3.A9thodes">Méthodes</a> |
 <a href="#Sujets_li.C3.A9s">Sujets liés</a> ]
</span></div> <p>Déclare une préférence qui peut être ajustée dans un <code><a href="/fr/docs/Mozilla/Tech/XUL/prefpane" title="prefpane">prefpane</a></code>. Cet élément doit être placé à l'intérieur d'un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/preferences" title="preferences">preferences</a></code>. Chaque élément <code>preference</code> correspond à une préférence qui est stockée dans le fichier de préférences de l'utilisateur. Il est possible de connecter un élément d'interface utilisateur comme une case à cocher à un élément de préférence à l'aide de l'attribut <code id="a-preference"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/preference">preference</a></code> de l'élément d'interface utilisateur.
</p><p>Pour plus d'informations, consultez l'article <a href="fr/Syst%c3%a8me_de_pr%c3%a9f%c3%a9rences">Système de préférences</a>.
</p>
<dl><dt> Attributs
</dt><dd> <a href="#a-disabled">disabled</a>, <a href="#a-instantApply">instantApply</a>, <a href="#a-inverted">inverted</a>, <a href="#a-preference.name">name</a>, <a href="#a-onchange">onchange</a>, <a href="#a-readonly">readonly</a>, <a href="#a-tabindex">tabindex</a>, <a href="#a-preference.type">type</a>
</dd></dl>
<dl><dt> Propriétés
</dt><dd> <a href="#p-disabled">disabled</a>, <a href="#p-inverted">inverted</a>, <a href="#p-locked">locked</a>, <a href="#p-name">name</a>, <a href="#p-preference.preferences">preferences</a>, <a href="#p-readonly">readonly</a>, <a href="#p-tabIndex">tabIndex</a>, <a href="#p-type">type</a>, <a href="#p-value">value</a>
</dd></dl>
<dl><dt> Méthodes
</dt><dd> <a href="#m-hasUserValue">hasUserValue</a>, <a href="#m-reset">reset</a>
</dd></dl>
<h3 id="Exemples" name="Exemples"> Exemples </h3>
<p>(exemple nécessaire)
</p>
<h3 id="Attributs" name="Attributs"> Attributs </h3>
<p>
</p><div id="a-disabled">

<dl><dt> <code id="a-disabled"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/disabled">disabled</a></code>
</dt><dd> Type : <i>booléen</i>
</dd><dd> Indique si l'élément est ou non désactivé. Si cette valeur est définie à <code>true</code>, l'élément est désactivé. Les éléments désactivés sont habituellement affichés avec leur texte grisé. Si l'élément est désactivé, il ne répond pas aux actions de l'utilisateur, il ne peut pas recevoir le focus, et l'évènement <code>command</code> ne se déclenchera pas. </dd></dl>
<p><br>
</p>
<div class="float-right"><img alt="Image:XUL_ref_attr_disabled.png"></div>
<pre>&lt;!-- La case à cocher active/désactive le bouton --&gt;
&lt;checkbox label="Enable button"
    onclick="document.getElementById('buttRemove').disabled = this.checked"/&gt;
&lt;button id="buttRemove" label="Remove All" disabled="true"/&gt;
</pre>
</div>
<div id="a-instantApply">

<dl><dt> <code id="a-instantApply"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/instantApply">instantApply</a></code>
</dt><dd> Type : <i>booléen</i>
</dd><dd> Si sa valeur est <code>true</code>, la préférence sera modifiée dès que l'élément d'interface utilisateur est modifié.
</dd></dl>
<p><br>
</p>


</div>
<div id="a-inverted">

<dl><dt> <code id="a-inverted"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/inverted">inverted</a></code>
</dt><dd> Type : <i>booléen</i>
</dd><dd> Pour les préférences booléennes, l'indication de cet attribut à <code>true</code> indique que la valeur de la préférence est l'inverse de celle de l'élément d'interface utilisateur qui y est attaché. Par exemple, elle fait en sorte que cocher une case désactive la préférence associée au lieu de l'activer.
</dd></dl>
<p><br>
</p>


</div>
<div id="a-preference.name">

<dl><dt> <a href="fr/XUL/Attributs/preference.name">name</a>
</dt><dd> Type : <i>chaîne de caractères</i>
</dd><dd> Le nom de la préférence à modifier. Par exemple, la page d'accueil du navigateur est définie par la préférence <code>browser.startup.homepage</code>.
</dd></dl>


</div>
<div id="a-onchange">

<dl><dt> <code id="a-onchange"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/onchange">onchange</a></code>
</dt><dd> Type : <i>code de script</i>
</dd><dd> Le code figurant dans l'attribut <code>onchange</code> est appelé lorsque la valeur de l'élément est modifiée.
</dd></dl>
<p><br>
</p>


</div>
<div id="a-readonly">

<dl><dt> <code id="a-readonly"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/readonly">readonly</a></code>
</dt><dd> Type : <i>booléen</i>
</dd><dd> Si défini à <code>true</code>, l'utilisateur ne peut pas modifier la valeur de l'élément. Cependant, celle-ci peut toujours être modifiée par un script.
</dd></dl>


</div>
<div id="a-tabindex">

<dl><dt> <code id="a-tabindex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tabindex">tabindex</a></code>
</dt><dd> Type : <i>entier</i>
</dd><dd> L'ordre de tabulation de l'élément. L'ordre de tabulation est l'ordre dans lequel le focus se déplace lorsque l'utilisateur appuie sur la touche « tab ». Les éléments dont le <code>tabindex</code> est plus haut se trouvent plus tard dans la séquence de tabulation.
</dd></dl>


</div>
<div id="a-preference.type">

<dl> <dt><a href="/fr/XUL/Attributs/preference.type" title="fr/XUL/Attributs/preference.type">type</a></dt> <dd>Type : <em>une des valeurs ci-dessous</em></dd> <dd>Le type de préférence qui doit être une des valeurs suivantes.</dd>
</dl>
<ul> <li><code>bool</code> : Un booléen défini à <code>true</code> ou <code>false</code>. Habituellement, on connectera un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/checkbox" title="checkbox">checkbox</a></code> à ce type de préférence.</li> <li><code>int</code> : Un entier</li> <li><code>string</code> : Une chaîne de caractères</li> <li><code>unichar</code> : Une chaîne de caractères Unicode</li> <li><code>wstring</code> : Une chaîne localisée. Dans cette situation, la préférence enregistrera le chemin vers un fichier de propriétés contenant la valeur réelle de la préférence.</li> <li><code>file</code> : Un fichier. Le chemin vers le fichier sera stocké dans la préférence.</li>
</ul>


</div>

<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s"> Propriétés </h3>
<p>
</p><div id="p-disabled">
<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/disabled">disabled</a></span></code>
</dt><dd> Type : <i>booléen</i>
</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-disabled"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/disabled">disabled</a></code>.
</dd></dl>

</div>
<div id="p-inverted">
<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/inverted">inverted</a></span></code>
</dt><dd> Type : <i>booléen</i>
</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-inverted"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/inverted">inverted</a></code>.
</dd></dl>
<p><br>
</p>

</div>
<div id="p-locked">
<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/locked">locked</a></span></code>
</dt><dd> Type : <i>booléen</i>
</dd><dd> Si définie à <code>true</code>, la préférence a été verrouillée et désactivée dans la configuration système, ce qui empêche de changer sa valeur. Cette propriété est en lecture seule.
</dd></dl>
<p><br>
</p>

</div>
<div id="p-name">
<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/name">name</a></span></code>
</dt><dd> Type : <i>chaîne de caractères</i>
</dd><dd> Le nom de la préférence (élément <code><a href="/fr/docs/Mozilla/Tech/XUL/preference" title="preference">preference</a></code>) à modifier. Par exemple, la page d'accueil du navigateur est définie par la préférence <code>browser.startup.homepage</code>.
</dd></dl>
<p><br>
</p>

</div>
<div id="p-preference.preferences">
<dl><dt> <a href="fr/XUL/Propri%c3%a9t%c3%a9s/preference.preferences">preferences</a>
</dt><dd> Type : <i>élément</i>
</dd><dd> Référence à l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/preferences" title="preferences">preferences</a></code> conteneur.
</dd></dl>
<p><br>
</p>

</div>
<div id="p-readonly">
<dl>
  <dt>
    <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/readonly">readonly</a></span></code></dt>
  <dd>
    Type : <i>booléen</i></dd>
  <dd>
    Si définie à <code>true</code>, l'utilisateur ne peut pas modifier la valeur de l'élément.</dd>
  <dd>
    <div class="note">
      Cette propriété toute en minuscules n'est utilisée qu'avec l'élément <code><a href="/fr/docs/Mozilla/Tech/XUL/preference" title="preference">preference</a></code> et sera peut-être renommée en <code>readOnly</code> dans des versions ultérieures. D'autres éléments utilisent la propriété <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/readOnly">readOnly</a></span></code>. L'attribut correspondant est cependant <code id="a-readonly"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/readonly">readonly</a></code> en minuscules.</div>
  </dd>
</dl></div>
<div id="p-tabIndex">
<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/tabIndex">tabIndex</a></span></code>
</dt><dd> Type : <i>entier</i>
</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-tabindex"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/tabindex">tabindex</a></code>.
</dd></dl>

</div>
<div id="p-type">
<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/type">type</a></span></code>
</dt><dd> Type : <i>chaîne de caractères</i>
</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-type"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/type">type</a></code>.
</dd></dl>

</div>
<div id="p-value">
<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/value">value</a></span></code>
</dt><dd> Type : <i>chaîne</i>
</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-value"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/value">value</a></code>.
</dd></dl>

</div>

<h3 id="M.C3.A9thodes" name="M.C3.A9thodes"> Méthodes </h3>
<dl><dt> <span id="m-hasUserValue"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/hasUserValue">hasUserValue()</a></code></span>
</dt><dd> Type de retour : <i>booléen</i>
</dd><dd> Renvoie <code>true</code> si la préférence a été modifiée par rapport à sa valeur par défaut.
</dd></dl>
<p><br>
</p>
<dl><dt> <span id="m-reset"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/reset">reset()</a></code></span>
</dt><dd> Type de retour : <i>aucune valeur renvoyée</i>
</dd><dd> Réinitialise la préférence à sa valeur par défaut.
</dd><dd> Pour un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/textbox" title="textbox">textbox</a></code>, la liste de transactions d'annulation est également vidée (Gecko 1.9).
</dd></dl>
<p><br>
</p>
<span class="lang lang-fr" lang="fr">
<table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <tbody> <tr> <td> <p><strong>Héritées de XUL element</strong><br> <small> <span id="m-blur"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/blur">blur</a></code></span>, <span id="m-click"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/click">click</a></code></span>, <span id="m-doCommand"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/doCommand">doCommand</a></code></span>, <span id="m-focus"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/focus">focus</a></code></span>, <span id="m-getElementsByAttribute"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/getElementsByAttribute">getElementsByAttribute</a></code></span></small></p> <p><strong>Héritées de DOM element</strong><br> <small> <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.addEventListener">addEventListener()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.appendChild">appendChild()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.dispatchEvent">dispatchEvent()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.getAttribute">getAttribute()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.getAttributeNode">getAttributeNode()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.getAttributeNodeNS">getAttributeNodeNS()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.getAttributeNS">getAttributeNS()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.getElementsByTagName">getElementsByTagName()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.getElementsByTagNameNS">getElementsByTagNameNS()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.hasAttribute">hasAttribute()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.hasAttributeNS">hasAttributeNS()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.hasAttributes">hasAttributes()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.hasChildNodes">hasChildNodes()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.insertBefore">insertBefore()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.isSupported">isSupported()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.normalize">normalize()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.removeAttribute">removeAttribute()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.removeAttributeNode">removeAttributeNode()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.removeAttributeNS">removeAttributeNS()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.removeChild">removeChild()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.removeEventListener">removeEventListener()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.replaceChild">replaceChild()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.setAttribute">setAttribute()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.setAttributeNode">setAttributeNode()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.setAttributeNodeNS">setAttributeNodeNS()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.setAttributeNS">setAttributeNS()</a></code></small></p> </td> </tr> </tbody>
</table>

<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3>
<p>À faire
</p>
<div class="noinclude">
</div>
</span>