jQuery EasyUI フォームプラグイン -Numberbox 数字ボックス
jQuery EasyUI プラグイン
$.fn.validatebox.defaults から拡張されています。$.fn.numberbox.defaults によりデフォルトの defaults を上書きします。
数字ボックス(numberbox)は、ユーザーが数字の値のみを入力できるようにするために使用します。入力要素を異なるタイプの入力(例:数値 numeric、パーセンテージ percentage、通貨 currency など)に変換できます。その他の入力タイプは 'formatter' と 'parser' 関数に依存して定義されます。
依存関係
- validatebox
使用法
マークアップから数字ボックス(numberbox)を作成します。
<input type="text" class="easyui-numberbox" value="100" data-options="min:0,precision:2">
JavaScript を使用して数字ボックス(numberbox)を作成します。
<input type="text" id="nn">
$('#nn').numberbox({
min:0,
precision:2
});
プロパティ
このプロパティは検証ボックス(validatebox)から拡張されたもので、以下は数字ボックス(numberbox)に追加されたプロパティです。
| 名前 | 型 | 説明 | デフォルト値 |
|---|---|---|---|
| disabled | boolean | このフィールドを無効にするかどうかを定義します。 | false |
| value | number | デフォルト値。 | |
| min | number | 許可される最小値。 | null |
| max | number | 許可される最大値。 | null |
| precision | number | 小数点以下に表示する最大精度。 | 0 |
| decimalSeparator | string | 数値の整数部と小数部を区切る区切り文字。 | . |
| groupSeparator | string | 整数のグループを区切る文字。 | |
| prefix | string | プレフィックス文字列。 | |
| suffix | string | サフィックス文字列。 | |
| filter | function(e) | 押されたキーをどのようにフィルタリングするかを定義します。true を返すと入力文字を受け入れます。このプロパティはバージョン 1.3.3 以降で使用できます。 | |
| formatter | function(value) | 数字ボックス(numberbox)の値をフォーマットする関数です。ボックスに表示する文字列値を返します。 | |
| parser | function(s) | 文字列を解析する関数です。数字ボックス(numberbox)の値を返します。 |
イベント
| 名前 | パラメータ | 説明 |
|---|---|---|
| onChange | newValue,oldValue | フィールドの値が変更されたときにトリガーされます。 |
メソッド
このメソッドは検証ボックス(validatebox)から拡張され、以下は数字ボックス(numberbox)に追加またはオーバーライドされたメソッドです。
| 名前 | パラメータ | 説明 |
|---|---|---|
| options | none | オプション(options)オブジェクトを返します。 |
| destroy | none | 数字ボックス(numberbox)オブジェクトを破棄します。 |
| disable | none | このフィールドを無効にします。 |
| enable | none | このフィールドを有効にします。 |
| fix | none | 値を有効な値に固定します。 |
| setValue | none | 数字ボックス(numberbox)の値を設定します。 コード例:
$('#nn').numberbox('setValue', 206.12);
|
| getValue | none | 数字ボックス(numberbox)の値を取得します。 コード例:
var v = $('#nn').numberbox('getValue');
alert(v);
|
| clear | none | 数字ボックス(numberbox)の値をクリアします。 |
| reset | none | 数字ボックス(numberbox)の値をリセットします。このメソッドはバージョン 1.3.2 以降で使用できます。 |
jQuery EasyUI プラグイン その他の拡張機能