5.7.3.9 ready

5.7.3.9.1 Déclenchement

Le document est chargé, l'interface calculée et présentée à l'utilisateur.

Lorsqu'un écouteur pour cet événement est ajouté alors que le document est déjà chargé, cet écouteur est déclenché immédiatement.

Note : Lorsqu'un document a des onglets, cet événement est propagé avant l'affichage du premier onglet. En effet, l'affichage du contenu des onglets est réalisé lors de la sélection de ce dernier. Lorsque l'événement ready est capturé les widgets d'attributs présents dans les onglets ne sont pas encore affichés que ce soit sur le premier onglet ou les suivants. L'événement attributeReady d'un attribut onglet est propagé lorsque son contenu est affiché. Les événements attributeReady des onglets sont donc propagés après l'événement ready du document.

5.7.3.9.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.9.3 Annulable

Non

5.7.3.9.4 Exemple

Ajouter un message à chaque chargement de document.

window.dcp.document.documentController("addEventListener",
    "ready",
    function(event, documentObject, message) {
        this.documentController("showMessage", "I'm ready");
    }
);

Enregistrer un suivi de la modification de l'âge pour les documents de type animal.

window.dcp.document.documentController("addEventListener",
    "ready",
    {
        "name": "addAnimalEvent",
        "documentCheck": function(documentObject) {
            return documentObject.family.name === "ANIMAL";
        }
    },
    function(event, documentObject) {
        this.documentController("addEventListener",
            "change",
            {
                "name" : "changeAge.animal",
                "documentCheck": function(documentObject) {
                    return documentObject.family.name === "ANIMAL";
                },
                "attributeCheck" : function(attributeObject) {
                    return attributeObject.id === "animal_date"
                }
            },
            function() {
                this.documentController("showMessage", "You have changed the age");
            }
        );
   }
);

Présenté de cette manière, cet événement sera ajouté à chaque chargement du document. Il faudra donc enlever l'événement changeAge.animal à la fermeture du document (voir l'événement close).