Latest revision as of 06:44, 23 May 2018

Other languages:

概略

この質問タイプは、複数行のより長いテキスト入力を得ることができます。

全般オプション

回答必須

説明

このオプションにより、アンケートの質問に回答者が必ず答えるようにすることができます。回答必須の質問に回答しない場合、回答者は先に進むことができません。ある質問に複数のサブ質問があり、特定のサブ質問のみを回答必須とする場合は、ロジックタブの下にある最小回答数属性を使用します。

プレインストールされたテーマを使用している場合、必須の質問属性を有効にすると、質問の横に赤いアスタリスクが表示されます。表示したくない場合は、こちらを参照してください。

設定可能な値

オン - 参加者が次のページに進む前に質問に回答する必要があります。回答の選択肢に「回答なし」は表示されません。
ソフト - 質問に回答せずに次のページに進もうとすると警告が表示されますが、参加者は警告を無視して先に進むことができます。「回答なし」オプションは表示されます（アンケートの表示設定で有効になっている場合）。
オフ（規定値） - 質問に回答しなくてもよくなります

条件（以前の"出現条件"）

説明

条件の結果値が「1」または「true」になると、質問がアンケートの中で「関連する」、つまりアンケート参加者に提示されます。その他の場合は質問は表示されません。どのような質問でも関連式を指定することができます。この関数は条件の後継であり、より複雑な条件ロジックをサポートします。

構文ハイライト

条件を保存するたびに、検証され構文がハイライトされます。エラーにも色がつくので、すぐに気づいて直すことができます。

Hint: アンケートのすべての条件が正しく使用されているか確認するには、ロジックファイルを参照してください。

有効な値

ExpressionScriptの構文に従うすべての条件（中括弧は外す）。

例

構文ハイライトによい例があります。

（正規表現を使った）検証 (preg_validation)

説明

この設定は、質問内のすべての値の検証に使う正規表現を指定するものです。

質問やサブ質問への回答のどれかがこの検証要件に適合しない場合、テキスト入力欄の背景色が赤くなり、回答者が直すべき場所に気づきやすくなっています。回答者が送信ボタンを押さなくてもそれぞれの質問を検証することができます。

有効な値

有効な任意の正規表現

例

こちらにいくつか例があります

表示

表示行数 (display_rows)

説明

すべてのコメントをチェックするためにスクロールバーを使わずに表示する行数を指定します。設定値より多くの行がある場合、スクロールバーが表示されます。"自由回答（長い）"質問タイプの既定値は5、"自由回答（非常に長い）質問タイプ"は30です。

有効な値

0より大きい整数

TIP非表示 (hide_tip)

説明

多くの質問では、「以下からひとつだけ選択してください」のような注記（tip）や質問への回答方法を示すテキストが表示されます。この属性で、tipやヒントを表示するかしないかを設定できます。

こうしたtipやヒントには、検証基準（最小／最大回答数、最小／最大／合計値）に関するメッセージが含まれます。hide_tipをオンにすると、こうしたメッセージは表示されませんが、無効なデータを入力するとtipが表示されます。赤色で表示されますが、検証基準を満たすと緑色になります。

利用可能な設定値

オン - tipやヒント非表示
オフ（規定値）

入力ボックスの幅 (text_input_width)

説明

この属性では、テキスト入力ボックス（のラッパー）の幅を設定します。入力ボックスは（サブ）質問に対する回答のために使われます。幅の設定値が十分に大きい場合、テキスト入力ボックスは次の行に表示されます。このオプションは、入力部分のサイズや絡む全体の幅を設定するものではないことに注意してください。

設定可能な値

規定値: 選択すると、規定値はラベルと対応するテキスト入力ボックスが同じ行になるよう設定されます。例えば、テキスト入力ボックスの幅が41%の場合、テキスト入力ボックスの幅の値はラベルと入力ボックスが同じ行になる値（この場合58%）になります。テキスト入力ボックスの幅が58%以上の場合、テキスト入力ボックスは次の行に表示されます。
8%; 17%...92%, 100%: 選択値が大きくなるほどテキスト入力ボックスが大きくなります。

例

サブ質問／ラベルの下に入力部分を表示させたい場合は、ドロップダウンリストから100%を選択します。

テキスト入力ボックスのサイズ (input_box_size)

Hint: この機能は、バージョン3.0.0以降で使用できます。

説明

この機能は、テキスト領域（テキスト入力ボックス）のサイズを指定するものです。何も設定しなければ、LimeSurveyは入力ボックスを既定のサイズで表示します。この設定で既定の動作を変えることができます。

ボックスを次の行に移動させたい場合、ラッパーのサイズを大きくします。テキスト入力幅属性の値を大きくします。

有効な値

任意の数値

質問テンプレート (question_theme)

説明

