5.7.3.14 validate

5.7.3.14.1 Déclenchement

Le document va être sauvegardé. Cet événement est déclenché avant la sauvegarde.

5.7.3.14.2 Éléments passés au callback

event: objet événement standard de jQuery,
documentObject: un objet document décrivant le document courant.

5.7.3.14.3 Annulable

Oui. Dans ce cas, la sauvegarde est annulée et rien n'est fait.

5.7.3.14.4 Exemple

Cet exemple

ajoute au ready du document (fonction addAnimalEvents) un écouteur sur l'événement validate,
l'écouteur (fonction preventValidateAnimal) déclare le document en erreur de validation si
- l'attribut zoo_title est différent de fermer.
Dans ce cas, il affiche un message pour avertir l'utilisateur qu'il doit changer la valeur.

window.dcp.document.documentController("addEventListener",
    "ready",
    {
        "name": "addAnimalEvent",
        "documentCheck": function(documentObject) {
            return documentObject.family.name === "ANIMAL";
        }
    }, function addAnimalEvents() {
        this.documentController("addEventListener",
        "validate",
        {
            "name": "preventValidate.animal",
            "documentCheck": function(documentObject) {
                return documentObject.family.name === "ANIMAL";
            }
        },
        function preventValidateAnimal(event, documentObject) {
            if (this.documentController("getValue", "zoo_title").value !== "fermer") {
                event.preventDefault();
                this.documentController("showMessage", {
                    "type" : "error",
                    "message" : "If you want close the doc, change the title to fermer"
                });
            }
        });
    }
);

Source : client/ui/events/eventsdocument/validate.md Dynacase Platform 3.2 | Document User Interface Manuel de référence, version 1.0 édition 2, © Labs <labs@anakeen.com>