Fields-Form - Historique des versions

Léo le 12 octobre 2022 à 10:23

2022-10-12T10:23:26Z

Damien : /* Default */

2022-05-04T18:42:48Z

Default

Damien : /* Default */

2022-05-04T13:29:13Z

Default

Léo le 3 mai 2022 à 14:05

2022-05-03T14:05:09Z

Léo le 21 janvier 2022 à 12:13

2022-01-21T12:13:19Z

Léo le 21 janvier 2022 à 12:11

2022-01-21T12:11:25Z

Damien : /* Blockclasses */

2021-07-19T23:44:38Z

Blockclasses

Léo le 10 juin 2021 à 09:17

2021-06-10T09:17:01Z

Léo le 10 juin 2021 à 09:16

2021-06-10T09:16:37Z

Damien : /* Options */

2021-04-01T00:35:25Z

Options

@@ Ligne 259 : / Ligne 259 : @@
 :: — La syntaxe dynamique s'utilise avec l'option nommée ''''default-expr'''' qui attend une [[SmartExpressions|SmartExpression]] permettant de fournir la valeur par défaut du champ.
-:: Exemple : <code>default-var: VAR + 12</code>.
+:: Exemple : <code>default-expr: VAR + 12</code>.
 :: La SmartExpression peut être composée de diverses variables (dynamiques ou pas), et peut aussi utiliser la variable d'un contexte répétée si le champ en question se trouve dans une section répétée.
-:: Par exemple: <code>default-exp: get_value(LIST_JOUET_PREFÉRÉ, ENFANTS._KEY)</code>.
+:: Par exemple: <code>default-expr: get_value(LIST_JOUET_PREFÉRÉ, ENFANTS._KEY)</code>.
 :: Si le champ est "vide", il sera donc automatiquement pré-rempli avec la valeur de la variable fournie. Attention, il faut être cohérent avec les types de champ : par exemple, sur un champ ''number-input'', il ne faut pas utiliser une SmartExpression qui renverrait une valeur de type chaîne ou une liste car ce sont des formats impossibles à affciher dans un champ numérique.  Si ce cas à lieu, le champ restera vide, sans valeur par défaut.

@@ Ligne 258 : / Ligne 258 : @@
 :: Si le champ est "vide", il sera donc automatiquement pré-rempli avec la valeur fournie dans cette option. Attention, il faut être cohérent avec les types de champs : par exemple,  dans un champ number-input, il ne sera pas possible de mettre par défaut une valeur textuelle (ex: "coucou").