それぞれの質問にカスタマイズされたテンプレートを適用することができます。

利用可能な設定

テンプレートパネルの質問テンプレートにある作成済みの質問テンプレート

参照： https://manual.limesurvey.org/Question_themes

注意: この機能は現在開発中です。

この質問をいつも隠す (hidden)

説明

オンにすると、その質問は常に表示されません。この機能は以下のような場合に使用します。

質問にURLをあらかじめ入力しておき、それを画面に表示させたくない場合。それぞれの質問がページに埋め込まれないため、アンケートで使用される条件が無効になります。
ExpressionScriptで値をその場で保存または計算したい場合。

注意: この機能で使用する一般的な質問タイプは式です。

利用可能な設定値

オン
オフ（規定値）

CSS クラス (css_class)

説明

特定の質問に特別な CSS クラスを追加するときは、この欄に CSS クラス名を入力します。クラス名を列挙するときはスペースで区切ります。

有効な値

任意の文字列と CSS クラスを区切るスペース

Hint: この欄に式を入力することもできます^{(New in 3.0.0 )}。式の結果は動的に更新されないので注意してください。

W3C によると, CSS クラス名は文字 [a-zA-Z, and 0-9] と ISO 10646 の U+00A1 以降の文字、ハイフン(-)、アンダースコア(_)のみが使えます。数字で始めたり、ハイフンの後に数字を続けることはできません。LimeSurvey は CSS クラスをエンコードしますが、完全ではありません。

入力

最大文字数 (maximum_chars)

説明

この設定はテキストベースの質問で入力できる最大文字数を指定するものです。例えば20と入力すると、アンケート参加者は20文字を超えて入力することができません。

有効な値

0より大きい任意の整数

ロジック

ランダムグループ名 (random_group)

説明

質問を特定のランダムグループに入れることにより、そのグループ内のすべての質問をランダムな順番でアンケート回答者に提示するものです。

ランダムグループ名を使用した例は、ExpressionScriptのサンプルアンケートにあります。

有効な値

任意の文字列（例:'group1'）を入力します。ランダムグループ名ボックスに同じ名前がセットされたすべての質問がアンケートの中でランダムになります（お互いにランダムに入れ替わる）。

プレビュー 質問をプレビューするには、質問グループのプレビュー機能ではなくアンケートのプレビューを使用します。前者では、質問をランダムな順序で表示できないと報告されているためです。

質問の検証式 (em_validation_q)

説明

質問全体（複数選択質問をまとめて）を検証する式です。検証条件に合致しない場合、em_validation_q_tip で設定したメッセージが表示されます（CSSスタイルは.errorとなります）。このTIPは.em_q_fn_validationというCSSスタイルが使われ、template.cssの既定では非表示となります。

本機能とサブ質問の検証式（em_validation_sq オプション）との大きな違いは、質問または質問の一部が検証エラーとなると、エラーメッセージが表示される点です。サブ質問の検証式では、それぞれのテキスト入力欄（例えば配列質問タイプにおいてですが、単一入力する質問タイプでも機能します）の背景が（薄い）赤色になります。

有効な値

ExpressionScriptの構文に従うすべての式（中括弧は外す）。

例

自由回答（短い・複数）で利用者の情報を集め、有効なメールアドレスと電話番号が入力されたか検証したいとき

この例は無効な回答がいくつかある場合にどのように見えるかを示します。

これはひとつだけ、無効な回答がある場合の見え方です。

これは、情報を入力するためにどのように質問を編集するかを示します。

これは、ロジックファイルの出力の一部で、式が正しいか、構文エラーがないかをチェックできます。

お分かりのように、検証式はメールアドレスと電話番号が空白か正規表現フィルターにマッチするかテストしています。

電話番号やメールアドレスが無効な場合、検証TIPはワーニングメッセージだけ表示します。

Hint: より複雑な検証メッセージを作成する場合は、ExpressionScriptの使用方法を参照してください。

LimeSurveyに上記の例をインポートする場合は、この.lsqファイルをダウンロードしてください。Em_validation_q_example.zip

Hint: LimeSuveyは正規表現にPerlの構文を使用しますので始めと終わりが/（スラッシュ）になります。

質問の検証式のTIP (em_validation_q_tip)

説明

質問の検証式を使用する際、質問のTIPとしてどのように入力すべきか表示するときに使います。

有効な値

任意の文字列またはExpressionScriptの構文を使用した式

例

例として、質問の検証式ウィキセクションの例を参照してください。自由回答（短い・複数）で検証エラーとなった部分でどのようにTIPが表示されるかがわかります。

サブ質問の検証式 (em_validation_sq)

説明

各々のサブ質問（テキスト）を検証するための式です。検証条件に適合しないテキスト欄はエラーであることを示すため、背景色がピンク色になります（.em_sq_fn_validation CSSスタイルを使用）。正規表現ベースの検証も可能です。

