La columna appearance en rtSurvey le permite personalizar la presentación visual y el comportamiento de las preguntas en sus encuestas. Esta función mejora la experiencia del usuario y puede mejorar significativamente la eficiencia de la recopilación de datos. rtSurvey admite atributos de apariencia estándar de XLSForm y los amplía con opciones adicionales.

Atributos de apariencia estándar de XLSForm

rtSurvey admite los siguientes atributos de apariencia estándar de XLSForm:

Atributo de aparienciaTipos de preguntaDescripción
multilinetextCrea un cuadro de texto multilínea (mejor para clientes web)
minimalselect_one, select_multipleMuestra las opciones en un menú desplegable
quickselect_oneAvanza automáticamente a la siguiente pregunta después de la selección (solo móvil)
no-calendardateSuprime la visualización del calendario (solo móvil)
month-yeardatePermite la selección de mes y año solamente
yeardatePermite la selección de año solamente
horizontal-compactselect_one, select_multipleMuestra las opciones horizontalmente (solo web)
horizontalselect_one, select_multipleMuestra las opciones horizontalmente en columnas (solo web)
likertselect_onePresenta las opciones como una escala Likert
compactselect_one, select_multipleMuestra las opciones una al lado de la otra con relleno mínimo
quickcompactselect_oneCombina la visualización compacta con el avance automático (solo móvil)
field-listgroupsMuestra todo el grupo en una pantalla (solo móvil)
labelselect_one, select_multipleMuestra las etiquetas de opciones sin entradas
list-nolabelselect_one, select_multipleMuestra las entradas sin etiquetas (usar con label)
table-listgroupsMuestra las preguntas en formato de tabla
signatureimageHabilita la captura de firma (solo móvil)
drawimagePermite el dibujo a mano alzada (solo móvil)
map, quick mapselect_one, select_one_from_fileHabilita la selección desde características del mapa

Mejores prácticas para usar la apariencia

  1. Coherencia: Use los atributos de apariencia de forma coherente en toda su encuesta para una apariencia uniforme.
  2. Móvil vs. Web: Considere cómo se renderizarán las apariencias en diferentes dispositivos y plataformas.
  3. Rendimiento: Tenga cuidado con los atributos de apariencia que podrían ralentizar la carga del formulario (p. ej., table-list para grupos grandes).
  4. Experiencia del usuario: Elija apariencias que faciliten la entrada de datos y sean más intuitivas para los encuestados.
  5. Pruebas: Pruebe siempre su formulario en los dispositivos de destino para asegurarse de que las apariencias funcionen como se espera.

Técnicas avanzadas

Combinar apariencias

Algunos atributos de apariencia pueden combinarse para diseños más complejos:

  | type | name | label | appearance |
|------|------|-------|------------|
| select_one options | choice | Seleccione uno: | minimal compact |

Apariencias dinámicas

rtSurvey permite cambios dinámicos de apariencia basados en la lógica del formulario:

  | type | name | label | appearance | relevant |
|------|------|-------|------------|----------|
| text | time | Ingrese la hora: | inline-[%H:%M] | ${show_time} = 'yes' |

Consideraciones sobre la aplicación móvil

  • Algunas apariencias (p. ej., quick, signature) son específicas para dispositivos móviles.
  • Pruebe exhaustivamente tanto en Android como en iOS para garantizar un comportamiento coherente.

Atributos de apariencia extendida de rtSurvey

Además de las apariencias estándar de XLSForm, rtSurvey admite las siguientes opciones específicas de la plataforma:

Control de datos y visualización

Atributo de aparienciaTipos de preguntaDescripción
invisiblecualquieraOculta el campo de la vista mientras aún recopila o calcula su valor. Diferente del tipo hidden — el campo aún participa en la lógica.
displaytitlecualquieraFuerza la visualización de la etiqueta/título del campo incluso cuando de otro modo estaría suprimido.
autopullselect_one, select_multipleObtiene automáticamente datos externos para llenar las opciones cuando el formulario se carga o un campo disparador cambia.
floating_hinttext, integer, decimalMuestra el texto de sugerencia como una etiqueta flotante encima del campo de entrada en lugar de debajo.
calculate-buttoncalculateAgrega un botón visible que activa el recálculo del campo a demanda, en lugar de calcularse automáticamente.

Diseño

Atributo de aparienciaTipos de preguntaDescripción
1screengroupFuerza a que todo el grupo se muestre en una sola pantalla independientemente del tamaño del grupo.
columns(n)select_one, select_multipleMuestra las opciones en n columnas. Ejemplo: columns(3) muestra tres columnas de botones de radio.
gridformat<row=R col=C colspan=S align=center>cualquieraPosiciona el campo en un diseño de cuadrícula CSS en la fila R, columna C, abarcando S columnas. Se usa con advanced-extension/grid-layout.
ignore-simplifycualquieraInstruye al renderizador de formularios a omitir la simplificación o condensación automática del diseño de este campo.

Widgets

Atributo de aparienciaTipos de preguntaDescripción
likertselect_onePresenta las opciones como una fila de escala Likert (ya en la tabla estándar anterior; confirmado como compatible).
distressselect_oneRenderiza las opciones como el widget visual de la Escala de angustia psicológica de Kessler (K10) con iconos emocionales.

Integración de API

Atributo de aparienciaTipos de preguntaDescripción
callapitext, integer, decimal, select_oneHabilita la integración de llamada a API para este campo. La columna de cálculo debe contener una expresión callapi(). Consulte Call API.
callapi-verify(params)text, integer, decimalActiva una llamada de verificación de API usando parámetros estáticos. El formulario bloquea el progreso hasta que la API confirme el valor.
callapi-verify(dynamicParams)text, integer, decimalIgual que callapi-verify pero con parámetros derivados de otros valores de campo en tiempo de ejecución.

Formato de fecha/hora en línea

Para campos date, time y datetime, puede especificar un formato de visualización personalizado usando una cadena de formato anexada a la apariencia:

  inline-[%d/%m/%Y]
inline-1line-[%d/%m/%Y %H:%M]

Los tokens de formato son los mismos que format-date() y format-date-time(). Consulte Funciones — Funciones de fecha y hora.

Ejemplo:

typenamelabelappearance
datetimeevent_timeFecha y hora del eventoinline-[%d/%m/%Y %I:%M %p]
datebirth_dateFecha de nacimientoinline-[%d/%m/%Y]

Limitaciones conocidas

  • Las apariencias complejas pueden no renderizarse de forma idéntica en todas las plataformas.
  • Algunas apariencias avanzadas de rtSurvey pueden no estar disponibles en el modo sin conexión.

Solución de problemas de apariencia

  1. Apariencia no aplicada: Verifique si hay errores tipográficos en la columna de apariencia.
  2. Renderización inconsistente: Verifique la compatibilidad con el tipo de pregunta y la plataforma.
  3. Problemas de rendimiento: Considere simplificar las apariencias complejas, especialmente para encuestas grandes.
¿Fue útil esta página?