PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Paramètres de la fonction jQuery
  • Chargement de la librairie jQuery et de ses extensions
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
jQuery (Fonction)
En anglais : jQuery
Exécute une méthode Javascript (ou plusieurs méthodes chaînées) de la librairie jQuery sur un élément de la page.
Cette fonction est une fonctionnalité avancée : son utilisation nécessite une bonne connaissance du Javascript et de la librairie jQuery.
Exemple
// Utilisation d'une seule fonction jQuery
jQuery(LIB_1).fadeOut()
// Utilisation avec 2 fonctions chaînées
// L'opacité du champ est modifiée, puis il explose en morceaux avant de disparaître
jQuery(CELL_Carré).fadeTo("opacity",0.1).effect("explode")
Syntaxe

Exécution d'une commande de la librairie jQuery Masquer les détails

<Résultat> = jQuery(<Nom du champ WEBDEV>).<Fonction jQuery>(<Paramètre 1>, ..., <Paramètre N>)
<Résultat> : Type attendu
Valeur de retour de la méthode jQuery appelée.
<Nom du champ WEBDEV> : Chaîne de caractères (avec ou sans guillemets)
Nom du champ à manipuler dans la page.
Remarque : L'option "Le champ peut être superposé" doit être cochée pour le champ (onglet "IHM" de la fenêtre de description du champ).
<Fonction jQuery> : Chaîne de caractères (sans guillemets)
Nom de la fonction jQuery à exécuter.
Attention : Le Javascript étant sensible à la casse, le nom de la fonction doit respecter la casse utilisée dans la librairie jQuery.
<Paramètre 1> : Chaîne de caractères
Premier paramètre attendu par la fonction jQuery.
<Paramètre N> : Chaîne de caractères
Nième paramètre attendu par la fonction jQuery.

Exécution de plusieurs commandes de la librairie jQuery chaînées Masquer les détails

<Résultat> = jQuery(<Nom du champ WEBDEV>).<Fonction jQuery 1>(<Paramètre 1>, ..., <Paramètre N>).<Fonction jQuery 2>(<Paramètre 1>, ..., <Paramètre N>)
<Résultat> : Type attendu
Valeur de retour de la méthode jQuery appelée.
<Nom du champ WEBDEV> : Chaîne de caractères (avec ou sans guillemets)
Nom du champ à manipuler dans la page.
<Fonction jQuery 1> : Chaîne de caractères (sans guillemets)
Nom de la première fonction jQuery à exécuter. Attention : Le Javascript étant sensible à la casse, le nom de la fonction doit respecter la casse utilisée dans la librairie jQuery.
<Paramètre 1> : Chaîne de caractères
Premier paramètre attendu par la fonction jQuery.
<Paramètre N> : Chaîne de caractères
Nième paramètre attendu par la fonction jQuery.
<Fonction jQuery 2> :
Nom de la seconde fonction jQuery à exécuter. Attention : Le Javascript étant sensible à la casse, le nom de la fonction doit respecter la casse utilisée dans la librairie jQuery.
Remarques

Paramètres de la fonction jQuery

Si une procédure (également appelée "Callback") doit être passée à une des fonctions jQuery, la procédure navigateur doit être passée par référence (nom de la fonction précédée du signe "&"). Par exemple :
jQuery(BTN_Ajout).on("click", &OnAjout)

Chargement de la librairie jQuery et de ses extensions

Une librairie jQuery est livrée en standard avec WEBDEV mais vous pouvez en inclure une autre libraire en remplacement ou inclure des extensions (par exemple jQuery-UI).
Il est possible :
  • d'inclure le script local ou distant (méthode conseillée).
  • d'utiliser la balise "<script src = ...>.
Méthode 1 : Inclure le fichier script (local ou distant(URL)) (méthode conseillée)
  1. Affichez la fenêtre de description de la page (option "Description" du menu contextuel).
  2. Sélectionnez l'onglet "Avancé".
  3. Sélectionnez l'onglet "Ressources externes (Javascript/CSS)".
  4. Pour référencer :
    • un script distant, copiez/collez l'adresse (URL) du fichier script directement dans la colonne "Ressources Javascript".
    • un script local (fichier présent sur votre poste par exemple), utilisez le bouton "+" des "Ressources Javascript" et sélectionnez le fichier correspondant.
Attention : Vérifiez l'ordre des dépendances des scripts (la librairie jQuery puis ses extensions).
Méthode 2 : Ajouter le balisage d'insertion de scripts :
  1. Affichez la fenêtre de description de la page (option "Description" du menu contextuel).
  2. Sélectionnez l'onglet "Avancé".
  3. Sélectionnez l'onglet "HTML".
  4. Copiez les lignes de code correspondantes dans la zone "Code HTML ajouté à l'entête de page". Par exemple :
    <script src="http://code.jquery.com/jquery-1.9.1.js"></script>
    <script src="http://code.jquery.com/ui/1.10.3/jquery-ui.js"></script>
Attention :
  • Le code doit être inséré dans la zone "Code HTML ajouté à l'en-tête de la page" et non dans la zone "Code HTML ajouté en fin de page". Exception : Si vous souhaitez inclure une extension sans inclure une autre librairie jQuery, il est nécessaire de :
    • Utiliser la méthode utilisant le balisage.
    • Copier le code dans la zone "Code HTML ajouté en fin de page"
  • Cette méthode est déconseillée car le chargement du script interrompt le chargement de la page. La vitesse de chargement et l'affichage de la page sont ralentis.
Composante : WDJS.DLL
Version minimum requise
  • Version 19
Commentaires
Attention avec l'AJAX
L'ajout du code en Fin de page n'est pas compatible avec les ZR et Tables AJAX.
Albin
20 nov. 2017