text質問タイプは自由テキスト回答（任意の文字列）を収集します。最も柔軟な入力タイプであり、名前、住所、説明、コード、その他の特定のタイプに合わないあらゆるものに使用されます。

rtSurveyはtextを時刻入力ウィジェットでも拡張しており、クロックピッカーによる正確な時刻入力が可能です。

基本XLSForm仕様

typenamelabel
textrespondent_name回答者のフルネーム
textaddress自宅住所

標準XLSFormのtextタイプの詳細については、XLSForm仕様を参照してください。

用途

テキスト質問は以下に使用されます：

  1. 名前、住所、自由な説明
  2. 自由回答のコメントやフィードバック
  3. integer/decimalに適さないコード、ID、参照番号
  4. rtSurveyの時刻入力拡張を使った時刻値の収集
  5. オートコンプリートテキストフィールド（search-autocomplete-noedit-v2()経由）

標準外観オプション

外観説明
(なし)単一行テキスト入力
multiline複数行テキストエリア — Webでの長いテキストに最適

rtSurvey時刻入力拡張

rtSurveyは時刻値を収集するためのクロックピッカーウィジェットでtextを拡張します。これらの外観オプションは、調査員が時、分、秒、またはミリ秒を選択するためにタップできるクロックアイコンを表示します。

外観バリアント

外観説明
inlineフィールドの横にクロックアイコンを表示
inline colors("RRGGBB")カスタム16進カラーのクロックアイコン
inline-1lineコンパクトな1行形式でクロックを表示
inline-1line-RRGGBBカスタムアイコンカラー付きの1行形式（16進、#なし）
inline-1line colors("RRGGBB","RRGGBB")2色付きの1行形式
inline-onlyresult選択後にクロックアイコンが消える；値のみ表示
inline-onlyresult colors("RRGGBB")カスタムアイコンカラー付きの同上

時刻フォーマットトークン

表示する時刻コンポーネントを制御するには、ブラケット内にフォーマット文字列を追加します：

フォーマット文字列表示
inline-[%H:%M]時と分（24時間制）
inline-[%h:%M]時と分（12時間制）
inline-[%H:%M:%S]時、分、秒（24時間制）
inline-[%h:%M:%S]時、分、秒（12時間制）
inline-[%H:%M:%3]時、分、ミリ秒
inline-[%M:%S]分と秒のみ
inline-[%M:%3]分とミリ秒のみ
inline-[%S]秒のみ
inline-[%3]ミリ秒のみ
inline-[%H]時のみ（24時間制）
inline-[%h]時のみ（12時間制）

例：タスク所要時間を分と秒で記録する

typenamelabelappearance
texttask_durationタスク完了にかかった時間inline-[%M:%S]

例：カスタムカラーで24時間形式のイベント時刻を記録する

typenamelabelappearance
textevent_timeイベントの時刻inline-1line colors("0099FF")

データ形式

テキストデータはプレーン文字列として保存およびエクスポートされます。インラインクロックウィジェットを使用した時刻ベースの入力の場合、値は選択したフォーマット文字列に一致する形式で保存されます（例：%H:%Mの場合は14:32）。

制約と検証

書式、長さ、またはパターンを強制するための制約を適用します：

typenamelabelconstraintconstraint_message
textnameフルネームstring-length(.) >= 2名前は2文字以上でなければなりません
textcode参照コードregex(., '^[A-Z]{2}[0-9]{4}$')大文字2文字の後に4桁の数字を入力してください
textphone電話番号regex(., '^[0-9]{9,15}$')有効な電話番号を入力してください

ベストプラクティス

  1. データに既知の構造がある場合は、より特定のタイプ（integer、decimal、date）を使用してください — これにより無効な入力を防ぎ、分析が簡単になります。
  2. コードやIDを検証するにはstring-length()またはregex()を使ったconstraintを追加してください。
  3. 回答者が数文を書く可能性がある自由回答質問にはmultiline外観を使用してください。
  4. 時刻収集の場合、分析に必要な精度に合った時刻フォーマットトークンを選択してください — 分しか必要ないのにミリ秒を収集するのは調査員の労力の無駄です。

プラットフォームサポート

textの質問タイプとすべての時刻入力外観は、iOS、Android、Webプラットフォームでサポートされています。

制限事項

  • テキスト回答は自由形式です — regexパターン以外の組み込みスペルチェックや語彙制約はありません。
  • インライン時刻ウィジェットはrtSurveyの拡張機能であり、標準XLSForm仕様の一部ではありません。
このページは役に立ちましたか？