JavaScript dans les widgets personnalisés

Les fonctions JavaScript peuvent être intégrées dans les widgets personnalisés.

Après avoir double-cliquer sur le widget personnalisé et cliqué sur le cadenas, le mode d'édition est actif et il est possible d'associer le code JavaScript pour les événements disponibles.

Notez l'utilisation de l'opérateur this. Lequel est nécessaire pour permettre de multiples instances du widget personnalisé.

Si vous avez besoin de faire référence à un élément du widget, vous pouvez utiliser le mot-clé wgt. Par exemple, utilisez wgt.id pour faire référence à l'id de l'instance active du widget.

Si vous coupez et collez des instances du widget personnalisé de l'exemple ci-dessus et les exécutez, p. ex. dans le simulateur, vous obtiendrez le résultat ci-dessous.

Propriété onActivate

Pour initialiser le widget personnalisé, il est possible de définir la propriété onActive avec une fonction d'initialisation comme dans l'exemple ci-dessous.

La fonction onActivate() sera exécutée au chargement de la page.

Noter que le widget personnalisé peut aussi passer à l'intérieur de la galerie de l'utilisateur pour une réutilisation ultérieure.

 

Code JavaScript utilisé dans les exemples de ce chapitre

/*! javascript module: widget-1.0.js javascript source file path: lib\com\example\widget-1.0\widget-1.0.js */ this.wMSG = wgt.getWidget(wgt.id+".field1") this.BtnStd1_btn_onMouseClick = function (me, eventInfo) { var now = new Date(); this.wMSG.setProperty("value", now.toString().slice(0, 24)); } this.onActivate = function() { this.wMSG.setProperty("value", "Button never pressed"); }; this.onActivate();