Token Test (révisé)

Version : v1 (actuelle)

Vue d'ensemble

Le Token Test (révisé) évalue la compréhension verbale en demandant aux participants de suivre des instructions en plusieurs étapes pour manipuler des jetons colorés. Chaque jeton est une forme colorée simple (cercle, carré, triangle ou rectangle).

Les participants glissent les jetons depuis une palette vers des emplacements cibles sur un canevas interactif. La tâche enregistré l'ordre de sélection, le timing et l'exactitude de chaque réponse.

Cette implémentation utilise le canevas HTML (HTML Canvas) pour un glissement fluide et libre avec rétroaction visuelle.

Contexte scientifique

• Origine : De Renzi & Vignolo (1962) - A sensitive test to detect receptive disturbances in aphasics
• Cas d'utilisation : Évaluation de l'aphasie, recherche sur la compréhension du langage, évaluation du traitement auditif
• Format standard : Commandes de complexité croissante (par ex., « Touchez le cercle rouge », « Touchez le grand carré bleu, puis le petit rectangle jaune »)

Ajouter à une étude

1. Ouvrez votre étude et allez dans l'onglet Conception
2. Sous Tâches comportementales, trouvez « Token Test (révisé) » et cliquez sur Ajouter
3. Cliquez sur Configurer sur la nouvelle carte de tâche pour personnaliser les paramètres

Configuration

Instructions

• Instructions pré-tâche : Affichées avant le début de la tâche. Expliquez la règle (par ex., « Vous verrez des formes colorées. Suivez les instructions pour les glisser dans les emplacements corrects. »)
• Instructions d'aide : Court rappel affiché pendant la tâche (optionnel)

Disposition et apparence

Paramètre	Défaut	Description
Grid rows	2	Nombre de lignes dans la grille de jetons (1-10)
Grid columns	5	Nombre de colonnes dans la grille de jetons (1-10)
Large token size	80 px	Taille des grands jetons en pixels (20-200)
Small token size	50 px	Taille des petits jetons en pixels (10-150)
Background color	#FFFFFF	Couleur d'arrière-plan du canevas
Grid line color	#EEEEEE	Couleur des lignes de la grille (guide visuel)
Selection color	#FFD700	Couleur de surbrillance pour les jetons sélectionnés (doré)
Text color	#000000	Couleur du texte des instructions

Rétroaction et timing

• Afficher la rétroaction : Indication brève après chaque réponse (activé par défaut)
• Délai de réponse : Limite de temps optionnelle (en millisecondes) avant la soumission automatique

Configuration des essais (tableur)

Les essais sont configurés à l'aide d'un éditeur de tableur avec les colonnes suivantes :

• Instruction : Texte affiché au participant (par ex., « Touchez le cercle rouge »)
• Type : Mode d'interaction - select (cliquer pour sélectionner) ou move (glisser les jetons)
• Target Shape : Forme de jeton attendue (circle, square, triangle, rectangle)
• Target Color : Couleur de jeton attendue (code hexadécimal, par ex., #e11d48)
• Target Size : Taille de jeton attendue (large ou small) - optionnel
• On Top Shape : Pour les essais de déplacement - forme du jeton sur lequel placer - optionnel
• On Top Color : Pour les essais de déplacement - couleur du jeton sur lequel placer - optionnel
• On Top Size : Pour les essais de déplacement - taille du jeton sur lequel placer - optionnel
• Fixation (ms) : Délai avant le début de l'interaction (par ex., 300)
• Block : Étiquette pour regrouper les essais (par ex., A, B, C) - optionnel
• Reset Positions : Réinitialiser les jetons à leur position dans la grille avant cet essai (true/false, défaut : true)
• Token Size Large (px) : Taille des grands jetons pour cet essai - optionnel (vide = utiliser le paramètre général)
• Token Size Small (px) : Taille des petits jetons pour cet essai - optionnel (vide = utiliser le paramètre général)
• Response Timeout (ms) : Délai de réponse pour cet essai - optionnel (vide = utiliser le paramètre général)

Comprendre la réinitialisation des positions

L'option reset_positions contrôle si les jetons retournent à leur position d'origine dans la grille avant chaque essai :

• true (défaut) : Les jetons se réinitialisent à la disposition en grille - utile pour des essais indépendants
• false : Les jetons restent là où ils ont été laissés - utile pour des tâches séquentielles où la position compte

Exemple de cas d'utilisation : Dans un essai de déplacement, vous pourriez définir reset_positions à false pour un essai suivant qui demande « Maintenant, touchez le cercle rouge » afin de tester si le participant se souvient de l'endroit où il l'a placé.

Exemple de configuration du tableur

Instruction	Type	Target Shape	Target Color	Target Size	...	Fixation (ms)	Block	Reset Positions
Touch the red circle.	select	circle	#e11d48			300	A	true
Touch the small green square.	select	square	#10b981	small		300	A	true
Put the red circle on the green square.	move	circle	#e11d48			300	B	false
Now touch the red circle.	select	circle	#e11d48			300	B	false

Formes disponibles

• circle : Jeton rond
• square : Jeton carré
• triangle : Triangle pointant vers le haut
• rectangle : Rectangle horizontal

Couleurs recommandées

• Rouge : #e11d48
• Vert : #10b981
• Bleu : #3b82f6
• Jaune : #f59e0b

Vous pouvez utiliser n'importe quel code couleur hexadécimal.

Expérience du participant

Ce que les participants voient

1. Bannière d'instruction : Commande affichée au-dessus du canevas (par ex., « Glissez le cercle rouge vers l'emplacement 1 »)
2. Zone palette : Jetons affichés dans une grille en haut
3. Emplacements cibles : Cases en pointillés numérotées où les jetons doivent être placés
4. Bouton de soumission : Soumission manuelle optionnelle (masqué en mode strictement modéré)

