jQuery EasyUI フォームプラグイン -Spinner スピナー
jQuery EasyUI プラグイン
$.fn.validatebox.defaults から拡張されています。$.fn.spinner.defaults でデフォルトの defaults を上書きします。
スピナー(spinner)は、編集可能なテキストボックスと2つの小さなボタンを組み合わせ、ユーザーが特定の範囲の値から選択できるようにします。コンボボックス(combobox)と似ていますが、スピナー(spinner)はユーザーが値を入力できるものの、ドロップダウンリストはありません。スピナー(spinner)は、数値スピナー(numberspinner)、タイムスピナー(timespinner)など、他のスピナーコンポーネントを作成するための基本コンポーネントです。
依存関係
- validatebox
使い方
スピナー(spinner)は JavaScript を使用して作成する必要があります。マークアップからの作成は許可されていません。
<input id="ss" value="2">
$('#ss').spinner({
required:true,
increment:10
});
プロパティ
このプロパティは検証ボックス(validatebox)から拡張されています。以下はスピナー(spinner)のために追加されたプロパティです。
| 名前 | 型 | 説明 | デフォルト値 |
|---|---|---|---|
| width | number | このコンポーネントの幅。 | auto |
| height | number | このコンポーネントの高さ。このプロパティはバージョン 1.3.2 から使用可能です。 | 22 |
| value | string | 初期値。 | |
| min | string | 許可される最小値。 | null |
| max | string | 許可される最大値。 | null |
| increment | number | スピナーボタンをクリックしたときの増分値。 | 1 |
| editable | boolean | ユーザーがテキストフィールドに直接値を入力できるかどうかを定義します。 | true |
| disabled | boolean | テキストフィールドを無効にするかどうかを定義します。 | false |
| spin | function(down) | ユーザーがスピナーボタンをクリックしたときに呼び出される関数。'down' パラメータは、ユーザーが下向きスピナーボタンをクリックしたかどうかを示します。 |
イベント
| 名前 | パラメータ | 説明 |
|---|---|---|
| onSpinUp | none | ユーザーが上向きスピナーボタンをクリックしたときにトリガーされます。 |
| onSpinDown | none | ユーザーが下向きスピナーボタンをクリックしたときにトリガーされます。 |
メソッド
このメソッドは検証ボックス(validatebox)から拡張されています。以下はスピナー(spinner)のために追加されたメソッドです。
| 名前 | パラメータ | 説明 |
|---|---|---|
| options | none | オプション(options)オブジェクトを返します。 |
| destroy | none | スピナー(spinner)コンポーネントを破棄します。 |
| resize | width | コンポーネントの幅をリセットします。'width' パラメータを渡すことで初期幅を上書きします。 コード例:
$('#ss').spinner('resize'); // resize with original width
$('#ss').spinner('resize', 200); // resize with new width
|
| enable | none | コンポーネントを有効にします。 |
| disable | none | コンポーネントを無効にします。 |
| getValue | none | コンポーネントの値を取得します。 |
| setValue | value | コンポーネントの値を設定します。 |
| clear | none | コンポーネントの値をクリアします。 |
| reset | none | コンポーネントの値をリセットします。このメソッドはバージョン 1.3.2 から利用可能です。 |
jQuery EasyUI プラグイン その他の拡張