Fonctionnement technique de la vérification des affichages conditionnels des saisies

L’attribut data-afficher_si

Cet attribut se trouve dans le fichier saisies/_base.html, pour la plupart des saisies.

Pour les saisies « autonomes », qui n’utilisent pas ce fichier, il faut l’insérer dans le squelette, au niveau du conteneur de saisie, de la manière suivante :

[ data-afficher_si="(#ENV*{afficher_si}|saisies_afficher_si_js{#ENV{_saisies}})"]

La valeur de cet attribut un bout de code JavaScript qui effectue un test et retourne true ou false. Elle est calculée via la fonction saisies_afficher_si_js() qui reçoit le test afficher_si et la liste des saisies du formulaire courant.

La fonction saisies_afficher_si_js()

Cette fonction détermine la valeur de data-afficher_si en fonction du type des saisies conditionnantes.

Pour ce faire elle va charger la fonction saisies_afficher_si_js_<type_de_saisies>() dans le fichier saisies_afficher_si_js/<type_de_saisie.php. Si cette fonction n’est pas trouvable, elle se rabat sur saisies_afficher_si_js_defaut() dans le fichier saisies_afficher_si_js/defaut.php. En général, il n’est pas nécessaire de définir sa propre fonction, car la fonction par défaut suffit. Au 10 mars 2021, seul le plugin CVT-UPLOAD définit une fonction spécifique saisies_afficher_si_js_fichiers().

La fonction saisies_afficher_si_js_defaut(), utilisée donc dans 99% des cas, se contente de remplacer les tests simples par un appel à la fonction JS afficher_si, qui reçoit en argument un tableau décrivant les composantes du test simple.

Le code Javascript proprement dit

Le script javascript/saisies_afficher_si.js, chargé dans l’entête des pages web :

• est à l’affût des changements sur les saisies du formulaire (.change()) ;
• si un changement a lieu sur une saisie conditionnante, recherche les saisies conditionnées, en regardant les attributs data-afficher_si ;
• stocke la valeur courante de l’ensemble des champs dans un tableau afficher_si_current_data ;
• execute (via eval()) le test de data-afficher_si, qui dans la plupart des cas appelle la fonction afficher_si() ;
• en fonction du résultat, affiche ou masque la saisie conditionnante et modifie la classe entre afficher_si_visible et afficher_si_masque, règle également les attributs aria-hidden ;
• pour les saisies conditionnées définies comme obligatoires, bascule, si besoin, l’attribut required. En effet, si la saisie est masquée, il faut supprimer l’attribut, pour que les navigateurs ne disent pas qu’un champ masqué est obligatoire. Mais il faut le rétablir lorsque la saisie est reaffichée. Un drapeau data-afficher-si-required est utilisé pour conserver en mémoire l’information ;
• en outre, au chargement du formulaire, le script teste l’ensemble des data-afficher_si et masque le cas échéant les saisies, tout en ajoutant la classe afficher_si_masque_chargement.

Ainsi, lors d’un changement dans le formulaire, seules les saisies conditionnées par la saisie conditionnante modifiée sont testées. Un seul script est chargé pour l’ensemble des formulaires [1].

Pour tenir compte des constantes _SAISIES_AFFICHER_SI_JS_SHOW et _SAISIES_AFFICHER_SI_JS_HIDE, des fonctions sont définies dans l’entête de la page.

La fonction saisies_verifier_afficher_si()

La fonction saisies_verifier_afficher_si() prend la description des saisies d’un formulaire en premier paramètre. En second paramètre, elle peut recevoir un tableau comprenant les valeurs associés à chaque saisies (utilisée pour la balise #VOIR_SAISIES). À défaut, la fonction ira chercher les valeurs dans $_REQUEST.

Pour les saisies conditionnées dont la condition n’est pas remplie :

• Si le second paramètre n’est pas fourni, modifie $_REQUEST pour mettre la valeur de la saisie à '' (chaine vide).
• Dans tous les cas, ajoute la saisie masquée dans une liste interne. On peut ainsi retrouver toutes les saisies masquées en appelant la fonction saisies_afficher_si_liste_masquees().

La fonction retourne la liste des saisies qu’elle a reçu en entrée, à l’exception des saisies masquées.

À noter que l’on ne considère pas qu’une saisie est masquée :
-  si l’option globale afficher_si_avec_post du tableau de saisies est activée ;
-  si, pour une saisie donnée, l’option afficher_si_avec_post, est activée.

Comment sont évalués les tests côté PHP

saisies_verifier_afficher_si() appelle la fonction saisies_evaluer_afficher_si(), qui reçoit la condition de la saisie conditionnée, et les paramètres d’environnement.

Cette dernière fonction, appelle saisies_transformer_condition_afficher_si(), laquelle en s’appuyant sur la fonction saisies_parser_condition_afficher_si() transforme la condition afficher_si en une condition PHP évaluable (via eval).

saisies_transformer_condition_afficher_si() fait elle-même appelle à d’autres fonctions selon le type de saisie conditionnante à tester, selon les opérateurs, etc.