入力の型の設定(文字・選択・日付・数値)


この機能は Ver. 3.3.0 で追加予定の、リリース前の機能です

このページは、アルファ版(Ver. 3.3.0-alpha.1)時点の内容です。正式版までに仕様や設定項目が変わる可能性があります。本番サイトでは使わず、検証環境でお試しください。

型ごとの設定は、フィールドの設定フォームの「高度な設定」の中にあります(選択肢など型の中心になる設定は、基本の欄に出ます)。すべての型に共通する設定は「フィールドの追加と共通の設定」を参照してください。表の「config のキー」は、テーマの JSON で書くときの名前です。

テキスト・テキストエリア

型のキーは text(1 行)と textarea(複数行)です。値はそのまま キー に保存されます。

設定項目(画面)

config のキー

内容

既定値

入力例

プレースホルダー

placeholder

空の入力欄に薄く出す例です。

空

例: 東京国際フォーラム

入力欄の前に表示するテキスト

prefix

入力欄の前に出すテキストです(10 文字まで)。値には含めません。

空

¥

入力欄の後ろに表示するテキスト

suffix

入力欄の後ろに出すテキストです(10 文字まで)。値には含めません。

空

円

最大文字数

maxLength

入力欄に入力できる文字数の上限です(テキストだけ)。サーバーで確かめるには、入力チェックの「最大文字数」も付けます。

制限なし

100

項目数

rows

入力欄の行数です(テキストエリアだけ)。

ブラウザの既定

5

文字数を表示する

showCharCount

入力中の文字数を表示します。

オフ

—

目安の文字数

recommendedLength

文字数の目安です。超えると赤で表示します(保存はできます)。

空

120

入力の変換

converter

保存時に値を変換します。mb_convert_kana のオプション(フォームの :converter と同じ)を入力するか、入力補助(「英数字・記号」「スペース」「かな・カタカナ」)で選びます。

空(変換しない)

as(英数字・記号とスペースを半角にそろえる)

前後のテキストはテキストだけにあります(テキストエリアにはありません)。

{ "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 のキー

内容

既定値

入力例

選択肢

options

1 行に「値」と「表示名」を入力します。「選択肢を追加」で行を足し、つまみで並べ替えます。表示名が空なら値を出します。

なし

値 seminar、表示名 セミナー

複数選択できるようにする

multiple

セレクトボックス・チェックボックスで、複数の値を選べるようにします。

セレクトボックスはオフ、チェックボックスはオン

—

未選択のときの表示

emptyLabel

セレクトボックスの先頭の、空の選択肢に出す文字です。

空

選択してください

チェック時の値

checkedValue

チェックボックスを複数選択にしないとき(単一の on/off)に、チェックしたときに保存する値です。

on

1

型と設定

保存される値

編集画面

セレクトボックス(単一)

キー に 1 つの値

プルダウン

セレクトボックス(複数選択)

キー に複数の値

複数を選べるリスト

チェックボックス(複数選択。既定)

キー に、チェックした値を並べて保存

選択肢の数だけチェックボックス

チェックボックス(単一の on/off)

キー に「チェック時の値」。外すと空

チェックボックス 1 つ

ラジオボタン

キー に 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 のキー

内容

既定値

入力例

表示フォーマット

format

保存・表示する形です。flatpickr の書式で指定します。秒を入れるときは H:i:S にします。

日付 Y-m-d、時刻 H:i、日時 Y-m-d H:i

Y/m/d

選択できる最小日

minDate

日付だけ。これより前の日を選べなくします。

制限なし

2026-01-01

選択できる最大日

maxDate

日付だけ。これより後の日を選べなくします。

制限なし

2026-12-31

  • 保存時に、値が「表示フォーマット」で読めるかをサーバーで確かめます。

  • テンプレートで並べ替えや日付の整形をしやすくするため、フォーマットは既定の Y-m-d のままにすることを勧めます。表示の形は校正オプション [date(...)] で変えられます(テンプレートでの出力(基本の型))。

数値

型のキーは number です。値は キー に保存されます。

設定項目(画面)

config のキー

内容

既定値

入力例

プレースホルダー

placeholder

空の入力欄に薄く出す例です。

空

1000

小数部の桁数

decimals

小数部の桁数の上限です。空欄は制限なし、0 は整数だけです(上限 10)。全角の数字や 3 桁区切りは、保存時に半角の数値に直します。桁を超えた値は丸めずに入力エラーにします。

制限なし

2

入力欄の前に表示するテキスト

prefix

入力欄の前に出すテキストです(10 文字まで)。値には含めません。

空

¥

入力欄の後ろに表示するテキスト

suffix

入力欄の後ろに出すテキストです(10 文字まで)。値には含めません。

空

円

  • 保存時に、値が数値かをサーバーで確かめます。

  • 範囲は、入力チェックの「下限値」「上限値」で指定します。

  • 末尾の 0 は埋めません(1.5 は 1.5 のまま保存します)。桁をそろえて出すときは、テンプレートで [number_format(2)] を使います(1500.5 は 1,500.50)。[number_format] だけだと小数点以下は四捨五入されます(1,501)。

電話番号・メールアドレス・URL

型のキーは tel・email・url です。値は キー に保存されます。

設定項目(画面)

config のキー

内容

既定値

入力例

プレースホルダー

placeholder

空の入力欄に薄く出す例です。

空

03-1234-5678

入力欄の前に表示するテキスト

prefix

入力欄の前に出すテキストです(10 文字まで)。値には含めません。

空

¥

入力欄の後ろに表示するテキスト

suffix

入力欄の後ろに出すテキストです(10 文字まで)。値には含めません。

空

円

入力の変換

converter

保存時に値を変換します。mb_convert_kana のオプション(フォームの :converter と同じ)を入力するか、入力補助(「英数字・記号」「スペース」「かな・カタカナ」)で選びます。

空(変換しない)

as(英数字・記号とスペースを半角にそろえる)

  • メールアドレス・URL は、保存時に形式をサーバーで確かめます。

  • 電話番号は形式を確かめません。決まった形にしたいときは、入力チェックの「正規表現マッチ」か「数字チェック」を付けます。

隠し値(hidden)

型のキーは hidden です。プロフェッショナルライセンス以上で使えます。編集画面には入力欄を出さずに、値を保存します。

設定項目(画面)

config のキー

内容

既定値

入力例

初期値

defaultValue

新規のときに入る値です。テンプレートの変数は展開せず、そのまま保存します。

空

v1

  • 必須・入力チェックは設定できません。

  • 検索対象の既定はオフです。

  • 値は画面から送られるため、書き換えられる可能性があります。信頼が要る値は、プラグインの Hook extendsFieldDefinitionValue でサーバー側に決めさせます(プラグインからの拡張)。

  • フィールドグループの中には置けません。