mozilla
Vos résultats de recherche

    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 : 
    Contributors to this page: lmorchard, BenoitL, Mgjbot
    Dernière mise à jour par : lmorchard,