w2grid.addSearch

addSearch([before], search)

検索項目を追加します。 戻り値はintegerです。

before: string, integer

検索項目を前に追加します。オプションです。

search: object, array

検索項目を追加します。

説明

検索項目を.searchesプロパティに追加します。 「Search」ボタンをクリックすると検索ポップアップが表示されるので、 更新は必要ありません。 第1引数のbeforeはオプションです。 指定した検索項目の前に追加します。 検索対象のフィールド名か、searchesプロパティのインデックスを指定することができます。 beforeが指定されていない場合、一番最後に追加されます。 第2引数のsearchは検索項目のオブジェクトです。

戻り値は追加した検索項目を数を返します。

グリッドを以下のように定義すると

$('#grid').w2grid({
    name    : 'grid',
    columns: [                
        { field: 'recid', caption: 'ID', size: '50px' },
        { field: 'lname', caption: 'Last Name', size: '30%', searchable: true },
        { field: 'fname', caption: 'First Name', size: '30%', searchable: true },
        { field: 'email', caption: 'Email', size: '40%', searchable: true },
        { field: 'sdate', caption: 'End Date', size: '120px' }
    ],
    records: [
        { recid: 1, fname: 'John', lname: 'doe', email: 'vitali@gmail.com', sdate: '1/3/2012' },
        { recid: 2, fname: 'Stuart', lname: 'Motzart', email: 'jdoe@gmail.com', sdate: '2/4/2012' }
    ]
});

以下のようにして範囲を広げることができます。

w2ui['grid'].addSearch({ field: 'recid', caption: 'ID', type: 'int' });

一度に複数追加する場合

w2ui['grid'].addSearch([
    { field: 'fname', caption: 'First Name', type: 'text' },
    { field: 'lname', caption: 'Last Name', type: 'text' }
]);

searchの構造は.searchesプロパティを参照してください。

デモ

「Search」ボタンをクリックすると検索項目が表示されます。 最初は"First Name"のみですが、グリッドをクリックするたびに"ID"が追加されます。

JavaScript

$('#grid').w2grid({
    name    : 'mygrid',
    show : { toolbar : true },
    columns : [
        { field: 'recid', caption: 'ID', size: '50px' },
        { field: 'lname', caption: 'Last Name', size: '30%' },
        { field: 'fname', caption: 'First Name', size: '30%' },
        { field: 'email', caption: 'Email', size: '40%' },
        { field: 'sdate', caption: 'Start Date', size: '120px' },
        { field: 'sdate', caption: 'End Date', size: '120px' }
    ],
    records: [
        { recid: 1, fname: 'John', lname: 'doe', email: 'vitali@gmail.com', sdate: '1/3/2012' },
        { recid: 2, fname: 'Stuart', lname: 'Motzart', email: 'jdoe@gmail.com', sdate: '2/4/2012' },
        { recid: 3, fname: 'Jin', lname: 'Franson', email: '--', sdate: '4/23/2012' },
        { recid: 4, fname: 'Susan', lname: 'Ottie', email: 'jdoe@gmail.com', sdate: '5/3/2012' },
        { recid: 5, fname: 'Kelly', lname: 'Silver', email: 'jdoe@gmail.com', sdate: '4/3/2012' },
        { recid: 6, fname: 'Francis', lname: 'Gatos', email: 'vitali@gmail.com', sdate: '2/5/2012' }
    ],
    searches : [
        { field: 'fname', caption: 'First Name', type: 'text' },
    ]
});
w2ui['mygrid'].on('click', function(){
  w2ui['mygrid'].addSearch({ field: 'recid', caption: 'ID', type: 'int' });
});