amis/docs/concepts/expression.md

38 lines
1.4 KiB
Markdown
Raw Normal View History

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`类型进行判断