Skip to content

Commit

Permalink
docs(array:flatten): 更新flatten属性配置说明
Browse files Browse the repository at this point in the history
  • Loading branch information
renzp94 committed May 16, 2024
1 parent 2480bc6 commit f933539
Showing 1 changed file with 8 additions and 9 deletions.
17 changes: 8 additions & 9 deletions docs/pages/array/flatten.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# flatten

扁平化数组。默认只扁平化一级,如果需要深度扁平化则可以指定`deep`参数为`true`,如果不需要全部深度扁平化,可通过`depth`来指定要扁平化的深度。如果需要扁平化对象数组,如树结构的数据可以指定`deepKey`属性来指定根据`deepKey`属性来扁平化。
扁平化数组。默认深度扁平化,如果不需要全部深度扁平化,可通过`depth`来指定要扁平化的深度。如果需要扁平化对象数组,如树结构的数据可以指定`deepKey`属性来指定根据`deepKey`属性来扁平化。

> 注意:`depth`小于等于`0`时将不进行扁平化操作
Expand All @@ -12,8 +12,8 @@
import { flatten } from '@renzp/utils'

flatten([[1], 2, [3]]); // [1, 2, 3]
flatten([[1, 2], 3, [4, [5]]], { deep: true }); // [1, 2, 3, 4, 5]
flatten([[1, 2], 3, [4, [5]]], { deep: true, depth: 1 }); // [1, 2, 3, 4, [5]]
flatten([[1, 2], 3, [4, [5]]]); // [1, 2, 3, 4, 5]
flatten([[1, 2], 3, [4, [5]]], { depth: 1 }); // [1, 2, 3, 4, [5]]
const a = flatten(
[
{
Expand All @@ -30,7 +30,7 @@ const a = flatten(
},
{ label: '1-2', value: '1-2' },
],
{ deep: true, deepKey: 'children' },
{ deepKey: 'children' },
);
console.log(JSON.stringify(a)); // [{"label":"1-1","value":"1-1"},{"label":"2-1","value":"2-1"},{"label":"3-1","value":"3-1"},{"label":"2-2","value":"2-2"},{"label":"1-2","value":"1-2"}]
```
Expand All @@ -44,11 +44,10 @@ console.log(JSON.stringify(a)); // [{"label":"1-1","value":"1-1"},{"label":"2-1"

### options

| 参数 | 说明 | 类型 | 默认值 | 是否必填 |
| ------- | ------------------------ | --------- | ------ | -------- |
| deep | 是否深度扁平化 | `boolean` | - ||
| depth | 扁平化的深度, 最小为`1` | `number` | - ||
| deepKey | 扁平化对象数组的对象属性 | `string` | - ||
| 参数 | 说明 | 类型 | 默认值 | 是否必填 |
| ------- | ------------------------ | -------------------------- | ------ | -------- |
| depth | 扁平化的深度, 最小为`1` | `Number.POSITIVE_INFINITY` | - ||
| deepKey | 扁平化对象数组的对象属性 | `string` | - ||


## 返回
Expand Down

0 comments on commit f933539

Please sign in to comment.