Revision as of 06:43, 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)

説明

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

Time limit timer CSS style (time_limit_timer_style)

Description

It allows (and overrides the default) css styling used to display the countdown timer. The default style value for this attribute will be used if it does not exist, which is: 'width: 150px; margin-left: auto; margin-right: auto; border: 1px solid #111; text-align: center; background-color: #EEE; margin-bottom: 5px; font-size: 8pt;'.

Any text entered into this attribute will overwrite the entire default css style, so you should ensure that care is taken when entering a value for this attribute. A simple way to hide this is to copy the default style into this attribute and add 'display: none;' to the end.

This settings is only applicable if the general time limit setting is activated.

Time limit expiry message display time (time_limit_message_delay)

Description

This attribute sets how many seconds the time_limit_message is displayed before the time_limit_action occurs. If this attribute is not set, it defaults to a value of 1 (1 second).

This settings is only applicable if the general time limit settings is activated.

Example

time_limit_message_delay: 5 = the message displays for 5 seconds

Time limit expiry message (time_limit_message)

Description

This is the text of the message that appears to the participant when the time_limit has expired. By default, this message is "Your time to answer this question has expired". If the time_limit_action attribute is set to "Move on without warning" this message is not displayed. You can set the CSS style for this text in the time_limit_message_style attribute (see below).

This settings is only applicable if the general time limit settings is activated.

Example

time_limit_message: The time limit on answering this question is now up.

Time limit message CSS style (time_limit_message_style)

Description

It allows (and overrides the default) css styling used to display the time limit message. The default style value for this attribute will be used if it does not exist, which is: 'top: 10px; left: 35%; width: 30%; height: 60px; padding: 16px; border: 8px solid #555; background-color: white; z-index: 1002; text-align: center; overflow: auto'.

Any text entered into this attribute will overwrite the entire default css style, so you should ensure that care is taken when entering a value for this attribute. It is strongly recommended that you re-use the z-index value, or that, at least, the z-index value is higher than that used for the time_limit_warning_message_style attribute (which defaults to 1001).

Example

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

Time limit warning message timer (time_limit_warning)

Description

With the help of this attribute, you can set the time (in seconds) when the time_limit_warning_message will be displayed before the time limit expires. Setting a value for this attribute activates the time limit warning message.

This settings is only applicable if the general time limit settings is activated. This setting also exists for a second warning message.

Example

If you set this to '20', then the time limit warning message will appear 20 seconds before the time limit countdown reaches zero.

Time limit warning message display time (time_limit_warning_display_time)

Description

It sets for how long the time_limit_warning_message is displayed before it is removed/hidden from the screen. By default, if the time_limit_warning_message appears, it will remain visible until the countdown timer has completed the countdown. If a value greater than zero is introduced in this field, the message will be hidden after that many seconds.

This setting is applicable only if the general time limit setting is activated. This setting also exists for a second warning message.

Example

time_limit_warning_display_time: 10 = The time limit warning message will disappear 10 seconds after its moment of appearance.

Time limit warning message (time_limit_warning_message)

Description

If set up, it displays the text of the warning message which is displayed for a fixed period of time before a time limit expires. The default text is "Your time to answer this question has nearly expired. You have {TIME} remaining." {TIME} is replaced by a formatted description which represents the amount of time left (i.e. "30 seconds", "1 minute or 5 seconds"). This message only appears if the time_limit_warning attribute exists. You can set from the time_limit_warning attribute when the message (time_limit_warning_message) appears.

This question attribute is only applicable if the time limit setting is activated and you set some text in the time limit warning message field. This setting also exists for a second warning message.

Example

Attention: In {TIME} the time limit to answer question will expire.

Time limit warning CSS style (time_limit_warning_style)

Description

It allows (and overrides the default) css styling used to display the time limit warning message. The default style value for this attribute will be used if it does not exist, which is: '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'.

Any text entered into this attribute will overwrite the entire default css style for the warning message, so you should ensure that care is taken when entering a value for this attribute. It is strongly recommended that you re-use the z-index value, or that, at least, the z-index value be lower than that used for the time_limit_message_style attribute (which defaults to 1002).

This settings is only applicable if the general time limit setting is activated. This setting also exists for a second warning message.

Example

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 77: / Line 77: @@
 {{QS:time_limit_disable_prev/ja}}
-{{QS:time_limit_countdown_message}}
+{{QS:time_limit_countdown_message/ja}}
 {{QS:time_limit_timer_style}}

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

From LimeSurvey Manual

Revision as of 06:43, 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)

Time limit timer CSS style (time_limit_timer_style)

Time limit expiry message display time (time_limit_message_delay)

Time limit expiry message (time_limit_message)

Time limit message CSS style (time_limit_message_style)

Time limit warning message timer (time_limit_warning)

Time limit warning message display time (time_limit_warning_display_time)

Time limit warning message (time_limit_warning_message)

Time limit warning CSS style (time_limit_warning_style)