2020-07-28 10:03:53 +08:00
|
|
|
|
---
|
|
|
|
|
title: 表达式
|
2020-08-06 15:18:45 +08:00
|
|
|
|
description:
|
2020-07-28 10:03:53 +08:00
|
|
|
|
type: 0
|
|
|
|
|
group: 💡 概念
|
|
|
|
|
menuName: 表达式
|
2020-08-06 15:18:45 +08:00
|
|
|
|
icon:
|
2020-07-28 10:03:53 +08:00
|
|
|
|
order: 13
|
|
|
|
|
---
|
2020-08-06 15:18:45 +08:00
|
|
|
|
|
2020-07-28 10:03:53 +08:00
|
|
|
|
一般来说,属性名类似于`xxxOn`的配置项,都可以使用表达式进行配置,表达式具有如下的语法:
|
|
|
|
|
|
|
|
|
|
```json
|
|
|
|
|
{
|
|
|
|
|
"type": "tpl",
|
|
|
|
|
"tpl": "当前作用域中变量 show 是 1 的时候才可以看得到我哦~",
|
2020-08-06 15:18:45 +08:00
|
|
|
|
"visibleOn": "data.show === 1"
|
2020-07-28 10:03:53 +08:00
|
|
|
|
}
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
其中:`data.show === 1` 就是表达式。
|
|
|
|
|
|
|
|
|
|
## 表达式语法
|
|
|
|
|
|
|
|
|
|
> 表达式语法实际上是 JavaScript 代码,更多 JavaScript 知识查看 [这里](https://developer.mozilla.org/zh-CN/docs/Web/JavaScript)。
|
2020-09-22 19:38:33 +08:00
|
|
|
|
>
|
|
|
|
|
> 表达式中不要使用`${xxx}`语法,这个是数据映射的语法规则,不要搞混淆了!
|
2020-07-28 10:03:53 +08:00
|
|
|
|
|
|
|
|
|
在 amis 的实现过程中,当正则匹配到某个组件存在`xxxOn`语法的属性名时,会尝试进行下面步骤(以上面配置为例):
|
|
|
|
|
|
2020-08-06 15:18:45 +08:00
|
|
|
|
1. 提取`visibleOn`配置项配置的 JavaScript 语句`data.show === 1`,并以当前组件的数据域为这段代码的数据作用域,执行这段 js 代码;
|
2020-07-28 10:03:53 +08:00
|
|
|
|
2. 之后将执行结果赋值给`visible`并添加到组件属性中
|
|
|
|
|
3. 执行渲染。当前示例中:`visible`代表着是否显示当前组件;
|
|
|
|
|
|
|
|
|
|
组件不同的配置项会有不同的效果,请大家在组件文档中多留意。
|
|
|
|
|
|
|
|
|
|
> 表达式的执行结果预期应该是`boolean`类型值,如果不是,amis 会根据 JavaScript 的规则将结果视作`boolean`类型进行判断
|