排序

SpreadJS 允许您对数据透视表数据进行排序，以便您可以对其进行组织以便快速方便地进行分析。

处理大量数据时，排序特别有用。您可以使用PivotTable.sort接受对象sortInfo作为参数的函数对数据进行排序。

SpreadJS 允许用户以四种不同的方式对数据透视表数据进行排序和排序：

1. 按字段项名称排序

2. 按值排序

3. 按自定义字段项值排序

4. 按自定义回调排序

按字段项名称排序

要按字段对数据透视表数据进行排序，您可以指定字段名称并使用属性sortType并将sortInfo排序顺序设置为升序、降序或自定义。

下图演示了应用于“类别”字段的降序排序顺序。

以下代码示例显示了如何按字段项名称对数据透视表数据进行排序：

let pivotTable = spread.getActiveSheet().pivotTables.get("PivotTable");
 var sortInfo = {
  sortType: GC.Pivot.SortType.desc
 };
pivotTable.sort("Category", sortInfo);

使用设计器

您还可以通过单击字段的筛选器下拉列表中的更多排序选项...，通过设计器对数据进行排序。此选项会打开一个排序字段对话框，您可以在其中选择目标字段并将排序类型设置为升序或降序。

下图演示了如何使用设计器按字段项名称排序：

按值排序

要按字段值对数据透视表数据进行排序，您可以设置类的sortType和sortValueFieldName属性sortInfo。sortValueFieldName 属性允许您指定要作为数据排序依据的字段的名称。此功能允许您按“总计”列中的值对数据透视表数据进行排序。

下图演示了按“数量”值升序排序的“类别”字段。

以下代码示例显示如何对数据透视表应用按值排序。

let pivotTable = spread.getActiveSheet().pivotTables.get("PivotTable");
var sortInfo = {
    sortType: GC.Pivot.SortType.asc,
    sortValueFieldName: "Quantity"
 };
  pivotTable.sort("Category", sortInfo);

使用设计器

您还可以通过单击字段的筛选器下拉列表中的更多排序选项...，通过设计器对数据进行排序。此选项会打开一个排序字段对话框，您可以在其中选择目标字段并将排序类型设置为升序或降序。

下图演示了如何使用设计器按值排序：

您还可以使用值区域上下文菜单中的排序选项按值对数据透视表数据进行排序。上下文菜单提供以下三个排序选项：

• 从小到大排序

• 从大到小排序

• 更多排序选项...

前两个选项分别按升序和降序对值进行排序，而“更多排序选项...”会根据值区域打开一个对话框。

下表描述了通过以下值区域的上下文菜单访问时此选项的行为方式：

按自定义字段项目值排序

要按自定义字段项值对数据透视表数据进行排序，您可以使用对象sortByPivotReferences的属性sortInfo。

下图演示了根据OrderDate字段的Qtr1中的数据对Category字段进行升序排序。

以下代码示例显示了如何设置按自定义字段项值排序：

let pivotTable = spread.getActiveSheet().pivotTables.get("PivotTable");
 var sortInfo = {
  sortType: GC.Pivot.SortType.asc,
  sortValueFieldName: "Quantity",
  sortByPivotReferences: [
     {
        fieldName: "OrderDate",
        items: ["Qtr1"]
     }
    ]
}
pivotTable.sort("Category", sortInfo);

使用设计器

您还可以通过单击字段的过滤器下拉列表中的更多排序选项...，通过设计器对数据进行排序。此选项将打开一个排序字段对话框，您可以在其中选择目标字段的排序顺序，然后单击更多选项...按钮以打开另一个排序对话框。在此对话框中，默认情况下，GrandTotal 处于选中状态，其结果与按值排序的结果相同。要按自定义字段项值排序，请使用所选列中的值的范围选择器选择一个范围，然后单击确定。

行或列区域字段的对话框选项被禁用。例如，在这种情况下，如果您单击类别字段的更多选项...按钮，它将被禁用，因此您必须选择数量字段，然后单击更多选项...按钮。

下图演示了如何使用设计器按自定义字段项值排序：

按自定义回调排序

要使用自定义逻辑对数据透视表数据进行排序，而不是按值的升序或降序排序，您可以使用自定义回调函数。

下图演示了使用自定义回调函数对TotalSales列进行排序。

以下代码示例显示了使用自定义回调对 TotalSales 列进行排序：

let pivotTable = spread.getActiveSheet().pivotTables.get("PivotTable");
 var sortInfo = {
       sortType: GC.Pivot.SortType.desc,
       customSortCallback: (fieldItemNameArray)=>{
       alert("sorting from custom callback")
       return fieldItemNameArray.sort((a,b)=>b-a);
    }
  };
pivotTable.sort("TotalSales", sortInfo);