スニペット"FormLister"：フォームやメールで使用するプレースホルダー
プレースホルダーは[+フィールド名+]で使用します。
使用可能な箇所は、HTMLとして出力するパラメーターやメールのパラメーターで使用することができます。
FormListerスニペットで使用するプレースホルダーは次のことができます。
| 構文 | 簡易説明 |
|---|---|
| [+フィールド名.value+] または [+フィールド名+] |
フィールドの入力した値を返す |
| [+c.フィールド名.値+] | チェックボックスやラジオボタンなどチェック状態を制御 |
| [+s.フィールド名.値+] | セレクトボックスなど選択状態を制御 |
| [+フィールド名.error+] | フィールドのエラーメッセージを返す |
| [+フィールド名.requiredСlass+] | 必須エラー時のクラス名を返す |
| [+フィールド名.errorClass+] | 必須以外のエラー時のクラス名を返す |
| [+フィールド名.class+] | エラー時のクラス名をまとめて属性含めて返す |
| [+form.messages+] [+messages+] |
フォーム全体のエラー時のメッセージを返す |
| [+attachments.value+] | 添付したファイルのファイル名を返す |
| [+activate.url+] | 有効化（アクティベート）するためのURL |
また、プレースホルダーはモディファイアを使用することもできます。
- ※ モディファイアを使用するときは.value部分は必要ありません。
フィールドの入力した値を返す
フィールドの入力した値を返す場合は、[+フィールド名.value+]または[+フィールド名+]を使用します。
初期値や既定値も返します。
セレクトボックスなど選択状態を制御
チェックボックスやラジオボタンなどチェック状態を制御する場合は、[+c.フィールド名.値+]を使用します。
このプレースホルダーの書き方をすることでチェックしたものはchecked属性が付与されます。
- ※ 値に半角スペースなどが含んでいてもそのまま指定して問題ありません。
なお、チェック状態を制御するには、&formControlsパラメーターを指定する必要があります。
参考ページ：制御するフィールドの指定
チェックボックスやラジオボタンなどチェック状態を制御
セレクトボックスなど選択状態を制御する場合は、[+s.フィールド名.値+]を使用します。
このプレースホルダーの書き方をすることで選択したものはselected属性が付与されます。
- ※ 値に半角スペースなどが含んでいてもそのまま指定して問題ありません。
なお、選択状態を制御するには、&formControlsパラメーターを指定する必要があります。
参考ページ：制御するフィールドの指定
フィールドのエラーメッセージを返す
フィールドのエラーが発生した時にメッセージを表示するには、[+フィールド名.error+]を使用します。
必須エラー時のクラス名を返す
フィールドの必須のエラーが発生した時にクラス名を得るには、[+フィールド名.requiredСlass+]を使用します。
- ※ class属性は返しません。
- ※ 返すクラス名は最初の文字列に半角スペース付きで返します（初期値の場合）。
必須以外のエラー時のクラス名を返す
フィールドの必須以外のエラーが発生した時にクラス名を得るには、[+フィールド名.errorClass+]を使用します。
- ※ class属性は返しません。
- ※ 返すクラス名は最初の文字列に半角スペース付きで返します（初期値の場合）。
エラー時のクラス名をまとめて属性含めて返す
フィールドのエラーが発生した時にクラスを付与するには、[+フィールド名.class+]を使用します。
class属性ごと返します。
- ※ 返す属性の最初の文字列に半角スペースは入りません。
フォーム全体のエラー時のメッセージを返す
フォーム全体のエラーが発生した時にメッセージを表示するには、[+form.messages+]と[+messages+]を使用します。
[+form.messages+]は&messagesOuterTplパラメーターの値を返し、[+messages+]は&messagesOuterTplパラメーター内で全体のエラー時のメッセージを返すために指定します。
添付したファイルのファイル名を返す
添付したファイルのファイル名を表示するには、[+attachments.value+]を使用します。
有効化（アクティベート）するためのURL
有効化（アクティベート）するためのURLを出力するには、[+activate.url+]を使用します。
&controller=`Activate`のフォームでのみ有効のプレースホルダーです。