SearchBoxウィジェット

検索入力欄に一般的な機能を提供する拡張された<input>要素です。

オプション

delay
minimumLength

メソッド

change
count
value

イベント

オプション

delay

型: number

最後にキーを押してからchangeイベントが発火するまでの遅延時間をミリ秒で設定します。

minimumLength

型: number

入力結果がchangeイベントを発生させるテキストの最小文字数を設定します。 入力を0文字にクリアすると、この設定に関係なく常にchangeイベントが発生します。

メソッド

change( )

検索入力欄でchangeイベントを発生させます。

$(".input").searchBox('change');

count( value )

検索ボックスにカウントラベルの値を設定します。 これは検索で現在一致している「モノ」の数をユーザにフィードバックするために利用できます。 このとき、valueは文字列です。

従うべき標準的なパターンは次のとおりです。:

  • 検索ボックスが空の場合、利用可能なアイテム数を設定します。: "300"
  • 検索ボックスが空ではない場合、 一致しているアイテム数と利用可能なアイテム数を設定します。: "120 / 300"

valueがnull、undefinedまたは空白の場合、カウントフィールドは非表示になります。

$(".input").searchBox('count', '120 / 300');

value()

戻り値: String

検索入力欄の現在の値を取得します。

var type = $(".input").searchBox('value');

value( value )

検索入力欄に値を設定します。

$(".input").searchBox('value','hello');