多层级数据排序

# 多层级数据排序

表格支持按照多个字段进行层级排序,即在上一层级排序的基础上,对相同值的数据进行下一层级的排序。常用于具有明确层级关系的数据展示,如省市区地址、组织架构等。

# 基础用法

通过配置 sortProps 数组会将值相同的数据集合在一起 ,后续可以指定参数ordersortMethod配置数据的具体排序。数组中的字段顺序决定了排序的优先级。

# 排序配置

对象数组:为每个字段指定详细的排序规则

options: {
  sortProps: [
    "province",
    { prop: "city", order: "desc", nullsPosition: "first" },
    "amount",
  ],
},

# 自定义排序规则

通过配置 sortMethod 来自定义排序逻辑。

options: {
  sortProps: [
    "province",
    "city",
    { prop: "amount", sortMethod: (a, b) => b.amount - a.amount },
  ],
},

# API

# Options 配置

参数 说明 类型 默认值
sortProps 排序字段数组(按优先级排序) string[] []

# 排序参数

参数 说明 类型 默认值
prop 排序字段名称 string -
order 排序方向 'asc' / 'desc'
nullsPosition 空值位置 'first' / 'last' 'last'
sortMethod 自定义排序方法 Function(a, b) -

# Methods 方法

方法名 说明 参数 返回值
sortedData 排序方法,默认使用 sortProps 配置并排序所有数据 (data, props) -