w2grid.columnGroups

カラムグループの配列を定義します。

Array, default = []

カラムのグループ化を設定することができます。 ランタイム時に.columnGroupsプロパティを変更した場合、w2utils.refresh()メソッドを使ってグリッドを更新する必要があります。

オブジェクト作成時に指定する場合

$('#grid').w2grid({
    name : 'grid',
    columnGroups : [
        { span: 1, caption: '', master: true },
        { span: 2, caption: 'Name' },
        { span: 1, caption: '', master: true },
        { span: 2, caption: 'Dates' }
    ],
    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' }
    ]
});

または、w2gridオブジェクト生成後に指定します。

w2ui['grid'].columnGroups = [
    { span: 1, caption: '', master: true },
    { span: 2, caption: 'Name' },
    { span: 1, caption: '', master: true },
    { span: 2, caption: 'Dates' }
];
w2ui['grid'].refresh();

カラムグループの構造は以下の通りです。

columnGroups = {
    span    : 1,     // number of columns to span
    caption : '',    // caption of the group
    master  : false  // indicates if column group header is merged with column header
}

デモ

「Last Name」と「First Name」、「Start Date」と「End Date」をそれぞれグループ化しています。

JavaScript

$('#grid').w2grid({
    name    : 'mygrid',
    columnGroups : [
        { span: 1, caption: '', master: true },
        { span: 2, caption: 'Name' },
        { span: 1, caption: '', master: true },
        { span: 2, caption: 'Dates' }
    ],
    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' }
    ],
});