入力の型の設定(文字・選択・日付・数値)
この機能は Ver. 3.3.0 で追加予定の、リリース前の機能です
このページは、アルファ版(Ver. 3.3.0-alpha.1)時点の内容です。正式版までに仕様や設定項目が変わる可能性があります。本番サイトでは使わず、検証環境でお試しください。
型ごとの設定は、フィールドの設定フォームの「高度な設定」の中にあります(選択肢など型の中心になる設定は、基本の欄に出ます)。すべての型に共通する設定は「フィールドの追加と共通の設定」を参照してください。表の「config のキー」は、テーマの JSON で書くときの名前です。
テキスト・テキストエリア
型のキーは text(1 行)と textarea(複数行)です。値はそのまま キー に保存されます。
設定項目(画面) | config のキー | 内容 | 既定値 | 入力例 |
|---|---|---|---|---|
プレースホルダー |
| 空の入力欄に薄く出す例です。 | 空 |
|
入力欄の前に表示するテキスト |
| 入力欄の前に出すテキストです(10 文字まで)。値には含めません。 | 空 |
|
入力欄の後ろに表示するテキスト |
| 入力欄の後ろに出すテキストです(10 文字まで)。値には含めません。 | 空 |
|
最大文字数 |
| 入力欄に入力できる文字数の上限です(テキストだけ)。サーバーで確かめるには、入力チェックの「最大文字数」も付けます。 | 制限なし |
|
項目数 |
| 入力欄の行数です(テキストエリアだけ)。 | ブラウザの既定 |
|
文字数を表示する |
| 入力中の文字数を表示します。 | オフ | — |
目安の文字数 |
| 文字数の目安です。超えると赤で表示します(保存はできます)。 | 空 |
|
入力の変換 |
| 保存時に値を変換します。mb_convert_kana のオプション(フォームの | 空(変換しない) |
|
前後のテキストはテキストだけにあります(テキストエリアにはありません)。
{ "key": "cf_summary", "label": "概要文", "type": "textarea",
"config": { "rows": 4, "showCharCount": true, "recommendedLength": 120 },
"validation": { "required": "none", "rules": [{ "method": "maxlength", "arg": "200" }] } }セレクトボックス・チェックボックス・ラジオボタン
型のキーは select・checkbox・radio です。保存されるのは選んだ選択肢の「値」で、表示名は保存しません。
設定項目(画面) | config のキー | 内容 | 既定値 | 入力例 |
|---|---|---|---|---|
選択肢 |
| 1 行に「値」と「表示名」を入力します。「選択肢を追加」で行を足し、つまみで並べ替えます。表示名が空なら値を出します。 | なし | 値 |
複数選択できるようにする |
| セレクトボックス・チェックボックスで、複数の値を選べるようにします。 | セレクトボックスはオフ、チェックボックスはオン | — |
未選択のときの表示 |
| セレクトボックスの先頭の、空の選択肢に出す文字です。 | 空 |
|
チェック時の値 |
| チェックボックスを複数選択にしないとき(単一の on/off)に、チェックしたときに保存する値です。 |
|
|
型と設定 | 保存される値 | 編集画面 |
|---|---|---|
セレクトボックス(単一) |
| プルダウン |
セレクトボックス(複数選択) |
| 複数を選べるリスト |
チェックボックス(複数選択。既定) |
| 選択肢の数だけチェックボックス |
チェックボックス(単一の on/off) |
| チェックボックス 1 つ |
ラジオボタン |
| 選択肢の数だけラジオボタン |
ラジオボタンの最初の選択は、共通の設定「初期値」に選択肢の値を入れて指定します。
保存時に、値が選択肢にあるかをサーバーで確かめます。選択肢を後から減らしても、保存済みの値は消えずに残り、編集画面に「選択肢に無い値」と表示されます。
複数の値を持つ型(複数選択のチェックボックス・セレクトボックス)は、フィールドグループの中に置けません。
{ "key": "cf_features", "label": "特徴", "type": "checkbox",
"config": { "options": [ { "value": "parking", "label": "駐車場あり" }, { "value": "wifi", "label": "Wi-Fi あり" } ] },
"validation": { "required": "none", "rules": [{ "method": "all_maxChecked", "arg": "2" }] } }日付・時刻・日時
型のキーは date・time・datetime です。カレンダー(flatpickr)で選び、「表示フォーマット」の形の文字列で保存します。
設定項目(画面) | config のキー | 内容 | 既定値 | 入力例 |
|---|---|---|---|---|
表示フォーマット |
| 保存・表示する形です。flatpickr の書式で指定します。秒を入れるときは | 日付 |
|
選択できる最小日 |
| 日付だけ。これより前の日を選べなくします。 | 制限なし |
|
選択できる最大日 |
| 日付だけ。これより後の日を選べなくします。 | 制限なし |
|
保存時に、値が「表示フォーマット」で読めるかをサーバーで確かめます。
テンプレートで並べ替えや日付の整形をしやすくするため、フォーマットは既定の
Y-m-dのままにすることを勧めます。表示の形は校正オプション[date(...)]で変えられます(テンプレートでの出力(基本の型))。
数値
型のキーは number です。値は キー に保存されます。
設定項目(画面) | config のキー | 内容 | 既定値 | 入力例 |
|---|---|---|---|---|
プレースホルダー |
| 空の入力欄に薄く出す例です。 | 空 |
|
小数部の桁数 |
| 小数部の桁数の上限です。空欄は制限なし、0 は整数だけです(上限 10)。全角の数字や 3 桁区切りは、保存時に半角の数値に直します。桁を超えた値は丸めずに入力エラーにします。 | 制限なし |
|
入力欄の前に表示するテキスト |
| 入力欄の前に出すテキストです(10 文字まで)。値には含めません。 | 空 |
|
入力欄の後ろに表示するテキスト |
| 入力欄の後ろに出すテキストです(10 文字まで)。値には含めません。 | 空 |
|
保存時に、値が数値かをサーバーで確かめます。
範囲は、入力チェックの「下限値」「上限値」で指定します。
末尾の 0 は埋めません(
1.5は1.5のまま保存します)。桁をそろえて出すときは、テンプレートで[number_format(2)]を使います(1500.5は1,500.50)。[number_format]だけだと小数点以下は四捨五入されます(1,501)。
電話番号・メールアドレス・URL
型のキーは tel・email・url です。値は キー に保存されます。
設定項目(画面) | config のキー | 内容 | 既定値 | 入力例 |
|---|---|---|---|---|
プレースホルダー |
| 空の入力欄に薄く出す例です。 | 空 |
|
入力欄の前に表示するテキスト |
| 入力欄の前に出すテキストです(10 文字まで)。値には含めません。 | 空 |
|
入力欄の後ろに表示するテキスト |
| 入力欄の後ろに出すテキストです(10 文字まで)。値には含めません。 | 空 |
|
入力の変換 |
| 保存時に値を変換します。mb_convert_kana のオプション(フォームの | 空(変換しない) |
|
メールアドレス・URL は、保存時に形式をサーバーで確かめます。
電話番号は形式を確かめません。決まった形にしたいときは、入力チェックの「正規表現マッチ」か「数字チェック」を付けます。
隠し値(hidden)
型のキーは hidden です。プロフェッショナルライセンス以上で使えます。編集画面には入力欄を出さずに、値を保存します。
設定項目(画面) | config のキー | 内容 | 既定値 | 入力例 |
|---|---|---|---|---|
初期値 |
| 新規のときに入る値です。テンプレートの変数は展開せず、そのまま保存します。 | 空 |
|
必須・入力チェックは設定できません。
検索対象の既定はオフです。
値は画面から送られるため、書き換えられる可能性があります。信頼が要る値は、プラグインの Hook
extendsFieldDefinitionValueでサーバー側に決めさせます(プラグインからの拡張)。フィールドグループの中には置けません。