有効な値

ExpressionScriptの構文に従うすべての式（中括弧は外す）。

例

例えば、回答を3の倍数に限定する場合、式は次のようになります。

(this / 3) == floor(this/3)

予約値thisは、テキスト入力欄の入力値に自動的に置き換えられます。

サブ質問の検証式のTIP (em_validation_sq_tip)

説明

em_validation_sqを使用する際、入力した回答が正しくないときに表示されるメッセージ／TIPを設定します。

有効な値

任意の文字列

例

メールアドレスを検証する場合は、TIPは、"正しいメールアドレスを入力してください"のようになります。

その他

印刷用ビューで改ページするか (page_break)

説明

この属性は、印刷用ビューからアンケートを実際に印刷するときだけアクティブになります。質問の前で改ページします。

設定可能な値

オン
オフ（規定値）

統計

チャートの表示 (display_chart)

説明

この属性により、アンケート管理者は、アンケート参加者に対し、アンケート送信後に質問の結果を含むチャートを表示するかを選択することができます。

注意: 最後のページでグラフを表示するには、以下の設定をオンにする必要があります。

利用可能な設定値

オン
オフ（規定値）

チャートタイプ (chart_type)

説明

この属性により、アンケート管理者は、アンケート参加者に対し、アンケート送信後にどのようなチャートを表示するかを選択することができます。

注意: アンケート終了時にチャートを表示するには質問とアンケートの設定を変更する必要があります。詳細は、チャート表示属性に関するウィキセクションを参照してください。

利用可能な選択肢

棒グラフ
円グラフ
レーダー
ライン
鶏頭図
ドーナツ

タイマー

制限時間 (time_limit)

説明

質問にtime_limit属性を設定すると、質問の表示とともにカウントダウンが始まります。カウントダウンタイマーが切れると、自動的に次のページに進んだり、これ以上の入力をできないようにさせたりできます。

有効な値

任意の正の整数

例

240と入力すると、制限時間は4分（つまり240秒）となります。

Other languages:

時間切れアクション (time_limit_action)

説明

time_limit値に到達した時に起こすアクションを設定します。既定は「警告して次に進む」で、時間切れの警告メッセージが表示されたのちに、"次へ >>"ボタンが自動的に押されます。他の選択肢としては、

「警告なしに次に進む」があり、これは、"次へ >>"ボタンを警告メッセージなしに自動的に押してしまいます。
「入力不能にするのみ」では、これ以上の回答の変更ができなくなり、回答者は何もできなくなりますが、自動的に"次へ >>"が押されるのではありません。

この設定は、制限時間が設定されているときだけ有効です。

利用可能な設定値

警告して次に進む（既定値）: 回答者に時間切れの旨の警告メッセージを表示し、次に進みます
警告なしに次に進む: 時間切れになるとただちに次に進みます
入力不能にするのみ: 時間切れになると回答入力欄を編集不能にしますが、次には進みません

追加情報

Attention : 質問が必須の場合、またはグループ内の質問が必須の場合、必須の質問に回答しないとJavaScriptのループが発生することがあります。その結果、回答されていない質問がある旨のエラーが画面に表示され、ページが更新されます。
回答を空欄のままにさせないようにするため、必須質問の機能ではなく、式を使うこともできます（質問とサブ質問の検証式を参照してください）。検証式がどのように機能するかを確認するには、次の例を確認してください。

質問グループにタイマーを適用する場合は、グループごとのアンケートモードを有効にして、質問で制限時間機能を使うよう設定し、時間制限アクションとして警告と移動（既定）オプションを選択します。質問タイマーが終了すると、アンケートは次のページに移動します。

制限時間中「次へ」無効 (time_limit_disable_next)

説明

制限時間タイマーが機能している間、"次へ"ボタンを無効にします。通常は、制限時間タイマーが機能していても、アンケート参加者が"次へ"をクリックして次の質問や質問グループに進みたい場合は、"次へ"ボタンをクリックすることができます（質問または質問グループに費やす時間を短縮します）。この機能をオンにすると、"次へ"ボタンはグレーアウトし、制限時間タイマーが終了するまで使えなくなります。

この設定は、制限時間が設定されているときだけ有効です。

利用可能な設定値

オン - 制限時間タイマーが終わるまで"次へ"ボタンが無効になります。
オフ（既定値）

注意: アンケートがグループごと形式である場合、この設定はその質問が属するグループ全体に適用されます。

制限時間中「前へ」無効 (time_limit_disable_prev)

説明

