jQWidgets jqxGrid insertgroup() 方法

概述

jQWidgets jqxGrid是一款功能强大的JavaScript表格插件，具有分页、排序、过滤、分组等多种功能。其中insertgroup()方法是用于在数据中插入新的分组行。

语法

$("#grid").jqxGrid('insertgroup', datafield, type, groupval, callback);

• datafield：要分组的数据字段名称，字符串类型。必须与数据源中的字段名称相同。
• type：分组类型。可选值有“int”、 “float”、 “string”、 “date”和 “bool”。
• groupval：分组值，支持一维数组和函数两种数据类型。如果是一个数组，则表示要分的组的值；如果是一个函数，则需要返回一个字符串表示分组的值。
• callback：回调函数，当插入分组行后调用。可选参数。

示例

插入一个常量分组行

var datafield = "CustomerName";
$("#jqxgrid").jqxGrid('insertgroup', datafield, 'string', 'USA', null);

以上示例会在表格中的CustomerName列下插入一个新的“USA”分组行。

插入一个函数分组行

var datafield = "OrderDate";
var groupedValues = ["Q1 2020", "Q2 2020", "Q3 2020", "Q4 2020"];
var groupvalfunction = function (value) {
    var d = new Date(value);
    var quarter = Math.floor((d.getMonth() + 3) / 3);
    var year = d.getFullYear();
    return "Q" + quarter + " " + year;
};
$("#jqxgrid").jqxGrid('insertgroup', datafield, 'date', groupvalfunction, null);

以上示例会在表格中的OrderDate列下插入四个分组行，分别为“Q1 2020”、“Q2 2020”、“Q3 2020”、“Q4 2020”。其中分组值是通过groupvalfunction()函数计算得出的。

参考文献

jQWidgets jqxGrid insertgroup() documentation