The appearance column in rtSurvey allows you to customize the visual presentation and behavior of questions in your surveys. This feature enhances user experience and can significantly improve data collection efficiency. rtSurvey supports standard XLSForm appearance attributes and extends them with additional options.

Standard XLSForm Appearance Attributes

rtSurvey supports the following standard XLSForm appearance attributes:

Appearance AttributeQuestion TypesDescription
multilinetextCreates a multi-line text box (best for web clients)
minimalselect_one, select_multipleDisplays choices in a dropdown menu
quickselect_oneAuto-advances to next question after selection (mobile only)
no-calendardateSuppresses the calendar display (mobile only)
month-yeardateAllows selection of month and year only
yeardateAllows selection of year only
horizontal-compactselect_one, select_multipleDisplays choices horizontally (web only)
horizontalselect_one, select_multipleDisplays choices horizontally in columns (web only)
likertselect_onePresents choices as a Likert scale
compactselect_one, select_multipleDisplays choices side by side with minimal padding
quickcompactselect_oneCombines compact display with auto-advance (mobile only)
field-listgroupsDisplays entire group on one screen (mobile only)
labelselect_one, select_multipleShows choice labels without inputs
list-nolabelselect_one, select_multipleShows inputs without labels (use with label)
table-listgroupsDisplays questions in a table format
signatureimageEnables signature capture (mobile only)
drawimageAllows freehand drawing (mobile only)
map, quick mapselect_one, select_one_from_fileEnables selection from map features

Best Practices for Using Appearance

  1. Consistency: Use appearance attributes consistently across your survey for a uniform look.
  2. Mobile vs. Web: Consider how appearances will render on different devices and platforms.
  3. Performance: Be cautious with appearance attributes that might slow down form loading (e.g., table-list for large groups).
  4. User Experience: Choose appearances that make data entry easier and more intuitive for respondents.
  5. Testing: Always test your form on target devices to ensure appearances work as expected.

Advanced Techniques

Combining Appearances

Some appearance attributes can be combined for more complex layouts:

  | type | name | label | appearance |
|------|------|-------|------------|
| select_one options | choice | Select one: | minimal compact |

Dynamic Appearances

rtSurvey allows for dynamic appearance changes based on form logic:

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

Mobile App Considerations

  • Some appearances (e.g., quick, signature) are specific to mobile devices.
  • Test thoroughly on both Android and iOS to ensure consistent behavior.

Known Limitations

  • Complex appearances may not render identically across all platforms.
  • Some advanced rtSurvey appearances may not be supported in offline mode.

Troubleshooting Appearance Issues

  1. Appearance Not Applied: Check for typos in the appearance column.
  2. Inconsistent Rendering: Verify compatibility with the question type and platform.
  3. Performance Issues: Consider simplifying complex appearances, especially for large surveys.
Was this page helpful?