制限時間タイマーが機能している間、"前へ"ボタンを無効にします。通常は、制限時間タイマーが機能していても、アンケート参加者が"前へ"をクリックして前の質問や質問グループに戻りたい場合は、"前へ"ボタンをクリックすることができます（質問または質問グループに費やす時間を短縮します）。この機能をオンにすると、"前へ"ボタンはグレーアウトし、制限時間タイマーが終了するまで使えなくなります。

この設定は、制限時間が設定されているときだけ有効です。

利用可能な設定値

オン - 制限時間タイマーが終わるまで"前へ"ボタンが無効になります。
オフ（既定値）

注意: アンケートがグループごと形式である場合、この設定はその質問が属するグループ全体に適用されます。

制限時間のカウントダウンメッセージ (time_limit_countdown_message)

説明

カウントダウンタイマーが動作中に表示されるテキストメッセージを指定します。この設定は、制限時間が設定されているときだけ有効です。なにも設定されていない場合は、既定値である「残り時間」となります。

説明

制限時間警告メッセージを表示するCSSを指定（既定のスタイルを上書き）します。指定しない場合は次の既定のスタイルが適用されます。'top: 10px; left: 35%; width: 30%; height: 60px; padding: 16px; border: 8px solid #555; background-color: white; z-index: 1001; text-align: center; overflow: auto'.

この属性に設定されたテキストは警告メッセージの既定のCSSを上書きしてしまうので、値の入力には注意が必要です。z-index値を再利用するか、z-index値を少なくともtime_limit_message_styleの設定値（既定値は1002）よりも小さい数値とすることを強く推奨します。

この設定は、制限時間が設定されているときだけ有効です。2回目の警告メッセージの設定もあります。

例

top: 10px; left: 35%; width: 30%; height: 60px; padding: 16px; border: 8px solid #555; background-color: gray; color: white; z-index: 1001; text-align: center; overflow: auto

@@ Line 69: / Line 69: @@
 =タイマー=
-{{QS:time_limit}}
+{{QS:time_limit/ja}}
-{{QS:time_limit_action}}
+{{QS:time_limit_action/ja}}
-{{QS:time_limit_disable_next}}
+{{QS:time_limit_disable_next/ja}}
-{{QS:time_limit_disable_prev}}
+{{QS:time_limit_disable_prev/ja}}
-{{QS:time_limit_countdown_message}}
+{{QS:time_limit_countdown_message/ja}}
-{{QS:time_limit_timer_style}}
+{{QS:time_limit_timer_style/ja}}
-{{QS:time_limit_message_delay}}
+{{QS:time_limit_message_delay/ja}}
-{{QS:time_limit_message}}
+{{QS:time_limit_message/ja}}
-{{QS:time_limit_message_style}}
+{{QS:time_limit_message_style/ja}}
-{{QS:time_limit_warning}}
+{{QS:time_limit_warning/ja}}
-{{QS:time_limit_warning_display_time}}
+{{QS:time_limit_warning_display_time/ja}}
-{{QS:time_limit_warning_message}}
+{{QS:time_limit_warning_message/ja}}
-{{QS:time_limit_warning_style}}
+{{QS:time_limit_warning_style/ja}}
 [[Category:Question types]][[Category:Text questions]]

Question type - Huge free text/ja: Difference between revisions

From LimeSurvey Manual

Latest revision as of 06:44, 23 May 2018

概略

全般オプション

回答必須

条件（以前の"出現条件"）

（正規表現を使った）検証 (preg_validation)

表示

表示行数 (display_rows)

TIP非表示 (hide_tip)

入力ボックスの幅 (text_input_width)

テキスト入力ボックスのサイズ (input_box_size)

質問テンプレート (question_theme)

この質問をいつも隠す (hidden)

CSS クラス (css_class)

入力

最大文字数 (maximum_chars)

ロジック

ランダムグループ名 (random_group)

質問の検証式 (em_validation_q)

質問の検証式のTIP (em_validation_q_tip)

サブ質問の検証式 (em_validation_sq)

サブ質問の検証式のTIP (em_validation_sq_tip)

その他

印刷用ビューで改ページするか (page_break)

統計

チャートの表示 (display_chart)

チャートタイプ (chart_type)

タイマー

制限時間 (time_limit)

時間切れアクション (time_limit_action)

制限時間中「次へ」無効 (time_limit_disable_next)

制限時間中「前へ」無効 (time_limit_disable_prev)

制限時間のカウントダウンメッセージ (time_limit_countdown_message)

制限時間タイマーCSS (time_limit_timer_style)

時間切れメッセージの表示秒数 (time_limit_message_delay)

時間切れメッセージ (time_limit_message)

時間切れメッセージCSS (time_limit_message_style)

制限時間警告メッセージの表示タイミング (time_limit_warning)

制限時間警告メッセージ表示時間 (time_limit_warning_display_time)

制限時間警告メッセージ (time_limit_warning_message)

制限時間警告CSS (time_limit_warning_style)