
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 un texte 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 | Remarques |
|---|---|---|
number | Numérique | Accepte les entiers et les décimales. Validation de valeur min/max disponible. |
text | Chaîne | Accepte n'importe quel texte. Validation de la longueur des caractères disponible. |
date | Date/heure | Affiche un sélecteur de date. Format de date configurable. |
time | Heure | Affiche un sélecteur d'heure. |
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é | Par défaut | Description |
|---|---|---|
Show Question Header | Activé | Affiche le texte de la question au-dessus du champ de saisie. |
Show Placeholder | Désactivé | Lorsqu'il est activé, affiche le 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 dans le panneau uniquement lorsque Show Placeholder est activé. |
Required | Désactivé | Lorsqu'il est activé, le participant ne peut pas soumettre le cadre ou la page du questionnaire tant que ce champ ne contient pas une valeur valide. |
Input type | number | Le type de champ de saisie affiché au participant. Options : number, text, date, time, color. |
Focused | faux | 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 élevée 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és. |
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 dans le panneau uniquement lorsque le type d'entrée est défini sur date. |
Texte de remplacement
Le texte de remplacement apparaît à l'intérieur du champ de saisie 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 Propriétés de l'objet, activez
Enable Placeholder. - Entrez le texte souhaité dans le champ
Placeholder Text.
Utilisez le texte de remplacement 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 une étiquette complète.
Note: Le texte de remplacement 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 inclut des options de validation intégrées pour s'assurer que les participants fournissent des données utilisables avant de procéder.
Champ requis : Activez Is Required pour empêcher la soumission du cadre ou de la page jusqu'à ce que le champ contienne une valeur valide et non vide. Si un participant tente de procéder sans remplir un champ requis, le champ est mis en surbrillance.
Plage numérique : Pour les entrées number, définissez Min Value et Max Value pour limiter 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 des caractères : Pour les entrées text, définissez Min Nr Chars et Max Nr Chars pour appliquer des contraintes de longueur. Celles-ci sont vérifiées lorsque Is Required est activé.
Intégration des variables
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 chaînedate→ Variable date/heuretime→ Variable heurecolor→ Variable chaîne
Pour relier à nouveau l'élément à une autre variable, utilisez le sélecteur de variables dans le panneau Propriétés de l'objet.
Intégration des événements
L'objet d'entrée fonctionne avec les é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 se déclenche lorsque le participant appuie sur Entrée ou Retour pendant que le champ de saisie est ciblé. 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 à l'exécution 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 de saisie de manière programmatique. |
required | Peut être basculé à l'exécution pour exiger conditionnellement le champ en fonction des réponses précédentes du participant. |
Exemple : focaliser sur 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 précédente
Déclencheur :
Variable Value Changed→ votre variable conditionnelle 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 n'importe quelle action d'événement, par exemple pour ramifier le flux de l'expérience en fonction de ce que le participant a tapé.
Lectures complémentaires
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 d'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 variable différent.
Système d'événements
Comment les déclencheurs et les actions sont structurés. Couvre la définition des propriétés des objets à l'exécution, y compris les contrôles Focalisé et Requis pour l'objet d'entrée.