rtSurveyのappearance列は調査の質問の視覚的な表示と動作をカスタマイズできます。この機能はユーザーエクスペリエンスを向上させ、データ収集効率を大幅に改善できます。rtSurveyは標準的なXLSForm外観属性をサポートし、追加オプションで拡張しています。

標準XLSForm外観属性

rtSurveyは以下の標準XLSForm外観属性をサポートしています：

外観属性質問タイプ説明
multilinetext複数行のテキストボックスを作成する（Webクライアントに最適）
minimalselect_one、select_multipleドロップダウンメニューに選択肢を表示する
quickselect_one選択後に次の質問に自動進む（モバイルのみ）
no-calendardateカレンダー表示を非表示にする（モバイルのみ）
month-yeardate月と年のみの選択を許可する
yeardate年のみの選択を許可する
horizontal-compactselect_one、select_multiple選択肢を水平に表示する（Webのみ）
horizontalselect_one、select_multiple選択肢を列で水平に表示する（Webのみ）
likertselect_one選択肢をリッカートスケールとして表示する
compactselect_one、select_multiple最小パディングで選択肢を並べて表示する
quickcompactselect_oneコンパクト表示と自動進行を組み合わせる（モバイルのみ）
field-listgroupsグループ全体を1画面に表示する（モバイルのみ）
labelselect_one、select_multiple入力なしで選択肢のラベルを表示する
list-nolabelselect_one、select_multipleラベルなしで入力を表示する（labelと一緒に使用）
table-listgroups質問をテーブル形式で表示する
signatureimage署名キャプチャを有効にする（モバイルのみ）
drawimageフリーハンド描画を許可する（モバイルのみ）
map、quick mapselect_one、select_one_from_file地図からの選択を有効にする

外観使用のベストプラクティス

  1. 一貫性：調査全体で外観属性を一貫して使用する。
  2. モバイルとWeb：異なるデバイスとプラットフォームでの表示を考慮する。
  3. パフォーマンス：フォームの読み込みを遅くする可能性のある外観属性（例：大きなグループのtable-list）に注意する。
  4. ユーザーエクスペリエンス：回答者のデータ入力をより簡単で直感的にする外観を選択する。
  5. テスト：外観が期待通りに機能することを確認するために、ターゲットデバイスで常にフォームをテストする。

高度なテクニック

外観の組み合わせ

一部の外観属性はより複雑なレイアウトのために組み合わせることができます：

  | type | name | label | appearance |
|------|------|-------|------------|
| select_one options | choice | 1つ選択してください： | minimal compact |

動的外観

rtSurveyはフォームロジックに基づいた動的な外観変更を許可します：

  | type | name | label | appearance | relevant |
|------|------|-------|------------|----------|
| text | time | 時間を入力してください： | inline-[%H:%M] | ${show_time} = 'yes' |

モバイルアプリの考慮事項

  • 一部の外観（例：quick、signature）はモバイルデバイス固有です。
  • 一貫した動作を確認するためにAndroidとiOSの両方で徹底的にテストする。

rtSurvey拡張外観属性

標準のXLSForm外観に加えて、rtSurveyは以下のプラットフォーム固有のオプションをサポートしています：

データと表示の制御

外観属性質問タイプ説明
invisibleanyフィールドを非表示にしながらも値の収集または計算を続ける。hiddenタイプとは異なり、フィールドはロジックに参加し続ける。
displaytitleany通常は抑制される場合でもフィールドのラベル/タイトルを強制的に表示する。
autopullselect_one、select_multipleフォームが読み込まれるかトリガーフィールドが変わるときに外部データを自動取得して選択肢を入力する。
floating_hinttext、integer、decimalヒントテキストを入力フィールドの下ではなく上のフローティングラベルとして表示する。
calculate-buttoncalculate自動計算ではなく、オンデマンドでフィールドの再計算をトリガーする可視ボタンを追加する。

レイアウト

外観属性質問タイプ説明
1screengroupグループサイズに関わらずグループ全体を1画面に強制表示する。
columns(n)select_one、select_multiple選択肢をn列で表示する。例：columns(3)は3列のラジオボタンを表示する。
gridformat<row=R col=C colspan=S align=center>anyCSSグリッドレイアウトで行R、列C、S列スパンにフィールドを配置する。advanced-extension/grid-layoutと一緒に使用する。
ignore-simplifyanyフォームレンダラーにこのフィールドのレイアウトの自動簡略化や縮小をスキップするよう指示する。

ウィジェット

外観属性質問タイプ説明
likertselect_one選択肢をリッカートスケール行として表示する。
distressselect_one感情的なアイコンを持つKessler心理的苦痛スケール（K10）ビジュアルウィジェットとして選択肢をレンダリングする。

API統合

外観属性質問タイプ説明
callapitext、integer、decimal、select_oneこのフィールドのAPI呼び出し統合を有効にする。calculationカラムにはcallapi()式を含める必要がある。Call APIを参照。
callapi-verify(params)text、integer、decimal静的パラメーターを使ってAPI検証呼び出しをトリガーする。APIが値を確認するまでフォームの進行をブロックする。
callapi-verify(dynamicParams)text、integer、decimalcallapi-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. 外観が適用されない：外観列のタイポを確認する。
  2. 一貫性のないレンダリング：質問タイプとプラットフォームとの互換性を確認する。
  3. パフォーマンスの問題：複雑な外観を簡略化することを検討する（特に大規模な調査の場合）。
このページは役に立ちましたか？