fcad-core-dragon 2.1.1 → 2.1.2

package/documentation/composants/app-comp-quiz-next.md

@@ -1,235 +1,235 @@
-# Quiz
-
-*Quiz* est le composant qui gère principalement toutes les actions principales de tous les types de quiz de l'application, sans être un gestionnaire.
-
-## Aperçu
-
-Le composant *quiz* importe et affiche les données. Selon les données entrer dans la feuille *json*, *quiz* se charge d'utiliser le bon type de quiz. Il gère aussi tout ce qui est validation pour tout type de quiz, si validation il y a. Il affiche la rétroaction en dessous du quiz.
-
-## Comportement
-
-*Quiz* doit absolument être lié avec un fichier *json* lors de son appelle. Si le fichier *json* comporte une erreur, le quiz ne fonctionnera pas. 
-
-Le *json* doit avoir les informations suivantes : 
-
-- id 
-- type
-- enonce
-- choix de réponse 
-- solution 
-- rétroaction
-- valeur de point
-- le nombre essais 
-
-  ```json
-    {
-      "id": "Axx_Pxx_Qxx",
-      "type_question": "",
-      "ennonce": "",
-      "choix_reponse": [],
-      "solution": "",
-      "rétroaction": {
-        "retro_neutre": {} ,
-        "retro_positive": {} ,
-        "retro_negative": {} 
-      },
-      "valeur_points": null,
-      "max_essai": null
-    }
-
-
-Peu importe le type de quiz développé, ce sont les informations nécessaires pour créer un quiz. 
-
-Le paramètre *ennonce* doit absolument recevoir une structure html.
-
-::: warning Attention
-  Prenez note que *valeur_points* n'est pas fonctionnel pour l'instant.
-:::
-
-## Paramètre 
-
-### Voici les paramètres généraux à tous les quiz
-
-#### ID
-
-**Type:** `String` _(Axx_Pxx_Qxx)_
-
-**Usage:** Obligatoire.  
-Définie l'identification unique pour le quiz/ la question. Cet *ID* est constitué de la référence de l'activité **Axx** , référence de la page **Pxx** et un numéro du Quiz **Qxx**.
-
-#### TYPE_QUESTION
-
-**Type:** `String` _(choix_mult | choix_unique | dropdown | reponse_ouverte | texte_tableau | texte_troue | texte_troue_select)__
-
-**Usage:** Obligatoire.  
-Définie le type de question.
-
-#### ENNONCE
-
-**Type:** `String`
-
-**Usage:** Obligatoire.  
-Définie l'énoncé textuel de la question.
-
-#### RETROACTION
-
-**Type:** `Object` retro_positive | retro_negative | retro_neutre
-
-**Usage:** Obligatoire.  
-Définie la rétroaction à afficher pour la question. Doit /referencesléter une des situations ci-dessous:
-
-- Une rétraction particulière est attendue selon le type de réponse de l'utilisateur. Les clés `retro_positive , retro_negative , retro_neutre` doivent être remplies.
-
-- Aucune rétroaction particulière n'est demandée. Les clés `retro_positive` , `retro_negative` peuvent contenir un string vide ou être mise `Null` et la clé `retro_neutre` doit être remplie pour la rétroaction générale à afficher.
-
-#### VALEUR_POINTS
-
-**Type:** `Number | Null`
-
-**Usage:** Optionnel.  
-Définie la valeur de la question en termes de points. Doit être mit à `null` si aucune valeur n’est nécessaire pour le quiz.
-
-#### MAX_ESSAI
-
-**Type:** `Number | Null`
-
-**Usage:** Optionnel.  
-Définie le nombre d'essai permit pour ce quiz. Doit être mis à `null` si aucun aucune condition d'essai maximum n'est nécessaire pour le quiz.
-
-### Voici les paramètres spécifique pour les inputs et les types de solutions
-
-### Quiz réponse ouverte
-
-[Exemple d'un objet quizData de réponse ouverte](../ref/quizDataReponseOuverte.json)
-
-#### CHOIX_REPONSE
-
-**Type:** `Null`
-
-**Usage:** Obligatoire.  
-Doit être mis à `null` si la question ne présente pas un choix de réponse.
-
-#### SOLUTION
-
-**Type:** `String | Null`
-
-**Usage:** Obligatoire.  
-Définie la solution pour la question.
-
-### Quiz réponse radio et réponse checkbox
-
-[Exemple d'un objet quizData de réponse radio](../ref/quizDataChoixUnique.json)
-
-[Exemple d'un objet quizData de réponse checkbox](../ref/quizDataChoixMult.json)
-
-
-#### CHOIX_REPONSE
-
-**Type:** `Array{Object} | Null`
-
-**Usage:** Obligatoire.  
-Définie l'ensemble des choix proposés pour la réponse. Doit être mis à `null` si la question ne présente pas un choix de réponse.
-Le type d'objet contenu de l'array change selon le type de quiz:
-- Le type `reponse_simple` pour les quiz `choix_unique` || `choix_mult`
-
-#### SOLUTION
-
-**Type:** `Number | Array | Null`
-
-**Usage:** Obligatoire.  
-Définie la solution pour la question. Doit contenir une des valeurs ci-dessous:
-
-- un Array ( *IDs* des solutions, dans le cas de la question type choix_mult)
-- Null dans le cas où aucune solution n'est attendu/exigé (reponse_ouverte sans validation)
-
-### Quiz réponse liste déroulante
-
-[Exemple d'un objet quizData de réponse liste déroulante](../ref/quizDataDropdown.json)
-
-#### CHOIX_REPONSE
-
-**Type:** `Array{Object} | Null`
-
-**Usage:** Obligatoire.  
-Définie l'ensemble des choix proposés pour chaque réponse.
-
-#### SOLUTION
-
-**Type:** `Array | Null`
-
-**Usage:** Obligatoire.  
-Définie la solution pour la question.
-
-### Quiz texte tableau
-
-[Exemple d'un objet quizData de texte tableau](../ref/quizDataTextTableau.json)
-
-#### CHOIX_REPONSE
-
-**Type:** `Array{Object}`
-
-**Usage:** Obligatoire.  
-Définie l'ensemble des rangés du tableau avec chaque rangé ayant une réponse.
-
-#### SOLUTION
-
-**Type:** `Array{Object} | Null`
-
-**Usage:** Obligatoire.  
-Définie la solution pour la question.
-
-### Quiz texte trou
-
-[Exemple d'un objet quizData de texte trou](../ref/quizDataTexteTroue.json)
-
-#### TEXTE_BASE
-
-**Type:** `String`
-
-**Usage:** Obligatoire.  
-Définie le texte où les entrées de champs textes seront insérées. L'emplacement des entrés est indiqué dans le texte avec `$%KEY%$`.
-
-#### SOLUTION
-
-**Type:** `Array{Object} | Null`
-
-**Usage:** Obligatoire.  
-Définie la solution pour la question.
-
-
-### Quiz texte trou à liste déroulante
-
-[Exemple d'un objet quizData de texte trou à liste déroulante](../ref/quizDataTextTrouSelect.json)
-
-#### CHOIX_REPONSE
-
-**Type:** `Array{Object}`
-
-**Usage:** Obligatoire.  
-Définie l'ensemble des choix proposés pour chaque réponse.
-
-#### TEXTE_BASE
-
-**Type:** `String`
-
-**Usage:** Obligatoire.  
-Définie le texte où les entrées de champs textes seront insérées. L'emplacement des entrés est indiqué dans le texte avec `$%KEY%$`.
-
-#### SOLUTION
-
-**Type:** `Array{Object} | Null`
-
-**Usage:** Obligatoire.  
-Définie la solution pour la question.
-
-
-
-## Style
-
-Lorsque vous sélectionnez une réponse, la classe *select* est ajoutée à l'élément sélectionné. Lors de la validation des éléments, toutes les bonnes réponses ont la classe *good* et toute les mauvaises réponses on la classes *bad*. Un jeu de classes est utilisé dans la feuille sass de chaque type de input pour identifier les bonnes réponses, les mauvaises réponses, les mauvaises réponse sélectionnées et les bonnes réponses sélectionnées.
-
-Aucune classe supplémentaire ne peut être ajoutée au élément du quiz. Vous ne pouvez jouer qu'avec le conteneur parent du quiz pour ajouter des classes ou *id*. Par défaut, le quiz et ses éléments ont l'*id* que vous définissez dans la feuille *json*. 
-
-## Accessibilité
-
-Pour l'instant aucune action n'a été fait pour l'accessibilité.
+# Quiz
+
+*Quiz* est le composant qui gère principalement toutes les actions principales de tous les types de quiz de l'application, sans être un gestionnaire.
+
+## Aperçu
+
+Le composant *quiz* importe et affiche les données. Selon les données entrer dans la feuille *json*, *quiz* se charge d'utiliser le bon type de quiz. Il gère aussi tout ce qui est validation pour tout type de quiz, si validation il y a. Il affiche la rétroaction en dessous du quiz.
+
+## Comportement
+
+*Quiz* doit absolument être lié avec un fichier *json* lors de son appelle. Si le fichier *json* comporte une erreur, le quiz ne fonctionnera pas. 
+
+Le *json* doit avoir les informations suivantes : 
+
+- id 
+- type
+- enonce
+- choix de réponse 
+- solution 
+- rétroaction
+- valeur de point
+- le nombre essais 
+
+  ```json
+    {
+      "id": "Axx_Pxx_Qxx",
+      "type_question": "",
+      "ennonce": "",
+      "choix_reponse": [],
+      "solution": "",
+      "rétroaction": {
+        "retro_neutre": {} ,
+        "retro_positive": {} ,
+        "retro_negative": {} 
+      },
+      "valeur_points": null,
+      "max_essai": null
+    }
+
+
+Peu importe le type de quiz développé, ce sont les informations nécessaires pour créer un quiz. 
+
+Le paramètre *ennonce* doit absolument recevoir une structure html.
+
+::: warning Attention
+  Prenez note que *valeur_points* n'est pas fonctionnel pour l'instant.
+:::
+
+## Paramètre 
+
+### Voici les paramètres généraux à tous les quiz
+
+#### ID
+
+**Type:** `String` _(Axx_Pxx_Qxx)_
+
+**Usage:** Obligatoire.  
+Définie l'identification unique pour le quiz/ la question. Cet *ID* est constitué de la référence de l'activité **Axx** , référence de la page **Pxx** et un numéro du Quiz **Qxx**.
+
+#### TYPE_QUESTION
+
+**Type:** `String` _(choix_mult | choix_unique | dropdown | reponse_ouverte | texte_tableau | texte_troue | texte_troue_select)__
+
+**Usage:** Obligatoire.  
+Définie le type de question.
+
+#### ENNONCE
+
+**Type:** `String`
+
+**Usage:** Obligatoire.  
+Définie l'énoncé textuel de la question.
+
+#### RETROACTION
+
+**Type:** `Object` retro_positive | retro_negative | retro_neutre
+
+**Usage:** Obligatoire.  
+Définie la rétroaction à afficher pour la question. Doit /referencesléter une des situations ci-dessous:
+
+- Une rétraction particulière est attendue selon le type de réponse de l'utilisateur. Les clés `retro_positive , retro_negative , retro_neutre` doivent être remplies.
+
+- Aucune rétroaction particulière n'est demandée. Les clés `retro_positive` , `retro_negative` peuvent contenir un string vide ou être mise `Null` et la clé `retro_neutre` doit être remplie pour la rétroaction générale à afficher.
+
+#### VALEUR_POINTS
+
+**Type:** `Number | Null`
+
+**Usage:** Optionnel.  
+Définie la valeur de la question en termes de points. Doit être mit à `null` si aucune valeur n’est nécessaire pour le quiz.
+
+#### MAX_ESSAI
+
+**Type:** `Number | Null`
+
+**Usage:** Optionnel.  
+Définie le nombre d'essai permit pour ce quiz. Doit être mis à `null` si aucun aucune condition d'essai maximum n'est nécessaire pour le quiz.
+
+### Voici les paramètres spécifique pour les inputs et les types de solutions
+
+### Quiz réponse ouverte
+
+[Exemple d'un objet quizData de réponse ouverte](../ref/quizDataReponseOuverte.json)
+
+#### CHOIX_REPONSE
+
+**Type:** `Null`
+
+**Usage:** Obligatoire.  
+Doit être mis à `null` si la question ne présente pas un choix de réponse.
+
+#### SOLUTION
+
+**Type:** `String | Null`
+
+**Usage:** Obligatoire.  
+Définie la solution pour la question.
+
+### Quiz réponse radio et réponse checkbox
+
+[Exemple d'un objet quizData de réponse radio](../ref/quizDataChoixUnique.json)
+
+[Exemple d'un objet quizData de réponse checkbox](../ref/quizDataChoixMult.json)
+
+
+#### CHOIX_REPONSE
+
+**Type:** `Array{Object} | Null`
+
+**Usage:** Obligatoire.  
+Définie l'ensemble des choix proposés pour la réponse. Doit être mis à `null` si la question ne présente pas un choix de réponse.
+Le type d'objet contenu de l'array change selon le type de quiz:
+- Le type `reponse_simple` pour les quiz `choix_unique` || `choix_mult`
+
+#### SOLUTION
+
+**Type:** `Number | Array | Null`
+
+**Usage:** Obligatoire.  
+Définie la solution pour la question. Doit contenir une des valeurs ci-dessous:
+
+- un Array ( *IDs* des solutions, dans le cas de la question type choix_mult)
+- Null dans le cas où aucune solution n'est attendu/exigé (reponse_ouverte sans validation)
+
+### Quiz réponse liste déroulante
+
+[Exemple d'un objet quizData de réponse liste déroulante](../ref/quizDataDropdown.json)
+
+#### CHOIX_REPONSE
+
+**Type:** `Array{Object} | Null`
+
+**Usage:** Obligatoire.  
+Définie l'ensemble des choix proposés pour chaque réponse.
+
+#### SOLUTION
+
+**Type:** `Array | Null`
+
+**Usage:** Obligatoire.  
+Définie la solution pour la question.
+
+### Quiz texte tableau
+
+[Exemple d'un objet quizData de texte tableau](../ref/quizDataTextTableau.json)
+
+#### CHOIX_REPONSE
+
+**Type:** `Array{Object}`
+
+**Usage:** Obligatoire.  
+Définie l'ensemble des rangés du tableau avec chaque rangé ayant une réponse.
+
+#### SOLUTION
+
+**Type:** `Array{Object} | Null`
+
+**Usage:** Obligatoire.  
+Définie la solution pour la question.
+
+### Quiz texte trou
+
+[Exemple d'un objet quizData de texte trou](../ref/quizDataTexteTroue.json)
+
+#### TEXTE_BASE
+
+**Type:** `String`
+
+**Usage:** Obligatoire.  
+Définie le texte où les entrées de champs textes seront insérées. L'emplacement des entrés est indiqué dans le texte avec `$%KEY%$`.
+
+#### SOLUTION
+
+**Type:** `Array{Object} | Null`
+
+**Usage:** Obligatoire.  
+Définie la solution pour la question.
+
+
+### Quiz texte trou à liste déroulante
+
+[Exemple d'un objet quizData de texte trou à liste déroulante](../ref/quizDataTextTrouSelect.json)
+
+#### CHOIX_REPONSE
+
+**Type:** `Array{Object}`
+
+**Usage:** Obligatoire.  
+Définie l'ensemble des choix proposés pour chaque réponse.
+
+#### TEXTE_BASE
+
+**Type:** `String`
+
+**Usage:** Obligatoire.  
+Définie le texte où les entrées de champs textes seront insérées. L'emplacement des entrés est indiqué dans le texte avec `$%KEY%$`.
+
+#### SOLUTION
+
+**Type:** `Array{Object} | Null`
+
+**Usage:** Obligatoire.  
+Définie la solution pour la question.
+
+
+
+## Style
+
+Lorsque vous sélectionnez une réponse, la classe *select* est ajoutée à l'élément sélectionné. Lors de la validation des éléments, toutes les bonnes réponses ont la classe *good* et toute les mauvaises réponses on la classes *bad*. Un jeu de classes est utilisé dans la feuille sass de chaque type de input pour identifier les bonnes réponses, les mauvaises réponses, les mauvaises réponse sélectionnées et les bonnes réponses sélectionnées.
+
+Aucune classe supplémentaire ne peut être ajoutée au élément du quiz. Vous ne pouvez jouer qu'avec le conteneur parent du quiz pour ajouter des classes ou *id*. Par défaut, le quiz et ses éléments ont l'*id* que vous définissez dans la feuille *json*. 
+
+## Accessibilité
+
+Pour l'instant aucune action n'a été fait pour l'accessibilité.

package/documentation/composants/app-comp-quiz-recall.md

@@ -1,53 +1,53 @@
----
-title: Model de page
-
----
-::: warning  🚩 Important
-  Utilisez ce model comme depart pour écrire la page de votre composant:
-
-  1) Copiez /dubliquez cette page
-  2) Renommez votre copie avec le nom de votre composant
-  3) Édtitez la page en rempliçant les sections qui conserne votre composant.  
-:::
-
-
-Composant pour ....  
-
-## Aperçu
-
-Le composant permet de...
-Et culpa explicabo est amet voluptas qui fuga deleniti. Sed consectetur minus aut animi modi sed natus pariatur.
-
-## Comportement
-
-Lorem ipsum dolor sit amet. At quas quis qui velit tenetur aut suscipit error id iure doloremque ad velit explicabo. Sit repellat praesentium aut perferendis illum qui omnis recusandae est explicabo dolores in quia tempore qui totam velit.
-
-## Référence du composant
-
-**ModelComposantPage** `<model-composant/>` 
-
-
-## Paramètre 
-
-Aucun paramètre n'est nécessaire pour ce composant.
-
-### Props
-
-| Propriété | Type  | Description   | valeur par défaut | 
-|:----------|:-----------------|:-----------------------------------------------------------------------------------------------------------------------------------|:-------|
-| page | Object | données brutes de la page à créer | Doit contenir au minimum les valeurs suivantes: `{id, type, activityRef }`. Référez-vous à la section sur la [création de page](/guide/pageType.html#qu-est-ce-qu-une-page) pour une liste exhaustive des valeurs de la propriété. |
-
-### Slots
-`content`[named-slot] - Eos nemo officiis a ducimus officiis aut delectus obcaecati qui dolor consequatur.
-
-
-## Style
-
-`nomde class`[class]
-
-Aucune manipulation requise.
-
-
-## Accessibilité
-Aucune manipulation requise.
-
+---
+title: Model de page
+
+---
+::: warning  🚩 Important
+  Utilisez ce model comme depart pour écrire la page de votre composant:
+
+  1) Copiez /dubliquez cette page
+  2) Renommez votre copie avec le nom de votre composant
+  3) Édtitez la page en rempliçant les sections qui conserne votre composant.  
+:::
+
+
+Composant pour ....  
+
+## Aperçu
+
+Le composant permet de...
+Et culpa explicabo est amet voluptas qui fuga deleniti. Sed consectetur minus aut animi modi sed natus pariatur.
+
+## Comportement
+
+Lorem ipsum dolor sit amet. At quas quis qui velit tenetur aut suscipit error id iure doloremque ad velit explicabo. Sit repellat praesentium aut perferendis illum qui omnis recusandae est explicabo dolores in quia tempore qui totam velit.
+
+## Référence du composant
+
+**ModelComposantPage** `<model-composant/>` 
+
+
+## Paramètre 
+
+Aucun paramètre n'est nécessaire pour ce composant.
+
+### Props
+
+| Propriété | Type  | Description   | valeur par défaut | 
+|:----------|:-----------------|:-----------------------------------------------------------------------------------------------------------------------------------|:-------|
+| page | Object | données brutes de la page à créer | Doit contenir au minimum les valeurs suivantes: `{id, type, activityRef }`. Référez-vous à la section sur la [création de page](/guide/pageType.html#qu-est-ce-qu-une-page) pour une liste exhaustive des valeurs de la propriété. |
+
+### Slots
+`content`[named-slot] - Eos nemo officiis a ducimus officiis aut delectus obcaecati qui dolor consequatur.
+
+
+## Style
+
+`nomde class`[class]
+
+Aucune manipulation requise.
+
+
+## Accessibilité
+Aucune manipulation requise.
+