5.7.4.7 attributeHelperSelect

5.7.4.7.1 Déclenchement

L'aide à la saisie associée à l'attribut a été déclenchée, le résultat de cette aide à la saisie est arrivé sur le client et l'utilisateur a cliqué sur un résultat. Cet événement permet de personnaliser le comportement de la sélection d'une valeur de l'aide à la saisie.

5.7.4.7.2 Éléments passés au callback

event

objet événement standard de jQuery,

documentObject

un objet document décrivant le document courant.

attributeObject

un objet attribut décrivant l'attribut courant.

options (objet)

Un objet contenant la ligne sélectionnée. Il contient les propriétés suivantes :

• title : élément affiché dans la liste déroulante,
• error : message d'erreur (optionnel),

• values : objet contenant les valeurs à attribuer au document en cas de sélection de cette ligne.

  La clef représente l'identifiant logique de l'attribut auquel al valeur sera affectée, et le contenu est similaire à un setValue, soit un objet avec les propriétés

  • value : valeur à stocker,
  • displayValue : valeur à présenter à l'utilisateur.

L'élément options peut-être modifié.

5.7.4.7.3 Annulable

Oui. Dans ce cas l'aide à la saisie est annulée.

5.7.4.7.4 Exemple

Cet exemple annule la sélection de toutes les aides à la saisie.

window.dcp.document.documentController("addEventListener",
    "attributeHelperSelect",
    {
        "name": "attributeHelperSelect"
    },
    function displayArrayModified(event, documentObject, attributeObject, options) {
       event.preventDefault();
    }
);