Столбец appearance в rtSurvey позволяет настраивать визуальное представление и поведение вопросов в опросах. Эта функция улучшает пользовательский опыт и может значительно повысить эффективность сбора данных. rtSurvey поддерживает стандартные атрибуты внешнего вида XLSForm и расширяет их дополнительными опциями.

Стандартные атрибуты внешнего вида XLSForm

rtSurvey поддерживает следующие стандартные атрибуты внешнего вида XLSForm:

Атрибут внешнего видаТипы вопросовОписание
multilinetextСоздаёт многострочное текстовое поле (лучше для веб-клиентов)
minimalselect_one, select_multipleОтображает варианты в выпадающем меню
quickselect_oneАвтоматически переходит к следующему вопросу после выбора (только мобильные)
no-calendardateСкрывает отображение календаря (только мобильные)
month-yeardateПозволяет выбирать только месяц и год
yeardateПозволяет выбирать только год
horizontal-compactselect_one, select_multipleОтображает варианты горизонтально (только веб)
horizontalselect_one, select_multipleОтображает варианты горизонтально в столбцах (только веб)
likertselect_oneПредставляет варианты в виде шкалы Лайкерта
compactselect_one, select_multipleОтображает варианты рядом с минимальными отступами
quickcompactselect_oneСочетает компактное отображение с автопереходом (только мобильные)
field-listgroupsОтображает всю группу на одном экране (только мобильные)
labelselect_one, select_multipleПоказывает метки вариантов без элементов ввода
list-nolabelselect_one, select_multipleПоказывает элементы ввода без меток (используйте с label)
table-listgroupsОтображает вопросы в табличном формате
signatureimageВключает захват подписи (только мобильные)
drawimageПозволяет рисовать от руки (только мобильные)
map, quick mapselect_one, select_one_from_fileПозволяет выбирать из объектов на карте

Лучшие практики использования внешнего вида

  1. Согласованность: Используйте атрибуты внешнего вида последовательно для единообразного вида.
  2. Мобильные vs. Веб: Учитывайте, как внешний вид будет отображаться на разных устройствах.
  3. Производительность: Будьте осторожны с атрибутами, которые могут замедлять загрузку формы.
  4. Пользовательский опыт: Выбирайте варианты внешнего вида, упрощающие ввод данных.
  5. Тестирование: Всегда тестируйте форму на целевых устройствах.

Расширенные техники

Комбинирование вариантов внешнего вида

Некоторые атрибуты внешнего вида можно комбинировать:

  | type | name | label | appearance |
|------|------|-------|------------|
| select_one options | choice | Выберите: | minimal compact |

Динамический внешний вид

rtSurvey позволяет динамически изменять внешний вид на основе логики формы:

  | type | name | label | appearance | relevant |
|------|------|-------|------------|----------|
| text | time | Введите время: | inline-[%H:%M] | ${show_time} = 'yes' |

Соображения для мобильного приложения

  • Некоторые варианты внешнего вида (например, quick, signature) специфичны для мобильных устройств.
  • Тщательно тестируйте на Android и iOS для обеспечения согласованного поведения.

Расширенные атрибуты внешнего вида rtSurvey

В дополнение к стандартным вариантам внешнего вида XLSForm, rtSurvey поддерживает следующие платформенно-специфические опции:

Управление данными и отображением

Атрибут внешнего видаТипы вопросовОписание
invisibleлюбойСкрывает поле от просмотра, продолжая собирать или вычислять его значение.
displaytitleлюбойПринудительно отображает метку/заголовок поля.
autopullselect_one, select_multipleАвтоматически загружает внешние данные для заполнения вариантов.
floating_hinttext, integer, decimalОтображает текст подсказки как плавающую метку над полем ввода.
calculate-buttoncalculateДобавляет видимую кнопку для повторного вычисления поля по требованию.

Макет

Атрибут внешнего видаТипы вопросовОписание
1screengroupПринудительно отображает всю группу на одном экране.
columns(n)select_one, select_multipleОтображает варианты в n столбцах. Пример: columns(3) показывает три столбца.
gridformat<row=R col=C colspan=S align=center>любойПозиционирует поле в CSS-сетке. Используется с advanced-extension/grid-layout.
ignore-simplifyлюбойУказывает рендереру пропустить автоматическое упрощение макета.

Виджеты

Атрибут внешнего видаТипы вопросовОписание
likertselect_oneПредставляет варианты в виде строки шкалы Лайкерта.
distressselect_oneОтображает варианты в виде виджета Шкалы психологического дистресса Кесслера (K10).

Интеграция API

Атрибут внешнего видаТипы вопросовОписание
callapitext, integer, decimal, select_oneВключает интеграцию вызова API. Столбец calculation должен содержать выражение callapi().
callapi-verify(params)text, integer, decimalИнициирует вызов верификации API со статическими параметрами.
callapi-verify(dynamicParams)text, integer, decimalТо же, что callapi-verify, но с параметрами из значений других полей.

Встроенный формат даты/времени

Для полей date, time и datetime можно задать пользовательский формат отображения:

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

Токены формата те же, что у format-date() и format-date-time().

Пример:

typenamelabelappearance
datetimeevent_timeДата и время событияinline-[%d/%m/%Y %I:%M %p]
datebirth_dateДата рожденияinline-[%d/%m/%Y]

Известные ограничения

  • Сложный внешний вид может отображаться по-разному на различных платформах.
  • Некоторые расширенные варианты внешнего вида rtSurvey могут не поддерживаться в офлайн-режиме.

Устранение проблем с внешним видом

  1. Внешний вид не применяется: Проверьте опечатки в столбце appearance.
  2. Непоследовательное отображение: Проверьте совместимость с типом вопроса и платформой.
  3. Проблемы с производительностью: Рассмотрите упрощение сложного внешнего вида, особенно для больших опросов.
Была ли эта страница полезной?