type が text または textfield は入力エリアとして使用します。
hideKey(見出し表示)
概要
カスタムフィールドのキーを見出しとして表示するかしないかを設定します。設定がない場合は表示します。
用途
同じキーで複数のデータを設定する場合、全てに表示していると、パッと見同じデータなのか違うデータなのかが判断しにくいので、2個目以降にこのオプションを使用するとすっきりします。
設定方法
表示する時 …設定不要
表示させない時 …hideKey=true
label(見出し・補足説明)
概要
カスタムフィールドの見出しまたは補足説明です。
用途
グローバル設定によって用途が若干変わります。
「カスタムフィールドのキーの代わりにラベルを使用する」がチェックオンの場合、見出しとして表示されます。チェックオフの場合は入力エリアの上に説明として表示されます。
設定方法
特にない場合 …設定不要
特にない場合 …label=任意の値 ※クウォーテーションは要りません。
size(大きさ)
概要
入力エリアの大きさです。
用途
入力するデータが長い場合は見えなくなるので設定した方がいいです。未設定の場合は20になるようです。ブラウザにもよると思いますが、20は大文字で10文字前後です。
設定方法
size=任意の値
default(初期値)
概要
入力エリアに最初から設定される値。
用途
通常はこの値を設定させたい!っという値がある場合に使用します。
設定方法
default=任意の値 ※クウォーテーションは要りません。
date(日付入力)
概要
入力エリアの右側に日付カレンダーを表示するボタンを追加します。ボタンをクリックするとカレンダーが表示され、日付をクリックすると入力エリアに日付が設定されます。
用途
日付の設定をしたい時に便利です。ただし、あくまでも入力補助なので、日付の整合性などはチェックしていません。
設定方法
date=true
ただし、このままだとカレンダーの並びが「月火水木金土日」となって日本のカレンダー「日月火水木金土」と合わなかったり、設定した時に日付の書式が外国式なので、別途オプションの設定が必要です。
dateFirstDayOfWeek(カレンダー先頭曜日)
概要
日付カレンダーの先頭の曜日を設定します。
用途
日付カレンダーを表示させる date オプションだけだとカレンダーの並びが「月火水木金土日」になっていて、日本とカレンダーと合わないので、このオプションで調整します。
設定方法
dateFirstDayOfWeek = 0
ゼロは「日曜」を意味します。
dateFormat(日付書式)
概要
日付カレンダーから選択した日付の書式を設定します。
用途
日付カレンダーを表示させる date オプションだけだとカレンダーから選択した際に日付の書式が外国式になるので、このオプションで日本式にします。
設定方法
dateFormat = yyyy/mm/dd ※クウォーテーションは要りません。
startDate(開始日付)
概要
日付カレンダーから設定できる最初の日付を設定します。
用途
範囲を決めたい場合に設定します。endDate で最後の日付を設定できます。設定がない場合、本日からになります。
設定方法
固定日付 startDate = ‘2011/01/01’
※日付は例です。クウォーテーション必須。ないとカレンダーが表示されません
本日 startDate = (new Date()).asString()
※初期値が本日なのでこの場合、明示する必要はないです。
endDate(終了日付)
概要
日付カレンダーから設定できる最後の日付を設定します。
用途
範囲を決めたい場合に設定します。startDate で最初の日付を設定できます。設定がない場合は2999/12/31まで設定できます。
設定方法
固定日付 startDate = ‘2011/01/01’
※日付は例です。クウォーテーション必須。ないとカレンダーが表示されません
本日 startDate = (new Date()).asString()
readOnly(読取専用)
概要
入力不可にしたい場合設定します。
用途
独自データを設定したいからカスタムフィールドがあるのに、それを設定させないというある意味おかしなオプションです。
おそらく、複数のカスタムフィールドテンプレートとdefaultと併用して使うのかと思います。「このテンプレートを使用する場合」といった条件分岐をさせたい場合、複数のテンプレートで同じキーを作ってそれぞれのテンプレートで違う値を初期値として設定しておけば出来るとおもいます。
その為には同じテンプレートで違うデータを設定されると困るのでこのようなオプションがあるのではないかと思います。
設定方法
readOnly = true