w2grid.request

request(cmd, [params, [url, [callBack]]])

サーバへリクエストを送信します。 戻り値はundefinedです。

cmd: string

コマンド名。

params: object

サーバに送信する追加パラメータ。オプションです。

url: string

リクエストURL。オプションです。

callBack: function

コールバック関数。オプションです。

説明

.urlプロパティで指定されたサーバに対して、cmdを付加して、リクエストを送信します。 この関数は内部的に使用されますが、グリッド生成後はいつでも使用することができます。

第1引数のcmdは下記^*1を指定することができます。

• get
• delete
• save

*1 公式ではget-records、delete-records、save-recordsとなっていますが、これはver1.4での指定です。

第2引数のparamsは、サーバに送信する追加パラメータです。 .request()メソッドは.searchData、.sortData、.postDataを必ず送信します。これらのプロパティを再度指定する必要はありません。
第3引数のurlは、.urlプロパティとは違う別のリクエスト送信先URLを指定する場合に指定します。
この関数は.onRequestイベントを発生させます。

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

$('#grid').w2grid({
    name    : 'grid',
    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' }
    ]
});

以下のように指定します。

w2ui['grid'].request('save');

デモ

キーを押す度に、"save"リクエストが送信されます。

JavaScript

$('#grid').w2grid({
    name    : 'mygrid',
    url     : '../json/data.json',
    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' }
    ],
    onRequest: function(event) {
        console.log('-- server call --');
        console.log(event);
    }
});
w2ui['mygrid'].on('keydown', function(event) {
    w2ui['mygrid'].request('save');
});