Колоната 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. Мобилни срещу уеб: Помислете как изгледите ще се рендерират на различни устройства и платформи.
  3. Производителност: Бъдете предпазливи с атрибутите за изглед, които могат да забавят зареждането на формуляра (например table-list за големи групи).
  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всякаквиСкрива полето от изгледа, като все още събира или изчислява стойността му. Различно от типа hidden — полето все още участва в логиката.
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-мрежово оформление на ред R, колона C, обхващайки S колони. Използва се с advanced-extension/grid-layout.
ignore-simplifyвсякаквиИнструктира рендерера на формуляра да пропусне автоматичното опростяване или уплътняване на оформлението на това поле.

Уиджети

Атрибут за изгледТипове въпросиОписание
likertselect_oneПредставя опциите като ред от скала Ликерт (вече в стандартната таблица; потвърден за поддръжка).
distressselect_oneРендерира опциите като визуален уиджет на Скалата за психологически дистрес на Kessler (K10) с емоционални икони.

API интеграция

Атрибут за изгледТипове въпросиОписание
callapitext, integer, decimal, select_oneАктивира интеграция на API извикване за това поле. Колоната calculation трябва да съдържа израз callapi(). Вижте Извикване на API.
callapi-verify(params)text, integer, decimalЗадейства извикване на API за верификация, използвайки статични параметри. Формулярът блокира напредъка, докато API потвърди стойността.
callapi-verify(dynamicParams)text, integer, decimalСъщото като callapi-verify, но с параметри, производни от стойностите на другите полета по времe на изпълнение.

Вграден формат за дата/час

За полета 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. Проблеми с производителността: Помислете за опростяване на сложните изгледи, особено за большие анкети.
Беше ли полезна тази страница?