验证器
“验证器”函数是可用于对 JavaScript 表达式求值的非可视小组件。您可以使用该函数来创建表达式以验证用户输入并返回 true 或 false 布尔值。例如,用户可以输入与文本字段中特定格式不匹配的数字模式。在将数字格式保存到数据表之前,您可以创建一个“验证器”函数来验证数字格式。
创建验证器函数
1. 在
“函数”面板中,单击
。
“新建函数”对话框随即打开。
2. 从下拉列表中选择“验证器”。
3. 输入函数名称,然后单击“下一步”。
4. 添加参数,然后输入要求值的 JavaScript 表达式。
5. 单击“完成”。
该函数即会添加到“函数”面板的“验证器”下。
函数选项
您可以为函数设置以下配置选项:
• “说明”- 设置函数的说明。
• “表达式”- 要计算的 JavaScript 表达式。
• “输出”- 返回已求值表达式的输出。
• “自动求值”- 当输入数据更改时自动对表达式求值。
添加参数
您必须添加输入参数才能绑定其他服务和属性中的数据。要添加参数,请执行以下操作:
1. 单击
打开函数配置对话框。
2. 单击“添加参数”按钮将其他参数添加到函数中。
◦ 输入要在表达式中使用的参数名称。
◦ 选择参数“基本类型”以指定可绑定到参数的数据类型。
3. 单击“完成”。
参数即作为可绑定属性列于函数的“参数”列表下。
使用 JavaScript 表达式
定义表达式:
您可以使用所有 JavaScript 比较运算符。对于简单的比较表达式,if() 和 else() 语句非必需项。
• 如果输入为布尔型数据,则可直接在表达式字段中输入 "input"。
• 如果输入为数字类型数据,则可直接在表达式字段中输入 "input==1"。
对表达式求值:
“验证器”函数由 Evaluate 属性触发。您可以将此属性绑定到事件,例如“按钮”小组件的 Clicked 属性。
| 启用“自动求值”选项可在输入参数更改时自动对表达式求值。 |
表达式可返回布尔型结果。您可以绑定 True 和 False 事件属性来触发混搭中的其他服务或事件,例如 Navigate、Execute 或 Refresh。
函数属性
“验证器”函数包含以下属性。
属性 | 说明 | 基本类型 | 默认值 | 是否可绑定?(Y/N) | 是否可本地化?(Y/N) |
---|
Evaluate | 用于对表达式求值的服务。 | 不适用 | 不适用 | Y | N |
Output | 验证器表达式的输出。 | 不适用 | 不适用 | Y | N |
True | 在已计算表达式为 True 时触发的事件。 | 不适用 | 不适用 | Y | N |
False | 在已计算表达式为 False 时触发的事件。 | 不适用 | 不适用 | Y | N |