31.4.9 field.eventオブジェクト

イベントの発生時にbindメソッドで登録したコールバック関数に渡されるオブジェクトです。
イベントの発生タイミングについてはbindメソッドの説明を参照してください。

渡されるオブジェクトはfieldオブジェクトを拡張したオブジェクトになります。また、スタイルごとに渡される内容は異なります。

■スタイル共通

●発生イベント

イベント名	説明
load	フィールドのロード時

●メンバ変数

メンバ変数	説明
dspemu	ユーザがインスタンスを生成したWsmgrDspemuオブジェクト

■assistスタイル

●発生イベント

イベント名	説明
change	フィールド内容変更時

●メンバ変数

メンバ変数	説明
data	フィールドの入力値

changeイベントに登録したコールバック関数で入力候補として表示する文字列を制御します。入力候補として表示する文字列は、コールバック関数の戻り値に配列として指定してください。
入力候補のサンプルは、「31.1.2 クライアントスクリプトのサンプル」の「●入力候補の表示」を参照してください。

●発生イベント

イベント名	説明
click	入力候補リスト選択時

●メンバ変数

メンバ変数	説明
data	入力候補リスト(changeイベントに登録したコールバック関数の戻り値で指定された配列)から選択した文字列
index	入力候補リストから、ユーザが選択した位置(0～)

clickイベントに登録したコールバック関数で、フィールドに入力する文字列を制御します。
フィールドに入力する文字列をコールバック関数の戻り値に指定してください。

■selectスタイル

●発生イベント

イベント名	説明
change	リストボックスのデータ変更時

●メンバ変数

メンバ変数	説明
data	bindメソッドの第三パラメータに指定した値

loadイベントに登録したコールバック関数でリストボックスに表示する文字列を初期化します。
リストボックスに表示する文字列は、以下の形式でコールバック関数の戻り値に指定してください。

形式	説明
配列	リストボックスの表示、入力値に同一データを指定します。例) 表示、入力値共に以下の配列で指定した値を指定 ["担当者1", "担当者2", "担当者3", "担当者4"]
二次元配列	リストボックスの表示、値に別の値を指定します。例)入力値、表示値に別の値を指定 [["入力値1", "表示値1"], ["入力値2", "表示値2"]]
オブジェクト	リストボックスの表示、入力値と初期選択位置を指定します。戻り値のオブジェクトに、以下のメンバ変数を指定してください。 selectedIndex: 初期選択位置(0～) data: リストボックスに表示するデータ(配列または2次元配列) 例) 初期選択位置を指定 { selectedIndex: 1, data: ["担当者1", "担当者2", "担当者3"] } ※selectedIndexに0を指定した場合は、空文字を表示します。

形式

説明

配列

リストボックスの表示、入力値に同一データを指定します。

例) 表示、入力値共に以下の配列で指定した値を指定
["担当者1", "担当者2", "担当者3", "担当者4"]

二次元配列

リストボックスの表示、値に別の値を指定します。

例)入力値、表示値に別の値を指定
[["入力値1", "表示値1"], ["入力値2", "表示値2"]]

オブジェクト

リストボックスの表示、入力値と初期選択位置を指定します。戻り値のオブジェクトに、以下のメンバ変数を指定してください。
selectedIndex: 初期選択位置(0～)
data: リストボックスに表示するデータ(配列または2次元配列)

例) 初期選択位置を指定
{ selectedIndex: 1, data: ["担当者1", "担当者2", "担当者3"] }
※selectedIndexに0を指定した場合は、空文字を表示します。

リストボックスのサンプルは、「31.1.2 クライアントスクリプトのサンプル」の「●リストボックスの表示」を参照してください。

参考

changeイベントで、リストボックスのデータを取得する例を記載します。

●JavaScriptを用いて記述した例

field.bind("change", function (e) {
    var element = e.getHtmlElement();  // HTMLエレメントの取得
    var text = element[element.selectedIndex].text; // 選択されている表示文字列を取得
    var val = element[element.selectedIndex].value; // 選択されている入力値を取得
});

■calendarスタイル

●発生イベント

イベント名	説明
click	カレンダーの日付選択時

●メンバ変数

メンバ変数	説明
value	カレンダーで選択した日付を格納
data	bindメソッドの第三パラメータに指定した値

ポイント

コールバック関数の戻り値を設定することでカレンダーの表示状態を操作できます。

戻り値	説明
true	表示中のカレンダーを閉じる
false	表示中のカレンダーを閉じない

■check、radioスタイル

●発生イベント

イベント名	説明
click	チェックボックス、ラジオボタンのクリック時

●メンバ変数

メンバ変数	説明
checked	スタイルの状態を格納選択状態：true 非選択状態：false
data	bindメソッドの第三パラメータに指定した値

メンバ変数

説明

checked

スタイルの状態を格納

選択状態：true
非選択状態：false

data

bindメソッドの第三パラメータに指定した値

■button、linkスタイル

●発生イベント

イベント名	説明
click	ボタン、リンクボタンのクリック時

●メンバ変数

メンバ変数	説明
data	bindメソッドの第三パラメータに指定した値