Comment les participants interagissent

1. Glisser : Cliquer/toucher un jeton dans la palette et le glisser
2. Déposer : Relâcher le jeton sur un emplacement cible
3. Alignement automatique : Le jeton s'aligne automatiquement au centre de l'emplacement
4. Retour : Si déposé en dehors des emplacements, le jeton retourne à la palette
5. Soumission automatique : La tâche avance automatiquement lorsque tous les emplacements requis sont remplis

Rétroaction visuelle

• Effet d'ombre : Les jetons glissés ont une ombre
• Surbrillance des emplacements : Les emplacements remplis deviennent verts
• Numéros des emplacements : Chaque emplacement affiche son numéro d'ordre
• Changement de curseur : Le curseur se transforme en « saisie » pendant le glissement

Données de sortie

Marqueurs et réponses

La tâche enregistre des marqueurs et réponses haute résolution pour chaque essai :

Marqueurs

Marqueur	Données	Description
trial_start	trial, block, fixation_ms, instruction, instruction_type, token_count, grid	Début de l'essai
stimulus_shown	trial, block, fixation_ms, instruction, instruction_type, token_count, grid	Les jetons deviennent interactifs
token_select	token_id, shape, color, size	Jeton sélectionné (mode sélection)
token_deselect	token_id, shape, color, size	Jeton désélectionné
drag_start	token_id, shape, color, size, position	Début du glissement (mode déplacement)
drag_end	token_id, shape, color, size, position, z_index	Fin du glissement
response_recorded	trial_index	Réponse soumise par le participant

Données de réponse

Chaque réponse du participant est enregistrée dans le tableau responses[] :

{
  "trial_index": 1,
  "source": "user_submit",
  "instruction_type": "select",
  "selected_tokens": [{"id": "token_0", "shape": "circle", "color": "#e11d48"}],
  "token_positions": [{"id": "token_0", "x": 100, "y": 50, "zIndex": 1}],
  "overlaps": [],
  "evaluation": {"correct": true, "details": "..."},
  "interactions": [{"type": "select", "tokenId": "token_0", "timestamp": 1234}]
}

Cette tâche ne produit pas d'artefacts médias. Toutes les données se trouvent dans le journal des marqueurs et réponses.

Conseils pour les chercheurs

Créer des commandes efficaces

1. Commencer simple : Un seul jeton, un seul emplacement
2. Augmenter la complexité : Plusieurs jetons, ordre spécifique
3. Varier les attributs : Mélanger les formes et les couleurs
4. Tester la compréhension : Inclure des distracteurs
5. Considérer la langue : Adapter les instructions à la langue du participant

Considérations relatives aux couleurs

• Utiliser des couleurs à haut contraste
• Envisager des palettes adaptées au daltonisme :
  • Rouge/Bleu : Le plus adapté au daltonisme
  • Éviter les combinaisons uniquement Rouge/Vert
• Tester sur votre population cible

Conception des essais

• Bloc A : Commandes simples (1-2 jetons)
• Bloc B : Complexité modérée (3-4 jetons)
• Bloc C : Commandes complexes (5+ jetons avec attributs)

Modes de modération

• Non modéré : Commandes écrites, les participants travaillent de manière indépendante
• Modéré : Le chercheur observe, peut donner des commandes verbales
• Strictement modéré : Le chercheur contrôle la progression de la tâche, le bouton de soumission est masqué

Dépannage

Les jetons ne répondent pas

• S'assurer que la tâche a commencé (l'instruction devrait être visible)
• Vérifier la console du navigateur pour les erreurs
• Vérifier que la configuration JSON des essais est valide

Les jetons ne s'alignent pas aux emplacements

• Les jetons ne s'alignent que lorsqu'ils sont relâchés au-dessus d'un emplacement
• Essayer de glisser plus près du centre de l'emplacement
• Vérifier que le canevas n'est pas zoomé/mis à l'échelle

Le tactile ne fonctionne pas

• S'assurer que l'appareil prend en charge les événements de pointeur
• Essayer d'utiliser un stylet ou un doigt (pas la paume)
• Vérifier la compatibilité du navigateur (navigateurs modernes uniquement)

Détails techniques

• Taille du canevas : 800x600 pixels
• Taille des jetons : 50 px de diamètre/largeur
• Zone palette : 760x150 px en haut
• Zone des emplacements : 600x100 px au centre
• Rendu : HTML5 Canvas avec événements de pointeur
• Support tactile : Oui (via les événements de pointeur)
• Accessibilité : Le support clavier n'est pas encore implémenté

Références

• De Renzi, E., & Vignolo, L.A. (1962). The token test: A sensitive test to detect receptive disturbances in aphasics. Brain, 85(4), 665-678.
• Standardisation du Token Test révisé (différentes versions disponibles)