Texto
Tipo de pergunta de resposta de texto livre no rtSurvey
O tipo de pergunta text coleta uma resposta de texto livre — qualquer string de caracteres. É o tipo de entrada mais flexível e é usado para nomes, endereços, descrições, códigos e qualquer coisa que não se encaixe em um tipo mais específico.
O rtSurvey também estende text com widgets de entrada de hora que permitem a entrada precisa de hora com um seletor de relógio.
Especificação básica do XLSForm
| type | name | label |
|---|---|---|
| text | respondent_name | Nome completo do respondente |
| text | address | Endereço residencial |
Para mais detalhes sobre o tipo text XLSForm padrão, consulte a especificação do XLSForm.
Usos
As perguntas de texto são usadas para:
- Nomes, endereços, descrições livres
- Comentários ou feedback de resposta aberta
- Códigos, IDs ou números de referência que não se encaixam em integer/decimal
- Coletar valores de hora com as extensões de entrada de hora do rtSurvey
- Campos de texto com preenchimento automático (via
search-autocomplete-noedit-v2())
Opções de aparência padrão
| Aparência | Descrição |
|---|---|
| (nenhuma) | Entrada de texto de linha única |
multiline | Área de texto de múltiplas linhas — melhor para texto livre mais longo na web |
Extensões de entrada de hora do rtSurvey
O rtSurvey estende text com um widget de seletor de relógio para coletar valores de hora. Essas opções de aparência exibem um ícone de relógio que o entrevistador pode tocar para selecionar horas, minutos, segundos ou milissegundos.
Variantes de aparência
| Aparência | Descrição |
|---|---|
inline | Ícone de relógio exibido ao lado do campo |
inline colors("RRGGBB") | Ícone de relógio com cor hexadecimal personalizada |
inline-1line | Relógio exibido em formato compacto de linha única |
inline-1line-RRGGBB | Linha única com cor de ícone personalizada (hexadecimal, sem #) |
inline-1line colors("RRGGBB","RRGGBB") | Linha única com duas cores |
inline-onlyresult | O ícone de relógio desaparece após a seleção; apenas o valor é mostrado |
inline-onlyresult colors("RRGGBB") | Igual, com cor de ícone personalizada |
Tokens de formato de hora
Anexe uma string de formato entre colchetes para controlar quais componentes de hora são mostrados:
| String de formato | Exibe |
|---|---|
inline-[%H:%M] | Horas e minutos (24 horas) |
inline-[%h:%M] | Horas e minutos (12 horas) |
inline-[%H:%M:%S] | Horas, minutos, segundos (24 horas) |
inline-[%h:%M:%S] | Horas, minutos, segundos (12 horas) |
inline-[%H:%M:%3] | Horas, minutos, milissegundos |
inline-[%M:%S] | Apenas minutos e segundos |
inline-[%M:%3] | Apenas minutos e milissegundos |
inline-[%S] | Apenas segundos |
inline-[%3] | Apenas milissegundos |
inline-[%H] | Apenas horas (24 horas) |
inline-[%h] | Apenas horas (12 horas) |
Exemplo: Registrar a duração de uma tarefa em minutos e segundos
| type | name | label | appearance |
|---|---|---|---|
| text | task_duration | Tempo para concluir a tarefa | inline-[%M:%S] |
Exemplo: Registrar um horário de evento no formato 24 horas com cor personalizada
| type | name | label | appearance |
|---|---|---|---|
| text | event_time | Hora do evento | inline-1line colors("0099FF") |
Formato de dados
Os dados de texto são armazenados e exportados como uma string simples. Para entradas baseadas em hora usando o widget de relógio inline, o valor é armazenado no formato correspondente à string de formato escolhida (por exemplo, 14:32 para %H:%M).
Restrições e validação
Aplique restrições para impor formato, comprimento ou padrão:
| type | name | label | constraint | constraint_message |
|---|---|---|---|---|
| text | name | Nome completo | string-length(.) >= 2 | O nome deve ter pelo menos 2 caracteres |
| text | code | Código de referência | regex(., '^[A-Z]{2}[0-9]{4}$') | Digite 2 letras maiúsculas seguidas de 4 dígitos |
| text | phone | Número de telefone | regex(., '^[0-9]{9,15}$') | Digite um número de telefone válido |
Práticas recomendadas
- Use tipos mais específicos (
integer,decimal,date) sempre que os dados tiverem uma estrutura conhecida — isso evita entradas inválidas e simplifica a análise. - Adicione
constraintcomstring-length()ouregex()para validar códigos ou IDs. - Use a aparência
multilinepara perguntas abertas onde os respondentes podem escrever várias frases. - Para coleta de hora, escolha os tokens de formato de hora que correspondam à precisão que sua análise requer — coletar milissegundos quando você só precisa de minutos desperdiça o esforço do entrevistador.
Suporte de plataforma
O tipo de pergunta text e todas as aparências de entrada de hora são suportados nas plataformas iOS, Android e web.
Limitações
- As respostas de texto são de forma livre — não há verificação ortográfica integrada ou restrição de vocabulário além de padrões regex.
- O widget de hora inline é uma extensão do rtSurvey e não faz parte da especificação padrão do XLSForm.