-:: — La syntaxe dynamique s'utilise avec l'option nommée ''''default-var'''' qui attend le nom d'une variable (ou d'une variable dynamique). Exemple : <code>default-var: VAR</code>.
+:: — La syntaxe dynamique s'utilise avec l'option nommée ''''default-expr'''' qui attend une [[SmartExpressions|SmartExpression]] permettant de fournir la valeur par défaut du champ.
-:: Si le champ est "vide", il sera donc automatiquement pré-rempli avec la valeur de la variable fournie. Attention, il faut être cohérent avec les types de champs : par exemple, sur un champ number-input, il ne sera pas possible d'indiquer une variable de type date ou string. Soyez aussi vigilant avec l'usage sur des variables dynamiques qui peuvent renvoyer des valeurs de types mixtes.
+:: Exemple : <code>default-var: VAR + 12</code>.
 === Mask (masque de saisie) ===

@@ Ligne 247 : / Ligne 247 : @@
 ==== Principes de fonctionnement ====
-L'option "default" fonctionne sur les champs de type de saisie (text-input, number-input …). Elle permet de spécifier une valeur à insérer automatiquement dans le champ, au chargement de la page, dés lors que le champ est "vide". La valeur par défaut ne doit pas être confondue avec le "placeholder" (qui sert juste à afficher un texte informatif au sein du champ quand il est vide). Avec cette valeur par défaut, et si elle n'est pas modifiée par l'utilisateur lors de la saisie de la Slide, alors elle sera enregistrée telle-quelle dans le Dataset dés lors que l'utilisateur validera la Slide. À partir du moment où est elle enregistrée, le champ n'est plus "vide" et la valeur affichée est sa valeur réelle et non plus la valeur ''injectée'' par défaut.
+L'option "default" s'applique sur les champs de formulaire (text-input, number-input …). Elle permet de spécifier une valeur à insérer automatiquement dans le champ, au chargement de la page, dés lors que le champ est "vide".
 '''Attention''' : un champ avec une valeur par défaut continue d'être vide/incomplet du point de vue de la base de données ([[Dataset]]). Cela peut être trompeur, par exemple,  slide qui ne contient que des champs pré-remplis pourra sembler complète alors qu’elle ne l’ai pas du point de vue du Dataset et l'utilisateur peut avoir du mal à comprendre "pourquoi" on lui dit que le formulaire n'est pas complet. De même, le formulaire doit éviter de faire soudainement apparaitre un champ pré-rempli avec une valeur par défaut car si tel est le cas, il peut être difficile pour l’utilisateur de retrouver quel est le champ “vide” (= pourcentage de complétion VS ce que l’on voit sur la slide). Ou encore, notez que les visibleIf au sein de la slide doivent tenir compte du fait que s’ils parlent d’une variable “pré-remplie par défaut” sa valeur est considérée comme “vide” dans les SmartExpression tant qu’elle n’est pas sauvegardée ;
 === Mask (masque de saisie) ===

← Version précédente		Version du 3 mai 2022 à 14:05
Ligne 250 :		Ligne 250 :

	'''Attention''' : un champ avec une valeur par défaut continue d'être vide/incomplet du point de vue de la base de données ([[Dataset]]). Cela peut être trompeur, par exemple, slide qui ne contient que des champs pré-remplis pourra sembler complète alors qu’elle ne l’ai pas du point de vue du Dataset et l'utilisateur peut avoir du mal à comprendre "pourquoi" on lui dit que le formulaire n'est pas complet. De même, le formulaire doit éviter de faire soudainement apparaitre un champ pré-rempli avec une valeur par défaut car si tel est le cas, il peut être difficile pour l’utilisateur de retrouver quel est le champ “vide” (= pourcentage de complétion VS ce que l’on voit sur la slide). Ou encore, notez que les visibleIf au sein de la slide doivent tenir compte du fait que s’ils parlent d’une variable “pré-remplie par défaut” sa valeur est considérée comme “vide” dans les SmartExpression tant qu’elle n’est pas sauvegardée ;		'''Attention''' : un champ avec une valeur par défaut continue d'être vide/incomplet du point de vue de la base de données ([[Dataset]]). Cela peut être trompeur, par exemple, slide qui ne contient que des champs pré-remplis pourra sembler complète alors qu’elle ne l’ai pas du point de vue du Dataset et l'utilisateur peut avoir du mal à comprendre "pourquoi" on lui dit que le formulaire n'est pas complet. De même, le formulaire doit éviter de faire soudainement apparaitre un champ pré-rempli avec une valeur par défaut car si tel est le cas, il peut être difficile pour l’utilisateur de retrouver quel est le champ “vide” (= pourcentage de complétion VS ce que l’on voit sur la slide). Ou encore, notez que les visibleIf au sein de la slide doivent tenir compte du fait que s’ils parlent d’une variable “pré-remplie par défaut” sa valeur est considérée comme “vide” dans les SmartExpression tant qu’elle n’est pas sauvegardée ;
−
−	~~==== Utilisation ====~~
−
−	~~===== Principe =====~~
−
−	~~<code>{NOM_DE_VARIABLE:default(texte par défaut)}</code>~~
−
−	~~===== Exemple =====~~
−
−	~~<code>{PRENOM_ACHETEUR:default([Prénom de l'acheteur])}</code>~~

	=== Mask (masque de saisie) ===		=== Mask (masque de saisie) ===

@@ Ligne 255 : / Ligne 255 : @@
 ===== Principe =====
-<code>{NOM_DE_VARIABLE:default(texte par défaut)</code>
+<code>{NOM_DE_VARIABLE:default(texte par défaut)}</code>
 ===== Exemple =====
-<code>{PRENOM_ACHETEUR:default([Prénom de l'acheteur])</code>
+<code>{PRENOM_ACHETEUR:default([Prénom de l'acheteur])}</code>
 === Mask (masque de saisie) ===

← Version précédente		Version du 19 juillet 2021 à 23:44
Ligne 203 :		Ligne 203 :

	::* '''right-justified-labels''' : permet de justifié le libellée du champ à droite au lieu de la justification par défaut à gauche ;		::* '''right-justified-labels''' : permet de justifié le libellée du champ à droite au lieu de la justification par défaut à gauche ;
		+
		+	::* '''no-labels''' : permet de masquer le label et le possible sub-label ;
		+
		+	::* '''top-separator''' : permet de rajouter une ligne grise (séparateur) au dessus du champ marqué avec cette classe ;
		+
		+	::* '''bottom-separator''' : semblable à <code>top-separator</code>, cette classe permet de rajouter une ligne grise (séparateur) au dessous du champ marqué avec cette classe ;
		+
		+	::* '''grey-label''' : permet de forcer la couleur "grise" sur le label du champ, lui donnant une importance secondaire ;

	=== Fieldclasses ===		=== Fieldclasses ===

@@ Ligne 107 : / Ligne 107 : @@
 <p>'''Si on souhaite baser un [[Visible If]] à partir d'une variable Multiple-choices, la syntaxe à utiliser est le [[Conditions#Le_cas_sp.C3.A9cifique_des_questions_multi-choix|contains]]'''
 <h2 id="required">Required</h2>
-<p>3 valeurs sont autorisés pour ce champ : </p>
+<p>3 valeurs sont autorisées pour ce champ : </p>
 <p><strong>optional :</strong> l’utilisateur peut ne pas répondre à la question, sans aucune conséquence</p>
 <p><strong>necessary :</strong> l’utilisateur peut ne pas répondre à la question, mais cette absence de réponse est prise en compte pour déterminer la complétion du questionnaire.</p>

@@ Ligne 111 : / Ligne 111 : @@
 <p><strong>necessary :</strong> l’utilisateur peut ne pas répondre à la question, mais cette absence de réponse est prise en compte pour déterminer la complétion du questionnaire.</p>
 <p><strong>mandatory :</strong> l’utilisateur est obligé de répondre à la question pour pouvoir passer à la suite du formulaire</p></p>
 <h2 id="label">Label</h2>
 <p>Le “libellé” : c’est l’intitulé de la question qui sera posée à l’utilisateur.</p>

← Version précédente		Version du 1 avril 2021 à 00:35
Ligne 234 :		Ligne 234 :

	🔗 '''Les détails de cette configuration sont accessible sur la page dédiée : <span style="text-decoration: underline;">[[SmartForm - Injection depuis une API]]</span>.'''		🔗 '''Les détails de cette configuration sont accessible sur la page dédiée : <span style="text-decoration: underline;">[[SmartForm - Injection depuis une API]]</span>.'''
		+
		+
		+	=== Default ===
		+
		+	L'option "default" fonctionne sur les champs de type de saisie (text-input, number-input …). Elle permet de spécifier une valeur à insérer automatiquement dans le champ, au chargement de la page, dés lors que le champ est "vide". La valeur par défaut ne doit pas être confondue avec le "placeholder" (qui sert juste à afficher un texte informatif au sein du champ quand il est vide). Avec cette valeur par défaut, et si elle n'est pas modifiée par l'utilisateur lors de la saisie de la Slide, alors elle sera enregistrée telle-quelle dans le Dataset dés lors que l'utilisateur validera la Slide. À partir du moment où est elle enregistrée, le champ n'est plus "vide" et la valeur affichée est sa valeur réelle et non plus la valeur ''injectée'' par défaut.
		+
		+	'''Attention''' : un champ avec une valeur par défaut continue d'être vide/incomplet du point de vue de la base de données ([[Dataset]]). Cela peut être trompeur, par exemple, slide qui ne contient que des champs pré-remplis pourra sembler complète alors qu’elle ne l’ai pas du point de vue du Dataset et l'utilisateur peut avoir du mal à comprendre "pourquoi" on lui dit que le formulaire n'est pas complet. De même, le formulaire doit éviter de faire soudainement apparaitre un champ pré-rempli avec une valeur par défaut car si tel est le cas, il peut être difficile pour l’utilisateur de retrouver quel est le champ “vide” (= pourcentage de complétion VS ce que l’on voit sur la slide). Ou encore, notez que les visibleIf au sein de la slide doivent tenir compte du fait que s’ils parlent d’une variable “pré-remplie par défaut” sa valeur est considérée comme “vide” dans les SmartExpression tant qu’elle n’est pas sauvegardée ;
		+

	=== Mask (masque de saisie) ===		=== Mask (masque de saisie) ===