FORM.FREE
種別: オブジェクト

書式:
$FORM.FREE$

解説
 投稿フォームの自由定義項目の入力欄を表示するためのオブジェクトです。自由定義項目とは、予め掲示板のデータ項目として用意されていないデータ項目を作成するためのもので、用途に応じてテキストボックス、プルダウンリスト、ラジオボタンから形式を選択することができます。
このオブジェクトFORMブロックまたはSUBFORMブロック内に記述します。他のブロックに記述してもオブジェクトとして扱われません。

保有プロパティ
FORM.FREE.type / FORM.FREE.width / FORM.FREE.label / FORM.FREE.value


Property #1
FORM.FREE.type
種別: プロパティ

書式:
FORM.FREE.type = "○"
○:自由定義項目の入力欄タイプ (データ型:定義済値)

解説
 FORM.FREEで置き換えられる入力部品の種類を指定するためのプロパティです。値には"text", "url", "select", "radio"のいずれかを指定することができ、値の大文字・小文字は区別されます。
値に"url"が指定された場合、フォームの初期値には"http://"が設定され、"http://"だけの投稿は何も入力されていなかったものとして扱われます。

指定可能な値と意味
text url select radio
意味 テキストボックス テキストボックス (URL) プルダウンメニュー ラジオボタン

Property #2
FORM.FREE.width
種別: プロパティ

書式:
FORM.FREE.width = "○"
○:自由定期項目の入力欄の幅 (データ型:数値)

解説
 FORM.FREE.typeで値に"text"または"url"が指定された場合の、テキストボックスの横幅を定義するプロパティです。値には数値を文字数で指定します。


Property #3
FORM.FREE.label
種別: プロパティ

書式:
FORM.FREE.label = "○;○;○・・・"
○:自由定義項目の表示ラベル (データ型:文字列)

解説
 FORM.FREE.typeで値に"select"または"radio"が指定された場合の、選択肢の表示ラベルを定義するプロパティです。値には複数の文字列をセミコロン(;)で区切って指定します。値にセミコロン(;)を含めたい場合はエスケープを使用します。
無料掲示板では、このプロパティの値は10個まで指定することができます。


Property #4
FORM.FREE.value
種別: プロパティ

書式:
FORM.FREE.value = "○;○;○・・・"
○:自由定義項目の値 (データ型:文字列)

解説
 FORM.FREE.typeで値に"select"または"radio"が指定された場合の、選択肢の値を定義するプロパティです。値には複数の文字列をセミコロン(;)で区切って指定します。値にセミコロン(;)を含めたい場合はエスケープを使用します。
もしFORM.FREE.type"select"が指定されていて、値に#から始まる色コードが指定されている場合、色選択欄として認識されて値が背景色として使用されます。値に色コードではなく、"white", "black"の様な色名が指定されていると、色選択欄としては認識されません。
無料掲示板では、このプロパティの値は10個まで指定することができます。


Example
! テキストボックス
FORM.FREE.type = "text"
FORM.FREE.width = "30"
    ↓↓↓


! テキストボックス (URL)
FORM.FREE.type = "url"
FORM.FREE.width = "50"
    ↓↓↓


! プルダウンメニュー
FORM.FREE.type = "select"
FORM.FREE.label = "RED;BLUE;GREEN"
FORM.FREE.value = "#FF0000;#0000FF;#009900"
    ↓↓↓


! ラジオボタン
FORM.FREE.type = "radio"
FORM.FREE.label = "赤;青;緑"
FORM.FREE.value = "#FF0000;#0000FF;#009900"
    ↓↓↓