Text
Type de question de réponse textuelle libre dans rtSurvey
Le type de question text collecte une réponse en texte libre — toute chaîne de caractères. C’est le type de saisie le plus flexible, utilisé pour les noms, adresses, descriptions, codes et tout ce qui ne correspond pas à un type plus spécifique.
rtSurvey étend également text avec des widgets de saisie de l’heure permettant une saisie précise via un sélecteur d’horloge.
Spécification XLSForm de base
| type | name | label |
|---|---|---|
| text | respondent_name | Nom complet du répondant |
| text | address | Adresse du domicile |
Pour plus de détails sur le type text XLSForm standard, consultez la spécification XLSForm.
Utilisations
Les questions texte sont utilisées pour :
- Noms, adresses, descriptions libres
- Commentaires ou retours ouverts
- Codes, identifiants ou numéros de référence qui ne correspondent pas à integer/decimal
- Collecte de valeurs horaires avec les extensions de saisie de l’heure de rtSurvey
- Champs de texte avec autocomplétion (via
search-autocomplete-noedit-v2())
Options d’apparence standard
| Appearance | Description |
|---|---|
| (aucune) | Saisie de texte sur une seule ligne |
multiline | Zone de texte multi-lignes — idéale pour le texte libre long sur le web |
Extensions de saisie de l’heure de rtSurvey
rtSurvey étend text avec un widget de sélection d’horloge pour collecter des valeurs horaires. Ces options d’apparence affichent une icône d’horloge que l’enquêteur peut toucher pour sélectionner les heures, minutes, secondes ou millisecondes.
Variantes d’apparence
| Appearance | Description |
|---|---|
inline | Icône d’horloge affichée à côté du champ |
inline colors("RRGGBB") | Icône d’horloge avec couleur hexadécimale personnalisée |
inline-1line | Horloge affichée dans un format compact sur une seule ligne |
inline-1line-RRGGBB | Format sur une seule ligne avec couleur d’icône personnalisée (hex, sans #) |
inline-1line colors("RRGGBB","RRGGBB") | Format sur une seule ligne avec deux couleurs |
inline-onlyresult | L’icône d’horloge disparaît après sélection ; seule la valeur est affichée |
inline-onlyresult colors("RRGGBB") | Identique, avec couleur d’icône personnalisée |
Jetons de format horaire
Ajoutez une chaîne de format entre crochets pour contrôler les composantes horaires affichées :
| Chaîne de format | Affiche |
|---|---|
inline-[%H:%M] | Heures et minutes (format 24h) |
inline-[%h:%M] | Heures et minutes (format 12h) |
inline-[%H:%M:%S] | Heures, minutes, secondes (format 24h) |
inline-[%h:%M:%S] | Heures, minutes, secondes (format 12h) |
inline-[%H:%M:%3] | Heures, minutes, millisecondes |
inline-[%M:%S] | Minutes et secondes uniquement |
inline-[%M:%3] | Minutes et millisecondes uniquement |
inline-[%S] | Secondes uniquement |
inline-[%3] | Millisecondes uniquement |
inline-[%H] | Heures uniquement (format 24h) |
inline-[%h] | Heures uniquement (format 12h) |
Exemple : Enregistrer la durée d’une tâche en minutes et secondes
| type | name | label | appearance |
|---|---|---|---|
| text | task_duration | Temps nécessaire pour accomplir la tâche | inline-[%M:%S] |
Exemple : Enregistrer l’heure d’un événement au format 24h avec couleur personnalisée
| type | name | label | appearance |
|---|---|---|---|
| text | event_time | Heure de l’événement | inline-1line colors("0099FF") |
Format des données
Les données texte sont stockées et exportées sous forme de chaîne simple. Pour les saisies basées sur l’heure utilisant le widget d’horloge inline, la valeur est stockée dans le format correspondant à la chaîne de format choisie (ex. : 14:32 pour %H:%M).
Contraintes et validation
Appliquez des contraintes pour imposer un format, une longueur ou un motif :
| type | name | label | constraint | constraint_message |
|---|---|---|---|---|
| text | name | Nom complet | string-length(.) >= 2 | Le nom doit comporter au moins 2 caractères |
| text | code | Code de référence | regex(., '^[A-Z]{2}[0-9]{4}$') | Saisir 2 lettres majuscules suivies de 4 chiffres |
| text | phone | Numéro de téléphone | regex(., '^[0-9]{9,15}$') | Saisir un numéro de téléphone valide |
Bonnes pratiques
- Utilisez des types plus spécifiques (
integer,decimal,date) dès que les données ont une structure connue — cela évite les saisies invalides et simplifie l’analyse. - Ajoutez une
constraintavecstring-length()ouregex()pour valider les codes ou identifiants. - Utilisez l’apparence
multilinepour les questions ouvertes où les répondants peuvent écrire plusieurs phrases. - Pour la collecte de l’heure, choisissez les jetons de format horaire qui correspondent à la précision requise par votre analyse — collecter des millisecondes quand vous n’avez besoin que des minutes représente un effort inutile pour l’enquêteur.
Support des plateformes
Le type de question text et toutes les apparences de saisie de l’heure sont pris en charge sur les plateformes iOS, Android et web.
Limitations
- Les réponses texte sont libres — il n’y a pas de vérification orthographique intégrée ni de contrainte de vocabulaire au-delà des motifs regex.
- Le widget d’horloge inline est une extension rtSurvey et ne fait pas partie de la spécification XLSForm standard.