Affichage d'aides

Les aides (hint) sont un élément crucial dans les exercices PLaTon, offrant un soutien supplémentaire aux apprenants. Ces aides peuvent être statiques, fournissant des conseils préétablis, ou dynamiques, s'adaptant en fonction des interactions de l'utilisateur.

Voici comment vous pouvez les intégrer dans vos exercices.

Aides Statiques

Les aides statiques sont des conseils ou des informations prédéfinies qui sont affichés lorsque l'utilisateur demande de l'aide.

• Structure : La clé hint peut contenir un tableau de chaînes de caractères, chaque chaîne représentant une aide distincte.

• Exemple :

  hint = [
    "Pensez à vérifier vos calculs.",
    "N'oubliez pas que l'ordre des opérations est important.",
    @copycontent chemin/vers/fichier.md
  ]

• Utilisation : Lorsque l'apprenant clique sur le bouton d'aide, les éléments du tableau hint sont affichés un par un, dans l'ordre.

Aides Dynamiques

Les aides dynamiques offrent un soutien plus personnalisé, basé sur les actions ou les réponses de l'utilisateur.

• Structure : La clé hint peut être configurée comme un objet contenant les propriétés next, data, et empty.

  • next : Script exécuté dans la sandbox pour vérifier s'il reste des aides à afficher.
  • data : Liste de conseils générés dynamiquement (au format Markdown ou HTML).
  • done : Booléen indiquant si le bouton d'aide doit être affiché (false) ou non (true).

• Mise en œuvre :

Dans l'exemple suivant, le script next vérifie si l'utilisateur a cliqué sur le bouton d'aide moins de 5 fois. Si c'est le cas, un nouveau conseil est ajouté à la liste data, et le bouton d'aide est affiché. Sinon, le bouton d'aide est masqué.

 
count = 0
 
hint.data = []
hint.done = false
hint.next == #!lang=js
 
count++
hint.done = count >= 5
if (count <= 5) {
  hint.data.push(`Vous avez cliqué **${count}** fois sur le bouton d'aide.`)
}
 
==

Conseils pour la Création d'Aides Efficaces

• Pertinence : Assurez-vous que les aides sont pertinentes pour la tâche et apportent une valeur ajoutée.
• Progressivité : Pour les aides statiques, organisez-les de manière à ce qu'elles deviennent progressivement plus informatives ou spécifiques.
• Interactivité : Pour les aides dynamiques, utilisez les interactions précédentes de l'utilisateur pour offrir des conseils ciblés.
• Clarté : Les aides doivent être clairement formulées pour éviter toute confusion supplémentaire.

L'utilisation efficace des aides dans vos exercices PLaTon peut grandement améliorer l'expérience d'apprentissage, en fournissant un soutien adapté et en encourageant l'autonomie des apprenants.