HTMLでは後に記述されたオブジェクトが前面に表示されます。よってコンボボックスは、メニューをオープンしたときにメニューが背面に表示されないよう記述順に配慮します。

//sample
nakatojiLib.addCntl("combo", [40, 10], [21, 120], {
	fontsize: 10,
	items: ["beef", "lamb", "chicken"],
	name: "cm2",
	placeholder: "main"            
});
nakatojiLib.addCntl("combo", [10, 10], [21, 120], {
	disabled: true,
	fontsize: 10,
	items: ["wine", "beer", "water"],
	name: "cm1",
	placeholder: "drink"
});

・セレクタ(第1引数)

「combo」を指定します。

・位置指定(第2引数)

左上の座標軸を [y, x] で指定します。

・サイズ(第3引数)

オブジェクトのサイズを [height, width] で指定します。

・オプション(第4引数)

下記参照。

 

<作成時のオプション>

作成時のオプションとして以下のプロパティを設定することができます。

・disabled

アクティブか非アクティブかの設定です。設定しない場合のデフォルト値はfalseです。

・fontsize

入力テキストのフォントサイズです。ピクセルの値で指定しますが単位はつけません。設定しない場合のデフォルト値はパレット全体に設定した値になります。

・items

補助メニューに表示するアイテムを文字列の配列で設定します。

・name

作成後に個々のUIオブジェクトをハンドリングするための名称です。ほかと重複しない固有の名称を文字列で設定します。コンボボックスの場合、ユーザーアクションに対応しなければならないので必須となります。

・placeholder

あらかじめ入力のヒントを表示する場合に設定します。この表示は入力が開始されると消滅します。

 

<プロパティを取得・変更する関数>

作成後は以下の関数を使うことができます(UIオブジェクトの設定値を取得・変更する 参照)。

・disabled() / disabled(bool)

引数を渡さない場合はアクティブ/非アクティブの現在値を取得し、true/falseの引数を渡すと現在の設定を変更することができます。

var res= nakatojiLib.ctrlDB["ddm1"].disabled(); //設定値を取得
nakatojiLib.ctrlDB["ddm1"].disabled(true); //値を設定

・items() / items(array)

引数を渡さない場合は現在の補助メニューアイテムリストを取得し、引数に文字列の配列を渡すとアイテムリストを変更することができます。

var res= nakatojiLib.ctrlDB["cm2"].items(); //アイテムリストを取得
nakatojiLib.ctrlDB["cm2"].items(["Sushi", "Tempra", "Sukiyaki"], 1); //アイテムリストを変更

 

<イベント>

なし

 

 

 

 

Joomla templates by a4joomla