Texto
Tipo de pregunta de respuesta de texto libre en rtSurvey
El tipo de pregunta text recopila una respuesta de texto libre — cualquier cadena de caracteres. Es el tipo de entrada más flexible y se usa para nombres, direcciones, descripciones, códigos y cualquier cosa que no encaje en un tipo más específico.
rtSurvey también extiende text con widgets de entrada de hora que permiten la entrada precisa de tiempo con un selector de reloj.
Especificación básica de XLSForm
| type | name | label |
|---|---|---|
| text | respondent_name | Nombre completo del encuestado |
| text | address | Dirección de domicilio |
Para obtener más detalles sobre el tipo de texto estándar de XLSForm, consulte la especificación de XLSForm.
Usos
Las preguntas de texto se usan para:
- Nombres, direcciones, descripciones libres
- Comentarios o retroalimentación de respuesta abierta
- Códigos, IDs o números de referencia que no encajan en entero/decimal
- Recopilación de valores de tiempo con las extensiones de entrada de hora de rtSurvey
- Campos de texto de autocompletado (a través de
search-autocomplete-noedit-v2())
Opciones de apariencia estándar
| Apariencia | Descripción |
|---|---|
| (ninguna) | Entrada de texto de una sola línea |
multiline | Área de texto de varias líneas — mejor para texto libre más largo en web |
Extensiones de entrada de hora de rtSurvey
rtSurvey extiende text con un widget selector de reloj para recopilar valores de hora. Estas opciones de apariencia muestran un icono de reloj que el encuestador puede tocar para seleccionar horas, minutos, segundos o milisegundos.
Variantes de apariencia
| Apariencia | Descripción |
|---|---|
inline | Icono de reloj mostrado junto al campo |
inline colors("RRGGBB") | Icono de reloj con color hexadecimal personalizado |
inline-1line | Reloj mostrado en formato compacto de una sola fila |
inline-1line-RRGGBB | Fila única con color de icono personalizado (hex, sin #) |
inline-1line colors("RRGGBB","RRGGBB") | Fila única con dos colores |
inline-onlyresult | El icono de reloj desaparece después de la selección; solo se muestra el valor |
inline-onlyresult colors("RRGGBB") | Igual, con color de icono personalizado |
Tokens de formato de hora
Agregue una cadena de formato entre corchetes para controlar qué componentes de hora se muestran:
| Cadena de formato | Muestra |
|---|---|
inline-[%H:%M] | Horas y minutos (24 horas) |
inline-[%h:%M] | Horas y 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, milisegundos |
inline-[%M:%S] | Solo minutos y segundos |
inline-[%M:%3] | Solo minutos y milisegundos |
inline-[%S] | Solo segundos |
inline-[%3] | Solo milisegundos |
inline-[%H] | Solo horas (24 horas) |
inline-[%h] | Solo horas (12 horas) |
Ejemplo: Registrar la duración de una tarea en minutos y segundos
| type | name | label | appearance |
|---|---|---|---|
| text | task_duration | Tiempo necesario para completar la tarea | inline-[%M:%S] |
Ejemplo: Registrar la hora de un evento en formato de 24 horas con color personalizado
| type | name | label | appearance |
|---|---|---|---|
| text | event_time | Hora del evento | inline-1line colors("0099FF") |
Formato de datos
Los datos de texto se almacenan y exportan como una cadena simple. Para entradas basadas en tiempo que usan el widget de reloj en línea, el valor se almacena en el formato que coincide con la cadena de formato elegida (p. ej., 14:32 para %H:%M).
Restricciones y validación
Aplique restricciones para exigir formato, longitud o patrón:
| type | name | label | constraint | constraint_message |
|---|---|---|---|---|
| text | name | Nombre completo | string-length(.) >= 2 | El nombre debe tener al menos 2 caracteres |
| text | code | Código de referencia | regex(., '^[A-Z]{2}[0-9]{4}$') | Ingrese 2 letras mayúsculas seguidas de 4 dígitos |
| text | phone | Número de teléfono | regex(., '^[0-9]{9,15}$') | Ingrese un número de teléfono válido |
Mejores prácticas
- Use tipos más específicos (
integer,decimal,date) siempre que los datos tengan una estructura conocida; esto previene entradas inválidas y simplifica el análisis. - Agregue
constraintconstring-length()oregex()para validar códigos o IDs. - Use la apariencia
multilinepara preguntas abiertas donde los encuestados puedan escribir varias oraciones. - Para la recopilación de tiempo, elija los tokens de formato que coincidan con la precisión que requiere su análisis; recopilar milisegundos cuando solo necesita minutos desperdicia el esfuerzo del encuestador.
Soporte de plataforma
El tipo de pregunta de texto y todas las apariencias de entrada de hora son compatibles con iOS, Android y plataformas web.
Limitaciones
- Las respuestas de texto son de forma libre; no hay corrección ortográfica integrada ni restricción de vocabulario más allá de los patrones regex.
- El widget de hora en línea es una extensión de rtSurvey y no forma parte de la especificación estándar de XLSForm.