La colonna appearance in rtSurvey consente di personalizzare la presentazione visiva e il comportamento delle domande nei tuoi sondaggi. Questa funzionalità migliora l’esperienza utente e può migliorare significativamente l’efficienza della raccolta dati. rtSurvey supporta gli attributi di appearance XLSForm standard ed li estende con opzioni aggiuntive.

Attributi di appearance XLSForm standard

rtSurvey supporta i seguenti attributi di appearance XLSForm standard:

Attributo appearanceTipi di domandaDescrizione
multilinetextCrea una casella di testo multiriga (ideale per i client web)
minimalselect_one, select_multipleMostra le scelte in un menu a discesa
quickselect_oneAvanza automaticamente alla domanda successiva dopo la selezione (solo mobile)
no-calendardateSopprime la visualizzazione del calendario (solo mobile)
month-yeardateConsente la selezione solo di mese e anno
yeardateConsente la selezione solo dell’anno
horizontal-compactselect_one, select_multipleMostra le scelte orizzontalmente (solo web)
horizontalselect_one, select_multipleMostra le scelte orizzontalmente in colonne (solo web)
likertselect_onePresenta le scelte come scala Likert
compactselect_one, select_multipleMostra le scelte fianco a fianco con padding minimo
quickcompactselect_oneCombina la visualizzazione compatta con l’avanzamento automatico (solo mobile)
field-listgroupsMostra l’intero gruppo su un’unica schermata (solo mobile)
labelselect_one, select_multipleMostra le etichette delle scelte senza input
list-nolabelselect_one, select_multipleMostra gli input senza etichette (usare con label)
table-listgroupsMostra le domande in formato tabella
signatureimageAbilita l’acquisizione della firma (solo mobile)
drawimageConsente il disegno a mano libera (solo mobile)
map, quick mapselect_one, select_one_from_fileAbilita la selezione dalle feature della mappa

Best practice per l’uso di Appearance

  1. Coerenza: Usa gli attributi di appearance in modo coerente nel tuo sondaggio per un aspetto uniforme.
  2. Mobile vs. Web: Considera come le appearance vengono renderizzate su diversi dispositivi e piattaforme.
  3. Prestazioni: Sii cauto con gli attributi di appearance che potrebbero rallentare il caricamento del modulo (es. table-list per gruppi di grandi dimensioni).
  4. Esperienza utente: Scegli appearance che rendono l’inserimento dati più facile e intuitivo per i rispondenti.
  5. Test: Testa sempre il tuo modulo sui dispositivi di destinazione per assicurarti che le appearance funzionino come previsto.

Tecniche avanzate

Combinare le appearance

Alcuni attributi di appearance possono essere combinati per layout più complessi:

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

Appearance dinamiche

rtSurvey consente modifiche dinamiche dell’appearance basate sulla logica del modulo:

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

Considerazioni sull’app mobile

  • Alcune appearance (es. quick, signature) sono specifiche per i dispositivi mobili.
  • Testa approfonditamente sia su Android che su iOS per garantire un comportamento coerente.

Attributi di appearance estesi di rtSurvey

Oltre alle appearance XLSForm standard, rtSurvey supporta le seguenti opzioni specifiche per la piattaforma:

Controllo dati e visualizzazione

Attributo appearanceTipi di domandaDescrizione
invisiblequalsiasiNasconde il campo dalla vista pur raccogliendo o calcolando il suo valore. Diverso dal tipo hidden — il campo partecipa ancora alla logica.
displaytitlequalsiasiForza la visualizzazione dell’etichetta/titolo del campo anche quando sarebbe altrimenti soppressa.
autopullselect_one, select_multipleRecupera automaticamente dati esterni per popolare le scelte quando il modulo si carica o quando un campo trigger cambia.
floating_hinttext, integer, decimalMostra il testo del suggerimento come etichetta flottante sopra il campo di input invece che sotto.
calculate-buttoncalculateAggiunge un pulsante visibile che attiva il ricalcolo del campo su richiesta, piuttosto che calcolare automaticamente.

Layout

Attributo appearanceTipi di domandaDescrizione
1screengroupForza l’intero gruppo a essere visualizzato su un’unica schermata indipendentemente dalla dimensione del gruppo.
columns(n)select_one, select_multipleMostra le scelte in n colonne. Esempio: columns(3) mostra tre colonne di pulsanti radio.
gridformat<row=R col=C colspan=S align=center>qualsiasiPosiziona il campo in un layout CSS-grid alla riga R, colonna C, coprendo S colonne. Usato con advanced-extension/grid-layout.
ignore-simplifyqualsiasiIstruisce il renderer del modulo a saltare la semplificazione automatica o la condensazione del layout di questo campo.

Widget

Attributo appearanceTipi di domandaDescrizione
likertselect_onePresenta le scelte come riga della scala Likert (già nella tabella standard sopra; confermato supportato).
distressselect_oneRenderizza le scelte come widget visivo della scala di disagio psicologico di Kessler (K10) con icone emotive.

Integrazione API

Attributo appearanceTipi di domandaDescrizione
callapitext, integer, decimal, select_oneAbilita l’integrazione della chiamata API per questo campo. La colonna calculation dovrebbe contenere un’espressione callapi(). Vedi Call API.
callapi-verify(params)text, integer, decimalAttiva una chiamata di verifica API usando parametri statici. Il modulo blocca l’avanzamento finché l’API non conferma il valore.
callapi-verify(dynamicParams)text, integer, decimalCome callapi-verify ma con parametri derivati dai valori di altri campi in fase di esecuzione.

Formato data/ora inline

Per i campi date, time e datetime, puoi specificare un formato di visualizzazione personalizzato usando una stringa di formato aggiunta all’appearance:

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

I token di formato sono gli stessi di format-date() e format-date-time(). Vedi Funzioni — Funzioni data e ora.

Esempio:

typenamelabelappearance
datetimeevent_timeData e ora dell’eventoinline-[%d/%m/%Y %I:%M %p]
datebirth_dateData di nascitainline-[%d/%m/%Y]

Limitazioni note

  • Le appearance complesse potrebbero non essere renderizzate in modo identico su tutte le piattaforme.
  • Alcune appearance avanzate di rtSurvey potrebbero non essere supportate in modalità offline.

Risoluzione dei problemi di appearance

  1. Appearance non applicata: Controlla la presenza di errori di battitura nella colonna appearance.
  2. Rendering inconsistente: Verifica la compatibilità con il tipo di domanda e la piattaforma.
  3. Problemi di prestazioni: Considera la semplificazione delle appearance complesse, specialmente per sondaggi di grandi dimensioni.
Questa pagina è stata utile?