
Objet d'Entrée
L'Objet d'Entrée collecte des réponses librement formulées des participants pendant 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 Variable | Remarques |
|---|---|---|
number | Numérique | Accepte les entiers et les décimales. Validation de valeur min/max disponible. |
text | Chaîne | Accepte tout texte. Validation de longueur de caractère 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 en tant que chaîne. |
Propriétés
| Propriété | Par Défaut | Description |
|---|---|---|
Show Question Header | Activé | Affiche l'étiquette de texte de la question au-dessus du champ de saisie. |
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 de 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 du questionnaire jusqu'à ce que ce champ contienne 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 true, 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 plus basse valeur acceptée. |
Max-Value | (aucun) | Pour le type number uniquement. La plus haute valeur 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 la façon dont 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 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 désiré 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 brève instruction, sans occuper d'espace au-dessus du champ avec une étiquette complète.
Note: Le texte d'espace réservé n'est pas enregistré en tant que 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 continuer.
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 continuer 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 entre une valeur en dehors de la plage et quitte ensuite le champ, la valeur est automatiquement corrigée à la limite la plus proche.
Longueur de caractère : Pour les entrées text, définissez Min Nr Chars et Max Nr Chars pour faire respecter les contraintes de longueur. Celles-ci sont vérifiées lorsque Is Required est activé.
Intégration de la 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 de date/heuretime→ Variable de tempscolor→ Variable de chaîne
Pour relier l'élément à une autre variable, utilisez le sélecteur de variable dans le panneau Propriétés de l'Objet.
Intégration des Événements
L'Objet d'Entrée fonctionne avec des événements de deux manières : comme cible de déclenchement et comme cible d'action.
Déclencher des é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 focalisé. 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 true, déplace le focus vers le champ d'entrée 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 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 modifier le flux de l'expérience en fonction de ce que le participant a tapé.
Lectures Complémentaires
Système d'Événements
Comment sont structurés les déclencheurs et les actions. Couvre la définition des propriétés d'objet à l'exécution, y compris les contrôles Focalisé 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.