mozilla

preference

Déclare une préférence qui peut être ajustée dans un prefpane. Cet élément doit être placé à l'intérieur d'un élément preferences. Chaque élément preference 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 preference de l'élément d'interface utilisateur.

Pour plus d'informations, consultez l'article Système de préférences.

Attributs
disabled, instantApply, inverted, name, onchange, readonly, tabindex, type
Propriétés
disabled, inverted, locked, name, preferences, readonly, tabIndex, type, value
Méthodes
hasUserValue, reset

Exemples

(exemple nécessaire)

Attributs

disabled
Type : booléen
Indique si l'élément est ou non désactivé. Si cette valeur est définie à true, 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 command ne se déclenchera pas.


Image:XUL_ref_attr_disabled.png
<!-- La case à cocher active/désactive le bouton -->
<checkbox label="Enable button" 
    onclick="document.getElementById('buttRemove').disabled = this.checked"/>
<button id="buttRemove" label="Remove All" disabled="true"/>
instantApply
Type : booléen
Si sa valeur est true, la préférence sera modifiée dès que l'élément d'interface utilisateur est modifié.


inverted
Type : booléen
Pour les préférences booléennes, l'indication de cet attribut à true 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.


name
Type : chaîne de caractères
Le nom de la préférence à modifier. Par exemple, la page d'accueil du navigateur est définie par la préférence browser.startup.homepage.
onchange
Type : code de script
Le code figurant dans l'attribut onchange est appelé lorsque la valeur de l'élément est modifiée.


readonly
Type : booléen
Si défini à true, l'utilisateur ne peut pas modifier la valeur de l'élément. Cependant, celle-ci peut toujours être modifiée par un script.
tabindex
Type : entier
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 tabindex est plus haut se trouvent plus tard dans la séquence de tabulation.
type
Type : une des valeurs ci-dessous
Le type de préférence qui doit être une des valeurs suivantes.
  • bool : Un booléen défini à true ou false. Habituellement, on connectera un élément checkbox à ce type de préférence.
  • int : Un entier
  • string : Une chaîne de caractères
  • unichar : Une chaîne de caractères Unicode
  • wstring : 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.
  • file : Un fichier. Le chemin vers le fichier sera stocké dans la préférence.

Propriétés

disabled
Type : booléen
Obtient et définit la valeur de l'attribut disabled.
inverted
Type : booléen
Obtient et définit la valeur de l'attribut inverted.


locked
Type : booléen
Si définie à true, 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.


name
Type : chaîne de caractères
Le nom de la préférence (élément preference) à modifier. Par exemple, la page d'accueil du navigateur est définie par la préférence browser.startup.homepage.


preferences
Type : élément
Référence à l'élément preferences conteneur.


readonly
Type : booléen
Si définie à true, l'utilisateur ne peut pas modifier la valeur de l'élément.
Cette propriété toute en minuscules n'est utilisée qu'avec l'élément preference et sera peut-être renommée en readOnly dans des versions ultérieures. D'autres éléments utilisent la propriété readOnly. L'attribut correspondant est cependant readonly en minuscules.
tabIndex
Type : entier
Obtient et définit la valeur de l'attribut tabindex.
type
Type : chaîne de caractères
Obtient et définit la valeur de l'attribut type.
value
Type : chaîne
Obtient et définit la valeur de l'attribut value.

Méthodes

hasUserValue()
Type de retour : booléen
Renvoie true si la préférence a été modifiée par rapport à sa valeur par défaut.


reset()
Type de retour : aucune valeur renvoyée
Réinitialise la préférence à sa valeur par défaut.
Pour un élément textbox, la liste de transactions d'annulation est également vidée (Gecko 1.9).


Héritées de XUL element
blur, click, doCommand, focus, getElementsByAttribute

Héritées de DOM element
addEventListener(), appendChild(), dispatchEvent(), getAttribute(), getAttributeNode(), getAttributeNodeNS(), getAttributeNS(), getElementsByTagName(), getElementsByTagNameNS(), hasAttribute(), hasAttributeNS(), hasAttributes(), hasChildNodes(), insertBefore(), isSupported(), normalize(), removeAttribute(), removeAttributeNode(), removeAttributeNS(), removeChild(), removeEventListener(), replaceChild(), setAttribute(), setAttributeNode(), setAttributeNodeNS(), setAttributeNS()

Sujets liés

À faire

Étiquettes et contributeurs liés au document

Étiquettes : 
Contributeurs à cette page : lmorchard, BenoitL, Mgjbot
Dernière mise à jour par : lmorchard,