Guide de référence JavaScript

L’interface Règles Composer utilise le moteur JavaScript du navigateur Web. L’assistant Règle Composer définit des règles intégrées qui sont ensuite converties en code JavaScript lors de l’exécution.

Cependant, si l’assistant Règle Composer ne répond toujours pas à vos besoins, vous pouvez créer une fonctionnalité spécifique par le biais de règles JavaScript puissantes et avancées. En outre, vous pouvez convertir de manière permanente des règles en code JavaScript et/ou créer des styles CSS personnalisés pour les formulaires.

Ce guide de référence décrit les propriétés de base du code JavaScript compatible dans Composer :

Remarques importantes : Lire attentivement Lorsqu’une règle est convertie en code JavaScript, elle ne peut pas être reconvertie en règle intégrée. Par conséquent, la règle peut être gérée uniquement via l’éditeur de code JavaScript (et non par le biais de l’interface utilisateur de l’assistant Règle). Le support Winshuttle ne peut pas vous aider à créer du code JavaScript ni à le déboguer.

Ajout de code JavaScript/des styles CSS à un formulaire

L’arborescence de solution Composer comporte deux nœuds dans lesquels sont stockés le code JavaScript et les styles CSS personnalisés. Ouvrez Composer. Ouvrez le fichier de la solution. Cliquez l’onglet Solution. Dans le volet Solution, double-cliquez sur le nœud (Code Javascript ou Styles personnalisés) pour ouvrir l’éditeur de code JavaScript ou CSS intégré. (Voir l’exemple sur la droite.) Vous pouvez également cliquer avec le bouton droit sur un nœud pour ouvrir le menu contextuel et modifier les références JavaScript/CSS. Les boîtes de dialogue Références permettent d’insérer des liens d’accès aux fichiers JavaScript ou CSS depuis une URL.

Accès aux valeurs des champs du formulaire

Pour accéder à un champ ou le modifier, utilisez $form.getValue et $form.setValue dans le formulaire.

Vous ne devez pas accéder aux éléments DOM directement pour manipuler les valeurs, fin de ne pas perturber la gestion des événements et la propagation des règles dans le programme de rendu de formulaire.

Utilisation de jQuery

Le programme de rendu de formulaire utilise jQuery qui peut être utilisé dans les règles.

Au lieu d’utiliser $ pour accéder à la fonctionnalité jQuery, utilisez l’alias $j ou le nom de fonction jQuery complet.