Objet d'Entrée
L'Objet d'Entrée collecte des réponses libres des participants lors d'une expérience. Il prend en charge cinq types d'entrée : nombre, texte, date, heure et couleur. La réponse est stockée dans une variable liée et enregistrée automatiquement à la fin de chaque essai. Vous pouvez configurer des règles de validation, afficher des textes d'espace réservé pour guider les participants avant qu'ils ne commencent à taper, et contrôler l'élément via des événements.
Table des Matières
Ajout de l'Objet d'Entrée
Dans la barre d'outils de l'éditeur de tâches, ouvrez le groupe Question Inputs et sélectionnez Input pour ajouter un Objet d'Entrée au cadre actuel.
Lorsque l'élément est ajouté, Labvanced vous invite à nommer la variable qui stockera la réponse du participant. Donnez-lui un nom descriptif qui reflète les données collectées (par exemple, response_text ou age).
Types d'Entrée
Sélectionnez le type d'entrée dans le panneau Propriétés de l'Objet. Le type de données de la variable liée est automatiquement défini pour correspondre.
| Type d'Entrée | Type de Données de la Variable | Notes |
|---|---|---|
number | Numérique | Accepte les entiers et décimales. Validation de valeur min/max disponible. |
text | Chaîne | Accepte tout texte. Validation de la longueur de caractère disponible. |
date | Datetime | Affiche un sélecteur de date. Format de date configurable. |
time | Heure | Affiche un sélecteur de temps. |
color | Chaîne | Affiche un sélecteur de couleur. Stocke la valeur de couleur sélectionnée sous forme de chaîne. |
Propriétés
| Propriété | Défaut | Description |
|---|---|---|
Show Question Header | Activé | Affiche le label de texte de la question au-dessus du champ d'entrée. |
Show Placeholder | Désactivé | Lorsqu'il est activé, affiche un texte d'espace réservé à l'intérieur du champ avant que le participant ne commence à taper. Disponible uniquement pour les types number et text. |
Placeholder | (vide) | Le texte d'espace réservé. Visible uniquement dans le panneau lorsque Show Placeholder est activé. |
Required | Désactivé | Lorsqu'il est activé, le participant ne peut pas soumettre le cadre ou la page de questionnaire tant que ce champ ne contient pas une valeur valide. |
Input type | number | Le type de champ d'entrée affiché au participant. Options : number, text, date, time, color. |
Focused | false | Lorsqu'il est défini sur vrai, déplace le focus du clavier vers ce champ. Configurable par essai via le système d'événements. |
Min-Value | (aucun) | Pour le type number uniquement. La valeur la plus basse acceptée. |
Max-Value | (aucun) | Pour le type number uniquement. La valeur la plus haute acceptée. |
Min-Nr-Chars | (aucun) | Pour le type text uniquement. Le nombre minimum de caractères requis. |
Max-Nr-Chars | (aucun) | Pour le type text uniquement. Le nombre maximum de caractères autorisé. |
Date Format | browser-locale | Pour le type date uniquement. Contrôle comment la date est affichée et saisie. Options : browser-locale, yyyy-mm-dd, dd.mm.yyyy, mm/dd/yyyy. Visible uniquement dans le panneau lorsque le type d'entrée est défini sur date. |
Texte d'Espace Réservé
Le texte d'espace réservé apparaît à l'intérieur du champ d'entrée lorsqu'il est vide, avant que le participant ne commence à taper. Il disparaît dès que le participant commence à entrer une valeur.
Pour l'activer :
- Dans le panneau des Propriétés de l'Objet, activez
Enable Placeholder. - Entrez le texte souhaité dans le champ
Placeholder Text.
Utilisez le texte d'espace réservé pour donner aux participants un indice de format (par exemple, Enter a number between 1 and 100) ou une courte instruction, sans occuper d'espace au-dessus du champ avec un label complet.
Note: Le texte d'espace réservé n'est pas enregistré comme réponse. Il est uniquement affiché et n'affecte pas la valeur de la variable.
Validation
L'Objet d'Entrée comprend des options de validation intégrées pour garantir que les participants fournissent des données utilisables avant de continuer.
Champ requis : Activez Is Required pour empêcher la soumission du cadre ou de la page tant que le champ ne contient pas une valeur valide et non vide. Si un participant tente de continuer sans remplir un champ requis, le champ est surligné.
Plage numérique : Pour les entrées number, définissez Min Value et Max Value pour restreindre les entrées acceptées. Si un participant saisit une valeur en dehors de la plage et quitte ensuite le champ, la valeur est automatiquement corrigée au bord le plus proche.
Longueur de caractère : Pour les entrées text, définissez Min Nr Chars et Max Nr Chars pour imposer des contraintes de longueur. Celles-ci sont vérifiées lorsque Is Required est activé.
Intégration de Variable
Chaque Objet d'Entrée est lié à une variable globale, créée lorsque vous ajoutez l'élément. La variable stocke la valeur de réponse actuelle du participant et est enregistrée à la fin de l'essai.
Le type de données de la variable est automatiquement défini en fonction du type d'entrée sélectionné :
number→ Variable numériquetext→ Variable de chaînedate→ Variable datetimetime→ Variable d'heurecolor→ Variable de chaîne
Pour relier à nouveau l'élément à une autre variable, utilisez le sélecteur de variable dans le panneau des Propriétés de l'Objet.
Intégration d'Événements
L'Objet d'Entrée fonctionne avec des événements de deux manières : en tant que cible de déclenchement et en tant que cible d'action.
Déclenchement d'événements depuis l'Objet d'Entrée
Le déclencheur Enter On Input s'active lorsque le participant appuie sur Entrée ou Retour tout en ayant le champ d'entrée en focus. Ajoutez votre Objet d'Entrée sous Targets: dans la configuration du déclencheur.
Exemple : soumettre le cadre lorsque le participant appuie sur Entrée
Déclencheur :
Enter On Input→Targets: ajoutez votre Objet d'Entrée Action :Jump to Next Frame
Contrôler l'Objet d'Entrée via des actions
Deux propriétés sont modifiables en temps réel via l'action Set Object Property :
| Propriété Modifiable | Description |
|---|---|
Focused | Lorsqu'il est défini sur vrai, déplace le focus vers le champ d'entrée de manière programmatique. |
required | Peut être activé ou désactivé en temps réel pour exiger conditionnellement le champ en fonction des réponses antérieures des participants. |
Exemple : focaliser le champ d'entrée lorsque le cadre commence
Déclencheur :
On Frame StartAction :Set Object Property→Set Target: votre Objet d'Entrée → propriété :Focused→ valeur :true
Exemple : rendre le champ requis en fonction d'une réponse antérieure
Déclencheur :
Variable Value Changed→ votre variable de condition Action :Set Object Property→Set Target: votre Objet d'Entrée → propriété :required→ valeur :true
Vous pouvez également lire la valeur de réponse actuelle de la variable liée dans toute action d'événement, par exemple pour déterminer le flux d'expérience en fonction de ce que le participant a tapé.
Lectures Supplémentaires
Système d'Événements
Comment les déclencheurs et les actions sont structurés. Couvre la définition des propriétés d'objet en temps réel, y compris les contrôles Focusé et Requis pour l'Objet d'Entrée.
Travailler avec des Variables
Comment créer, configurer et enregistrer des variables. Couvre les types de données, les options d'enregistrement et les paramètres de validation qui s'appliquent aux réponses de l'Objet d'Entrée.
Types de Variables
Un aperçu de tous les types de variables dans Labvanced. Vous aide à comprendre pourquoi chaque type d'entrée est lié à un type de données de variable différent.