跳到主要内容

数组#

本参考文档列出了内置便捷函数，用于在表达式中支持数组数据转换。

表达式中的 JavaScript

您可以在表达式中使用任何 JavaScript。更多信息请参阅表达式。

average(): 数值 #​

返回数组中元素的平均值

chunk(size: 数值): 数组 #​

将数组分割成指定长度的块

函数参数#​

size必需数值

每个块的大小。

compact(): 数组 #​

移除数组中的空值。

difference(arr: 数组): 数组 #​

比较两个数组。返回基准数组中不存在于对比数组的所有元素。

函数参数#​

arr必需数组

要与基准数组进行比较的数组。

intersection(arr: 数组): 数组 #​

比较两个数组。返回基准数组中同时存在于对比数组的所有元素。

函数参数#​

arr必需数组

要与基准数组进行比较的数组。

first(): 数组项 #​

返回数组的第一个元素。

isEmpty(): 布尔值 #​

检查数组是否不包含任何元素。

isNotEmpty(): 布尔值 #​

检查数组是否包含元素。

last(): 数组项 #​

返回数组的最后一个元素。

max(): 数值 #​

返回数组中的最大值。

merge(arr: 数组): 数组 #​

通过合并每个元素的键值对，将两个对象数组合并为一个数组。

函数参数#​

arr必需数组

要合并到基准数组中的数组。

min(): 数值 #​

从纯数字数组中获取最小值。

pluck(fieldName?: 字符串): 数组 #​

返回键名等于指定字段名的对象数组。

函数参数#​

fieldName可选字符串

要检索的键名。可以输入任意数量的键名，以逗号分隔的字符串形式提供。

randomItem(): 数组项 #​

从数组中返回随机元素。

removeDuplicates(key?: 字符串): 数组 #​

移除数组中的重复项。

函数参数#​

key可选字符串

用于检查重复项的键名，或以逗号分隔的键名列表。

renameKeys(from: 字符串, to: 字符串): 数组 #​

重命名数组中所有匹配的键。可以通过按旧键名,新键名的模式输入一系列逗号分隔的字符串来重命名多个键。

函数参数#​

from必需字符串

要重命名的键。

to必需字符串

新的名称。

smartJoin(keyField: 字符串, nameField: 字符串): 数组 #​

操作包含键值对的对象数组。创建包含键值对的新对象，其中键是第一对的值，值是第二对的值。在合并前会移除不匹配和空值，并修剪所有空白字符。

函数参数#​

keyField必需字符串

要连接的键。

nameField必需字符串

要连接的值。

示例​

基础用法​
// Input 
{{ [{"type":"fruit", "name":"apple"},{"type":"vegetable", "name":"carrot"} ].smartJoin("type","name") }} 
// Output 
[Object: {"fruit":"apple","vegetable":"carrot"}]

sum(): 数值 #​

返回可解析数值数组中所有值的总和。

toJsonString(): 字符串 #​

将数组转换为 JSON 字符串。等同于 JSON.stringify。

union(arr: 数组): 数组 #​

连接两个数组并移除重复项。

函数参数#​

arr必填数组
需要与基础数组进行比较的数组。

unique(key?: 字符串): 数组 #​

移除数组中的重复项。

函数参数#​

key可选字符串
用于检查重复项的键名或逗号分隔的键名列表。