货币输入框（CurrencyInput）组件
货币输入框组件可以来捕获用户的货币输入
 (2) (1).png)
1、数据
| 字段 | 描述 |
|---|---|
| 默认值 | 可设置一个在输入框中展示的默认值 |
| 货币 | 设置货币的类型，使用 JS 时，接受字符串 ISO 4217货币代码。 |
| 允许修改货币 | 可以设置是否启用或禁用输入旁边的货币下拉列表，可以使用它来更改所选货币。支持国家或货币的类型搜索 |
| Decimals Allowed | 设置小数分隔符（0、1 或 2）后允许的位数，使货币精准到后几位小数 |
 (2).png)
2、标签
| 字段 | 描述 |
|---|---|
| 文本 | 可设置货币输入框上方的文本 |
| 位置 | 可以设置文本与输入框的位置排序 |
 (1) (1).png)
3、校验
| 字段 | 描述 |
|---|---|
| 必填 | 设置输入框是否为必填字段。若未填写，则会提示必填字段 |
| 正则校验 | 正则表达式，它用于添加要对输入的内容执行自定义验证。 |
| 普通校验 | 设置一个表达式来决定输入的内容是否被认为是有效的。当表达式的计算结果为false时，输入被视为无效并且组件会显示错误消息。 |
| 错误信息 | 当输入的内容为无效时展示的文本 |
 (2) (1).png)
正则表达式例子：
使用 Regex 或正则表达式属性，您可以对期望的用户输入设置特定的约束。
例如，让我们添加一个正则表达式来输入 5 的倍数的价格。
.*[05]$
如果您输入的值不是 5 的倍数，小部件会显示一条错误消息“无效输入。”
 (1).png)
必填选项例子
启用 必填 属性时，必须在输入框中输入值。您还可以编写JS代码将此属性链接到操作中。
例如，让我们将勾组件checkbox1拖到画布上并将其绑定到必填的属性，需要先选中勾选组件才能对输入框输入内容，请在 必填 属性中添加以下 JavaScript 代码：
{{Checkbox1.isChecked}}
(1)(1)-853e287d590dc6da4fb8f8fc458339c2.png)
当您勾选该勾选组件时，它会启用 必填 属性，如果您没有输入任何内容，输入框会显示一条错误消息“ This field is required ”。
4、属性
| 字段 | 描述 |
|---|---|
| 提示 | 在标题文本旁边会配置一个问号，当鼠标移动至问好处时，展示提示内容 |
| 占位符 | 可以在输入框中配置提示文本 |
| 是否显示 | 控制组件在页面上的可见性。关闭时：当应用程序发布时，组件将不可见。在编辑模式下它看起来是半透明的 |
| 禁用 | 使该组件不可点击或不可用。该组件对用户保持可见，但不允许用户交互。 |
| 加载时显示动画 | 关闭时，该组件加载时不会有任何动画。您可以使用拨动开关将其打开/关闭。您还可以通过启用旁边的 JS 标签使用 javascript 将其关闭/打开。 |
| 自动聚焦 | 启用后，用户的鼠标会在页面加载时自动聚焦在输入框上。 |
 (1) (1).png)
5、事件
| 字段 | 描述 |
|---|---|
| onTextChanged | 可以配置输入框输入内容后触发相应的动作 |
| onSubmit | 可以配置用户输入完内容按回车后触发相应的动作 |
| 提交后重置 | 输入框的内容提交后清空输入框的内容 |
 (1) (1).png)
6、样式
| 字段 | 描述 |
|---|---|
| 字体颜色 | 设置货币输入框组件内文本的颜色 |
| 字体大小 | 设置货币输入框组件内文本的字体大小 |
| 强调 | 可以设置货币输入框组件内文本是加粗还是倾斜 |
| 强调色 | 设置货币输入框组件内勾选框被选中时的颜色 |
| 边框圆角 | 对货币输入框组件边框样式进行修改 |
 (1).png)
8、JS代码
 (1) (1).png)
相关属性
这些属性允许您将货币输入组件与查询或 JS 对象中的任何其他小部件绑定。这些属性帮助您在组件之间共享值，并允许您在查询或 JS 函数中访问组件属性。
| 财产 | 描述 | |
|---|---|---|
countryCode | 包含所选货币的国家代码（字符串）。 | {{currency_widget_name.Countrycode}} |
currencyCode | 包含所选货币的 __ ISO 4217代码。 | {{currency_widget_name.Currencycode}} |
| 被禁用 | 反映小部件的禁用设置( bool)的状态。 | {{currency_widget_name.isDisabled}} |
| 已验证 | 反映小部件的输入是否被视为Valid ( bool)。 | {{currency_widget_name.isValid}} |
| 可见 | 反映小部件的可见设置( bool)的状态。 | {{currency_widget_name.isVisible}} |
| 文本 | 包含小部件输入的值，表示为字符串。 | {{currency_widget_name.text}} |
| 价值 | 包含小部件输入的值，以数字表示。 | {{currency_widget_name.value}} |