amis2/docs/zh-CN/concepts/expression.md

1.4 KiB
Executable File
Raw Blame History

title description type group menuName icon order
表达式 0 💡 概念 表达式 13

一般来说,属性名类似于xxxOn 或者 className 的配置项,都可以使用表达式进行配置,表达式具有如下的语法:

{
  "type": "tpl",
  "tpl": "当前作用域中变量 show 是 1 的时候才可以看得到我哦~",
  "visibleOn": "this.show === 1"
}

其中:this.show === 1 就是表达式。

表达式语法

表达式语法实际上是 JavaScript 代码,更多 JavaScript 知识查看 这里

表达式中不要使用${xxx}语法,这个是数据映射的语法规则,不要搞混淆了!

在 amis 的实现过程中,当正则匹配到某个组件存在xxxOn语法的属性名时,会尝试进行下面步骤(以上面配置为例):

  1. 提取visibleOn配置项配置的 JavaScript 语句this.show === 1,并以当前组件的数据域为这段代码的数据作用域,执行这段 js 代码;
  2. 之后将执行结果赋值给visible并添加到组件属性中
  3. 执行渲染。当前示例中:visible代表着是否显示当前组件;

组件不同的配置项会有不同的效果,请大家在组件文档中多留意。

表达式的执行结果预期应该是boolean类型值如果不是amis 会根据 JavaScript 的规则将结果视作boolean类型进行判断