Text
Тип питання з відповіддю у вільній формі в rtSurvey
Тип питання text збирає відповідь у вільній формі — будь-який рядок символів. Це найгнучкіший тип введення, що використовується для імен, адрес, описів, кодів та всього, що не підходить до більш конкретного типу.
rtSurvey також розширює text віджетами введення часу, що дозволяють точне введення часу за допомогою вибору годинника.
Базова специфікація XLSForm
| type | name | label |
|---|---|---|
| text | respondent_name | Full name of respondent |
| text | address | Home address |
Для отримання додаткових відомостей про стандартний тип text у XLSForm дивіться специфікацію XLSForm.
Використання
Текстові питання використовуються для:
- Імена, адреси, вільні описи
- Відкриті коментарі або відгуки
- Коди, ID або номери посилань, що не підходять для integer/decimal
- Збір значень часу з розширеннями введення часу rtSurvey
- Поля автодоповнення тексту (через
search-autocomplete-noedit-v2())
Стандартні варіанти appearance
| Appearance | Опис |
|---|---|
| (none) | Однорядкове текстове поле введення |
multiline | Багаторядкова текстова область — найкраще для довшого вільного тексту у веб |
Розширення введення часу rtSurvey
rtSurvey розширює text віджетом вибору годинника для збору значень часу. Ці варіанти appearance відображають піктограму годинника, яку анкетер може натиснути для вибору годин, хвилин, секунд або мілісекунд.
Варіанти appearance
| Appearance | Опис |
|---|---|
inline | Піктограма годинника відображається поряд з полем |
inline colors("RRGGBB") | Піктограма годинника з кастомним кольором hex |
inline-1line | Годинник відображається у компактному однорядковому форматі |
inline-1line-RRGGBB | Однорядковий з кастомним кольором піктограми (hex, без #) |
inline-1line colors("RRGGBB","RRGGBB") | Однорядковий з двома кольорами |
inline-onlyresult | Піктограма годинника зникає після вибору; відображається лише значення |
inline-onlyresult colors("RRGGBB") | Те саме, з кастомним кольором піктограми |
Токени формату часу
Додайте рядок формату в дужках для контролю відображуваних компонентів часу:
| Рядок формату | Відображає |
|---|---|
inline-[%H:%M] | Години та хвилини (24-годинний) |
inline-[%h:%M] | Години та хвилини (12-годинний) |
inline-[%H:%M:%S] | Години, хвилини, секунди (24-годинний) |
inline-[%h:%M:%S] | Години, хвилини, секунди (12-годинний) |
inline-[%H:%M:%3] | Години, хвилини, мілісекунди |
inline-[%M:%S] | Лише хвилини та секунди |
inline-[%M:%3] | Лише хвилини та мілісекунди |
inline-[%S] | Лише секунди |
inline-[%3] | Лише мілісекунди |
inline-[%H] | Лише години (24-годинний) |
inline-[%h] | Лише години (12-годинний) |
Приклад: Запис тривалості завдання в хвилинах і секундах
| type | name | label | appearance |
|---|---|---|---|
| text | task_duration | Time taken to complete the task | inline-[%M:%S] |
Приклад: Запис часу події в 24-годинному форматі з кастомним кольором
| type | name | label | appearance |
|---|---|---|---|
| text | event_time | Time of event | inline-1line colors("0099FF") |
Формат даних
Текстові дані зберігаються та експортуються як звичайний рядок. Для введення часу за допомогою вбудованого віджета годинника значення зберігається у форматі, що відповідає обраному рядку формату (наприклад, 14:32 для %H:%M).
Обмеження та валідація
Застосовуйте обмеження для перевірки формату, довжини або шаблону:
| type | name | label | constraint | constraint_message |
|---|---|---|---|---|
| text | name | Full name | string-length(.) >= 2 | Name must be at least 2 characters |
| text | code | Reference code | regex(., '^[A-Z]{2}[0-9]{4}$') | Enter 2 uppercase letters followed by 4 digits |
| text | phone | Phone number | regex(., '^[0-9]{9,15}$') | Enter a valid phone number |
Найкращі практики
- Використовуйте більш конкретні типи (
integer,decimal,date), коли дані мають відому структуру — це запобігає недійсним записам і спрощує аналіз. - Додавайте
constraintзstring-length()абоregex()для валідації кодів або ID. - Використовуйте appearance
multilineдля відкритих питань, де респонденти можуть написати кілька речень. - Для збору часу вибирайте токени формату часу, що відповідають точності, необхідній для вашого аналізу — збір мілісекунд, коли потрібні лише хвилини, марнує зусилля анкетера.
Підтримка платформ
Тип питання text та всі варіанти appearance введення часу підтримуються на платформах iOS, Android та веб.
Обмеження
- Текстові відповіді у вільній формі — немає вбудованої перевірки орфографії або обмеження словникового запасу, окрім шаблонів regex.
- Вбудований віджет часу є розширенням rtSurvey і не є частиною стандартної специфікації XLSForm.