表达式
表达式函数是一个非可视小组件，可用于计算 JavaScript 表达式。您可以编写 JavaScript 表达式来验证、计算、转换和比较混搭中的数据。
使用参数选项为函数创建新参数。您可以设置每个参数的数据类型和默认值。函数会使用参数来存储数据值。您可以创建参数来绑定源中的数据 (例如混搭中的属性字段和数据服务)。所有参数都会在函数的“参数”部分下作为可绑定属性列出。
您可以使用“输出基本类型”选项为这些参数选择输出数据类型。数据比较表达式会返回 BOOLEAN 输出。计算或字符串操作会返回 NUMBER 或 STRING 数据类型。请确保 Output 属性的目标小组件支持输出基本类型。
表达式字段可用于定义 JavaScript 代码。您可以定义算术、比较和正则表达式。
算术表达式
• 简单表达式 - 使用简单运算符执行加法、减法、乘法和除法运算。例如：
(Parameter1 + Parameter2) / Parameter3 会返回 Parameter1 与 Parameter2 的总和除以 Parameter3 的值。
• 复杂表达式 - 使用函数来执行计算，例如指数、平方根和自然对数运算。
Math.pow(Parameter1, Parameter2) 会返回 Parameter1 的 Parameter2 次幂。
比较表达式
可以使用所有 JavaScript 比较运算符来比较输入参数的数据。
正则表达式
表达式函数支持正则表达式的 JavaScript 符号。借助正则表达式，可以使用以下语法来验证和筛选输入数据。
• /<expression>/.test(<parameter>)
◦ <expression> - 要计算的正则表达式。
◦ test() - 将指定数据参数与表达式进行比较的方法。
◦ <parameter> - 要计算的数据的参数名称。
• /^(?:\d{3}\-){2}\d{4}$/.test(phoneNumber)
◦ ^ - 字符串的开头。
◦ (?:\d{3}\-){2} - 匹配三位数字，后跟破折号，并重复两次。(###-###-)
◦ \d{4} - 匹配单个数字并重复四次。(####)
◦ $ - 字符串的结尾。
记录 JavaScript 异常
当 JavaScript 表达式返回错误时，会出现异常。您可以使用 TW.log.error 方法来记录异常。下列示例中，由于未对函数进行定义，因此会出现异常：
try {
undefinedFunction();
}
catch (e){
TW.log.error("The function does not exist: " + e);
}
undefinedFunction();
}
catch (e){
TW.log.error("The function does not exist: " + e);
}
 |
在运行时记录错误。单击顶部工具栏上的“显示/隐藏日志”可显示或隐藏 Mashup Builder 日志。
|
表达式函数选项
您可以设置以下配置选项：
• “说明”- 设置函数的说明。
• “参数”- 指定函数的自定义参数。
• “表达式”- 要计算的 JavaScript 表达式。
• “自动求值”- 当输入参数数据发生更改时，自动计算表达式。
• “遇到第一个值时触发”- 在传入第一个值时计算 JavaScript 表达式。在传入第二个值时，不会计算表达式。
• “数据更改类型”- 控制何时触发已更改的事件。
• “输出基本类型”- 表达式输出的数据类型。
创建表达式函数
1. 在“函数”面板中，单击 
。“新建函数”对话框随即打开。
。“新建函数”对话框随即打开。2. 从下拉列表中选择“表达式”。
3. 输入函数名称，然后单击“下一步”。
4. 在“表达式”下，输入要计算的 JavaScript 表达式。
5. 添加数据输入参数：
a. 单击“添加参数”。
b. 输入参数名称。
c. 输入默认值和工具提示，然后选择参数基本类型。
6. 从“输出基本类型”下拉列表中选择数据类型。
7. 单击“完成”。
函数即会添加到“表达式”类别下的“函数”面板中。
属性
表达式函数包含以下属性。
属性 | 说明 | 基本类型 | 默认值 | 是否可绑定?(Y/N) | 是否可本地化?(Y/N) |
|---|---|---|---|---|---|
Evaluate | 用于计算表达式的可绑定服务。 | 不适用 | 不适用 | Y | N |
Changed | 可绑定属性，用于在数据发生更改时触发事件。 | 不适用 | 不适用 | Y | N |
Output | 已计算表达式的输出。您可以直接在表达式字段中设置对此属性的绑定。要设置绑定，请键入 output=<> | 不适用 | 不适用 | Y | N |