codewave-openclaw-installer 1.0.0

package/skills/smart-customer-service/docs/codewave/20./345/272/224/347/224/250/345/274/200/345/217/221/10./351/241/265/351/235/242/350/256/276/350/256/241/35./351/252/214/350/257/201/350/247/204/345/210/231.md

@@ -0,0 +1,788 @@
+# 验证规则
+
+验证规则是用于验证用户输入或系统数据的一种规则。它通常涉及特定的条件或标准，以确保输入满足预期的要求。验证规则可以包括对数据类型、长度、格式、唯一性、合法性等方面的检查。
+
+## 使用场景
+
+应用支持在表单项或验证器中配置验证规则，向表单项或验证器的插槽中拖拽有输入值或选中值的组件，对该组件的值进行前端验证；也支持为服务端逻辑配置验证规则。
+
+### 前端验证
+
+#### 表单验证
+
+在页面生成表单组件后，支持在表单项的属性中为当前表单项配置验证规则。
+
+![](../assets/yanzhengguize_v33_1.png)
+
+#### 验证器
+
+在页面生成验证器组件后，支持在验证器的属性中为验证器配置验证规则。
+
+![0](../assets/yanzhengguize_v33_2.png)
+
+#### 配置前端验证规则
+
+1. 点击表单项/验证器“验证规则”属性右侧的“︙“进入配置验证规则界面。
+
+    ![0](../assets/yanzhengguize_v33_3.png)
+
+2. 拖拽放置“验证规则”组件，选择需要的验证规则。
+
+    ![0](../assets/yanzhengguize_v33_4.png)
+
+验证规则可以多个叠加使用，按照执行顺序从上至下添加即可。
+
+### 服务端逻辑验证
+
+支持点击IDE右上角“更多”->"偏好设置“中开启服务端逻辑验证规则。服务端逻辑的验证规则**仅在经由网络请求调用时触发**。
+
+<img src="../assets/yanzhengguize_v33_5.png" alt="0" style="max-width:450px;" />
+
+#### 自动分析+自定义设置
+
+  当服务端逻辑验证规则的值设定为”自动分析 + 自定义设置“时，可以在以下地方看到设置验证规则交互：
+
+  * 前端逻辑（包括页面逻辑、事件逻辑等）中调用服务端逻辑，且该服务端逻辑需要填入输入参数，此时可以为输入参数设置验证规则：
+
+    <img src="../assets/yanzhengguize_v33_6.png" alt="0" style="max-width:450px;" />
+
+  * 前端逻辑（包括页面逻辑、事件逻辑等）中调用实体逻辑，此时可以为实体逻辑需要的参数设置验证规则：
+
+    <img src="../assets/yanzhengguize_v33_7.png" alt="0" style="max-width:450px;" />
+
+##### 自动分析出的验证规则
+
+平台通过追踪逻辑调用处的输入参数、参数动态绑定的表单项/验证器，最终追踪到表单项/验证器绑定的验证规则，并自动引入它们生成服务端逻辑验证规则。自动获取到的验证规则不允许删除和编辑。以下通过示例展示参考效果：
+
+1. 向页面拖拽商品实体ProductInfo选择“创建”，生成创建实体的表单和创建实体逻辑。
+
+    ![0](../assets/yanzhengguize_v33_8.gif)
+
+2. 为表单项添加验证规则。例如商品名称不能为空，商品价格不能为空且不能小于0。且验证规则开启了“同时开启服务端验证”。
+
+    ![0](../assets/yanzhengguize_v33_9.png)
+
+    ![0](../assets/yanzhengguize_v33_10.png)
+
+3. 找到创建实体逻辑，点击“设置验证规则”进入服务端逻辑验证规则界面。
+
+    ![0](../assets/yanzhengguize_v33_11.png)
+
+    ![0](../assets/yanzhengguize_v33_12.png)
+
+可以发现，实体逻辑中包含所有根据相关表单项验证规则生成的验证规则，验证对象body对应服务端逻辑的参数，传入的参数值即为productInfo。
+
+若在表单项验证规则中关闭“同时开启服务端验证“，则该验证规则在服务端验证中不生效并计入”已失效规则“。
+
+![0](../assets/yanzhengguize_v33_13.png)
+
+服务端验证规则仅在经由网络请求时调用触发，若有需要在完成表单整体校验后执行服务端逻辑，请参考示例场景[如何实现表单提交时整体校验](../../80.常见场景案例/40.组件场景/30.表单场景/040.如何实现表单提交时整体校验.md)。
+
+请注意以下一些规则：
+
+1. 每一次服务端逻辑、实体逻辑调用处设置的规则互相独立，互不干扰。
+2. 如果表单/验证器的验证规则或其提示消息内容引用了前端变量或编辑表达式，若该条规则开启服务端验证后，应用会自动分析出并被设置为失效规则。
+
+##### 自定义的验证规则
+
+点击前端逻辑（包括页面逻辑、事件逻辑等）调用的服务端逻辑中的“设置验证规则”进入服务端逻辑验证规则界面。支持在自动分析的验证规则的上方添加自定义的验证规则，用法基本与表单/验证器规则相同。
+
+请注意以下一些规则：
+
+1. 验证对象只可以选服务端逻辑的输入参数、输入参数的属性，不能选服务端变量等。
+2. 验证规则的目标值、提示消息内容只能使用常量。例如验证字符串的最大长度，长度设置只能为常量，否则该验证规则不生效。
+
+#### 自动分析
+
+当服务端逻辑验证规则的值设定为”自动分析“时，用户无法设置自定义验证规则，在逻辑调用处无法看到”设置验证规则“这一入口，但平台仍执行自动分析、自动开启一切可生效的验证规则。
+
+#### 关闭
+
+当服务端逻辑验证规则的值设定为”关闭“时，平台不会做服务端验证规则的自动分析、自动开启。
+
+## 验证规则说明
+
+### 常用规则
+
+#### email
+
+校验邮箱格式，验证值必须为正确的邮箱。
+
+#### filled
+
+必须填写验证值，并且验证值不能全为空格。
+
+#### integer
+
+验证值必须为整数。
+
+#### max
+
+验证值不得大于指定的值。当验证规则为前端验证时，参数支持编辑表达式或绑定变量。
+
+| 参数 | 参数类型           | 默认值 | 参数说明       |
+| :--- | :----------------- | :----- | :------------- |
+| max  | 数字\|字符串\|日期 | -      | 可取到的最大值 |
+
+例如在表单项中拖拽日期选择组件，参考效果如下。要求验证开始时间不能晚于结束时间。
+
+![0](../assets/yanzhengguize_v33_14.png)
+
+操作步骤：
+
+1. 创建Date类型局部变量endTime，绑定为结束时间对应的日期选择组件的“值”属性。
+
+    ![0](../assets/yanzhengguize_v33_15.png)
+
+2. 进入开始时间对应的表单项的“验证规则”，将局部变量endTime作为验证规则的参数。
+
+    ![0](../assets/yanzhengguize_v33_16.png)
+
+效果演示：
+
+  <img src="../assets/yanzhengguize_v33_17.gif" alt="0" style="max-width:450px;" />
+
+#### maxLength
+
+验证值长度不得超过指定长度；支持比较字符串长度或数组长度。当验证规则为前端验证时，参数支持编辑表达式或绑定变量。
+
+| 参数 | 参数类型 | 默认值 | 参数说明                                       |
+| :--- | :------- | :----- | :--------------------------------------------- |
+| max  | 整数     | -      | 长度不得超过指定数字；字符串、数组长度均可比较 |
+
+例如已有枚举StepEnum，枚举项存储数据如下。在表单项中生成该枚举的选择器，开启选择器的“可多选”属性，要求选中项不能超过2个。
+
+![0](../assets/yanzhengguize_v33_18.png)
+
+操作步骤：
+
+1. 向表单项拖拽枚举生成选择器，开启“可多选”属性。拖拽枚举生成的选择器包含选择项“全部”，若无需求可直接删除。
+
+    ![0](../assets/yanzhengguize_v33_19.gif)
+
+2. 进入表单项的“验证规则”，使用验证规则maxLength，参数max设为2。
+
+    ![0](../assets/yanzhengguize_v33_20.png)
+
+效果演示：
+
+<img src="../assets/yanzhengguize_v33_21.gif" alt="0" style="max-width:450px;" />
+
+#### mobile
+
+验证值必须为合法手机号。当验证规则为前端验证时，参数支持编辑表达式或绑定变量。
+
+| 参数   | 参数类型           | 默认值 | 参数说明                                                                    |
+| :----- | :----------------- | :----- | :-------------------------------------------------------------------------- |
+| strict | 布尔               | false  | 是否检验国家代号。如果为true，则必须以+和国家码开头                         |
+| locale | 字符串\|字符串数组 | -      | 所在地区，例如zh-CN,ja-JP等，可以是一个字符串或字符串数组，为空匹配所有地区 |
+
+例如在表单项中拖拽单行输入组件，要求仅支持输入中国地区或日本地区的合法手机号：
+
+![0](../assets/yanzhengguize_v33_22.png)
+
+效果演示：
+
+<img src="../assets/yanzhengguize_v33_23.gif" alt="0" style="max-width:450px;" />
+
+#### number
+
+验证值必须为数字。
+
+
+#### range
+
+验证值必须在指定范围内。当验证规则为前端验证时，参数支持编辑表达式或绑定变量。两个参数的数据类型需要保持一致。
+
+| 参数 | 参数类型           | 默认值 | 参数说明       |
+| :--- | :----------------- | :----- | :------------- |
+| max  | 数字\|字符串\|日期 | -      | 可取到的最大值 |
+| min  | 数字\|字符串\|日期 | -      | 可取到的最小值 |
+
+例如在表单项中拖拽日期选择组件，在表单验证中实现仅支持选择从当天日期算起一个月内的日期：
+
+![0](../assets/yanzhengguize_v33_26.png)
+
+效果演示：
+
+<img src="../assets/yanzhengguize_v33_27.gif" alt="0" style="max-width:450px;" />
+
+#### 正则表达式
+
+根据正则表达式判断验证值。
+
+| 参数 | 参数类型 | 默认值 | 参数说明                                                                                                                                              |
+| ---- | -------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
+| re   | Regex    | -      | 默认填入[“新建”组件](../15.逻辑功能实现/40.逻辑组件使用/20.原子项.md)并选择正则表达式，支持双击编辑正则表达式。 |
+
+例如在表单项中拖拽单行输入组件，在表单验证中使用正则表达式，双击编辑“新建”组件后输入表达式，实现仅支持输入正确的邮箱：
+
+<img src="../assets/yanzhengguize_20260204160528_1.png" class="imgStyle" style="" />
+
+<img src="../assets/yanzhengguize_20260204160528_2.png" class="imgStyle" style="" />
+
+
+效果演示：
+
+<img src="../assets/yanzhengguize_v33_25.gif" alt="0" style="max-width:450px;" />
+
+#### required
+
+必须填写验证值，但支持填入空值。空值指’ '、undefined、null。
+
+#### string
+
+验证值必须为字符串类型。
+
+#### unique
+
+验证值是否包含在参数arr数组中。若包含则提示表单项已存在，即验证不通过。通常用于判断值是否唯一，避免重复数据或覆盖原有数据。当验证规则为前端验证时，参数支持编辑表达式或绑定变量。
+
+| 参数 | 参数类型 | 默认值 | 参数说明                          |
+| :--- | :------- | :----- | :-------------------------------- |
+| arr  | List     | -      | 验证List中是否包含输入/选择内容。 |
+
+例如已有商品实体ProductInfo，实体存储数据如下。在表单项中拖拽单行输入组件，要求输入内容不能和已有商品名称重复。
+
+![0](../assets/yanzhengguize_v33_28.png)
+
+操作步骤：
+
+1. 创建如下服务端逻辑，使用数据查询组件查询出实体ProductInfo中的所有数据并赋值给输出参数result。
+
+    ![0](../assets/yanzhengguize_v33_29.png)
+
+2. 在页面逻辑下创建局部变量result，调用服务端逻辑，将查询的商品信息暂存到result中；在页面下创建List类型的局部变量productList，使用内置函数Transform将查询出商品信息的所有名称作为列表存储到productList中。注意，由于示例中的数据来源于实体，若实体中的数据有变更，建议重新为productList赋值。
+
+    ![0](../assets/yanzhengguize_v33_30.png)
+
+3. 进入表单项的“验证规则”，使用验证规则unique，参数arr为局部变量productList。
+
+    ![0](../assets/yanzhengguize_v33_31.png)
+
+效果演示：
+
+<img src="../assets/yanzhengguize_v33_32.gif" alt="0" style="max-width:450px;" />
+
+### 空值判断规则
+
+#### empty
+
+验证值必须为空，支持比较字符串或数组。
+
+#### filled
+
+必须填写验证值，并且验证值不能全为空格。
+
+#### notEmpty
+
+验证值不能为空，支持比较字符串或数组。
+
+例如在表单项中拖拽生成如下多选组，在表单验证中实现多选值不能为空：
+
+![0](../assets/yanzhengguize_v33_33.png)
+
+![0](../assets/yanzhengguize_v33_34.png)
+
+注意多选项的“选项值”不能为空，否则选中后多选值仍为空字符串或空数组。
+
+![0](../assets/yanzhengguize_v33_35.png)
+
+效果演示：
+
+<img src="../assets/yanzhengguize_v33_36.gif" alt="0" style="max-width:450px;" />
+
+#### required
+
+必须填写验证值，但支持填入空值。空值指’ '、undefined、null。
+
+### 范围判断规则
+
+#### max
+
+验证值不得大于指定的值。当验证规则为前端验证时，参数支持编辑表达式或绑定变量。
+
+| 参数 | 参数类型           | 默认值 | 参数说明       |
+| :--- | :----------------- | :----- | :------------- |
+| max  | 数字\|字符串\|日期 | -      | 可取到的最大值 |
+
+#### maxLength
+
+验证值长度不得超过指定长度；支持比较字符串长度或数组长度。当验证规则为前端验证时，参数支持编辑表达式或绑定变量。
+
+| 参数 | 参数类型 | 默认值 | 参数说明 |
+| :--- | :------- | :----- | :------- |
+| max  | 整数     | -      | 最大长度 |
+
+#### min
+
+验证值不得小于指定的值。当验证规则为前端验证时，参数支持编辑表达式或绑定变量。
+
+| 参数 | 参数类型           | 默认值 | 参数说明       |
+| :--- | :----------------- | :----- | :------------- |
+| min  | 数字\|字符串\|日期 | -      | 可取到的最小值 |
+
+#### minLength
+
+验证值长度不得少于指定长度；支持比较字符串长度或数组长度。当验证规则为前端验证时，参数支持编辑表达式或绑定变量。
+
+| 参数 | 参数类型 | 默认值 | 参数说明 |
+| :--- | :------- | :----- | :------- |
+| min  | 整数     | -      | 最小长度 |
+
+#### range
+
+验证值必须在指定范围内。当验证规则为前端验证时，参数支持编辑表达式或绑定变量。两个参数的数据类型需要保持一致。
+
+| 参数 | 参数类型           | 默认值 | 参数说明       |
+| :--- | :----------------- | :----- | :------------- |
+| max  | 数字\|字符串\|日期 | -      | 可取到的最大值 |
+| min  | 数字\|字符串\|日期 | -      | 可取到的最小值 |
+
+#### rangeLength
+
+验证值长度必须在指定范围内，支持比较字符串长度或数组长度。当验证规则为前端验证时，参数支持编辑表达式或绑定变量。
+
+| 参数 | 参数类型 | 默认值 | 参数说明 |
+| :--- | :------- | :----- | :------- |
+| max  | 整数     | -      | 最大长度 |
+| min  | 整数     | -      | 最小长度 |
+
+### 相等或包含判断规则
+
+#### confirmed
+
+验证值必须与参数value相等。专用于密码的二次确认，便于密码场景快捷使用。当验证规则为前端验证时，参数支持编辑表达式或绑定变量。
+
+例如在表单项中单行输入组件，参考效果如下。要求验证两次输入密码必须相同。
+
+![0](../assets/yanzhengguize_v33_37.png)
+
+操作步骤：
+
+1. 创建String类型局部变量password，绑定为输入密码对应的单行输入组件的“值”属性。
+
+    ![0](../assets/yanzhengguize_v33_38.png)
+
+2. 进入确认密码对应的表单项的“验证规则”，将局部变量password作为验证规则的参数。
+
+    ![0](../assets/yanzhengguize_v33_39.png)
+
+效果演示：
+
+<img src="../assets/yanzhengguize_v33_40.gif" alt="0" style="max-width:450px;" />
+
+通常情况下，密码在输入时不可见，可以在单行输入组件的“类型”属性中选择密码。
+
+#### equals
+
+验证值必须与参数arg相等，规则与confirmed一致。支持比较复杂类型。当验证规则为前端验证时，参数支持编辑表达式或绑定变量。
+
+| 参数 | 参数类型 | 默认值 | 参数说明 |
+| :--- | :------- | :----- | :------- |
+| arg  | 任意类型 | -      | 比较对象 |
+
+#### excluded
+
+验证值是否包含在参数arr数组中，验证值为单项取值。若包含则提示不能为数组中的值，即验证不通过。当验证规则为前端验证时，参数支持编辑表达式或绑定变量。
+
+| 参数 | 参数类型 | 默认值 | 参数说明              |
+| :--- | :------- | :----- | :-------------------- |
+| arr  | List     | -      | 验证不能包含arr中取值 |
+
+excluded的使用方法类似于unique，区别在于excludes规则用于排除特定值或范围，允许其他值通过验证，例如检查是否包含非法字符；unique规则侧重于验证值是否唯一。
+
+#### excludes
+
+验证值是否包含在参数arr数组中，验证值为List类型。若验证值中有任意一项包含在arr数组中则提示不能为数组中的值，即验证不通过。当验证规则为前端验证时，参数支持编辑表达式或绑定变量。
+
+| 参数 | 参数类型 | 默认值 | 参数说明              |
+| :--- | :------- | :----- | :-------------------- |
+| arr  | List     | -      | 验证不能包含arr中取值 |
+
+例如在两个表单项中拖拽生成相同的多选组，参考效果如下。要求在表单验证中实现优势选项和缺陷选项不能重复：
+
+![0](../assets/yanzhengguize_v33_41.png)
+
+![0](../assets/yanzhengguize_v33_42.png)
+
+操作步骤：
+
+1. 创建List类型局部变量chioce，绑定为优势对应的多选组组件的“选中值”属性。
+
+    ![0](../assets/yanzhengguize_v33_43.png)
+
+2. 进入缺陷对应的表单项的“验证规则”，将局部变量choice作为验证规则的参数。
+
+    ![0](../assets/yanzhengguize_v33_44.png)
+
+效果演示：
+
+<img src="../assets/yanzhengguize_v33_45.gif" alt="0" style="max-width:450px;" />
+
+#### included
+
+验证值是否包含在参数arr数组中，验证值为单项取值。若不包含则提示必须为数组中的值，即验证不通过。当验证规则为前端验证时，参数支持编辑表达式或绑定变量。
+
+| 参数 | 参数类型 | 默认值 | 参数说明              |
+| :--- | :------- | :----- | :-------------------- |
+| arr  | List     | -      | 验证必须包含arr中取值 |
+
+#### includes
+
+验证值是否包含在参数arr数组中，验证值为List类型。若验证值中有任意一项不包含在arr数组中则提示必须为数组中的值，即验证不通过。当验证规则为前端验证时，参数支持编辑表达式或绑定变量。
+
+| 参数 | 参数类型 | 默认值 | 参数说明              |
+| :--- | :------- | :----- | :-------------------- |
+| arr  | List     | -      | 验证必须包含arr中取值 |
+
+#### is
+
+验证值必须与参数arg完全相同，使用===比较，推荐用于基础类型校验。当验证规则为前端验证时，参数支持编辑表达式或绑定变量。
+
+| 参数 | 参数类型 | 默认值 | 参数说明 |
+| :--- | :------- | :----- | :------- |
+| arg  | 任意类型 | -      | 比较对象 |
+
+#### isNot
+
+验证值必须与参数arg不同，使用!==比较，推荐用于基础类型校验。当验证规则为前端验证时，参数支持编辑表达式或绑定变量。
+
+| 参数 | 参数类型 | 默认值 | 参数说明 |
+| :--- | :------- | :----- | :------- |
+| arg  | 任意类型 | -      | 比较对象 |
+
+#### noDuplicates
+
+验证项集合内不能重复。
+
+#### notEquals
+
+验证值必须与参数arg不相等，支持比较复杂类型。当验证规则为前端验证时，参数支持编辑表达式或绑定变量。
+
+| 参数 | 参数类型 | 默认值 | 参数说明 |
+| :--- | :------- | :----- | :------- |
+| arg  | 任意类型 | -      | 比较对象 |
+
+#### unique
+
+验证值是否包含在参数arr数组中。若包含则提示表单项已存在，即验证不通过。通常用于判断值是否唯一，避免重复数据或覆盖原有数据。当验证规则为前端验证时，参数支持编辑表达式或绑定变量。
+
+| 参数 | 参数类型 | 默认值 | 参数说明                            |
+| :--- | :------- | :----- | :---------------------------------- |
+| arr  | List     | -      | 验证List数组中是否包含输入/选择内容 |
+
+### 类型判断规则
+
+#### array
+
+验证值必须为数组。
+
+#### boolean
+
+验证值必须为布尔类型。
+
+#### decimal
+
+验证值必须为整数或小数。当验证规则为前端验证时，参数支持编辑表达式或绑定变量。
+
+| 参数   | 参数类型 | 默认值 | 参数说明                                                                                                                             |
+| :----- | :------- | :----- | :----------------------------------------------------------------------------------------------------------------------------------- |
+| force  | 布尔     | false  | 如果为true则只允许小数                                                                                                               |
+| digits | 字符串   | 1      | 设置小数位数范围。若参数为整数，则验证值为小数时规定唯一的小数位数；若参数为包含两个整数的数组，则验证值为小数时规定小数位数的范围。 |
+
+例如向表单项中拖拽单行输入组件，要求支持输入整数或小数，若输入小数，小数位范围在1到3之间：
+
+![0](../assets/yanzhengguize_v33_46.png)
+
+效果演示：
+
+<img src="../assets/yanzhengguize_v33_47.gif" alt="0" style="max-width:450px;" />
+
+#### function
+
+验证值必须为函数。
+
+#### integer
+
+验证值必须为整数。
+
+#### number
+
+验证值必须为数字。
+
+#### numeric
+
+验证值必须为数字。当验证规则为前端验证时，参数支持编辑表达式或绑定变量。
+
+| 参数      | 参数类型 | 默认值 | 参数说明                      |
+| :-------- | :------- | :----- | :---------------------------- |
+| noSymbols | 布尔     | -      | 为True时不能包含+，-，.等符号 |
+
+#### object
+
+验证值必须为对象。
+
+#### plainObject
+
+验证值必须为简单对象。
+
+#### string
+
+验证值必须为字符串类型。
+
+### 字母数字判断规则
+
+#### alpha
+
+验证值只能由字母组成。
+
+#### alphaDash
+
+验证值必须由字母或下划线组成。
+
+#### alphaNum
+
+验证值只能为字母或数字。
+
+#### alphaNumDash
+
+验证值必须由字母、数字或下划线组成。
+
+#### alphaSpaces
+
+验证值必须由字母或空格组成。
+
+#### lowerCase
+
+验证值不能出现大写字母。
+
+#### upperCase
+
+验证值不能出现小写字母。
+
+#### without–
+
+验证值不能连续出现中划线。
+
+#### without\_\_
+
+验证值不能连续出现下划线。
+
+### 特定场景判断规则
+
+#### ascii
+
+验证值必须为ascii字符。
+
+#### base64
+
+验证值必须为base64编码。
+
+#### byteLength
+
+验证值长度必须在指定范围内，支持比较字符串类型。当验证规则为前端验证时，参数支持编辑表达式或绑定变量。
+
+| 参数 | 参数类型 | 默认值 | 参数说明     |
+| :--- | :------- | :----- | :----------- |
+| min  | 整数     | -      | 最小字节长度 |
+| max  | 整数     | -      | 最大字节长度 |
+
+#### chinese
+
+验证值必须为合法的中文内容。
+
+#### creditCard
+
+验证值必须为合法的信用卡号。
+
+#### dataURI
+
+验证值必须为dataURI 编码。
+
+#### divisibleBy
+
+验证值必须能被参数divisor整除的数字。当验证规则为前端验证时，参数支持编辑表达式或绑定变量。
+
+| 参数    | 参数类型 | 默认值 | 参数说明                |
+| :------ | :------- | :----- | :---------------------- |
+| divisor | 整数     | -      | 输入数字能被divisor整除 |
+
+#### email
+
+校验邮箱格式，验证值必须为正确的邮箱。
+
+#### fqdn
+
+验证值必须为合法的全限定域名。
+
+#### fullWidth
+
+验证值只能由全角字符组成，如中文状态下标点符号‘’、，：；。等。
+
+#### halfWidth
+
+验证值只能由半角字符组成，如英文状态下的标点符号"\\,:;.等。
+
+#### hash
+
+验证值必须为符合algorithm哈希算法的编码，算法名称支持md4、md5、sha1、sha256、sha384、sha512、ripemd128、ripemd160、tiger128、tiger160、tiger192、crc32以及crc32b。当验证规则为前端验证时，参数支持编辑表达式或绑定变量。
+
+| 参数      | 参数类型 | 默认值 | 参数说明        |
+| :-------- | :------- | :----- | :-------------- |
+| algorithm | 字符串   | -      | 算法名称，如md5 |
+
+#### hex
+
+验证值必须是十六进制的数字。
+
+#### hexColor
+
+验证值必须是十六进制颜色码。
+
+#### ip
+
+验证值必须为正确的IP。
+
+#### ipOrFQDN
+
+验证值必须是一个合法IP或全限定域名。
+
+#### ipRange
+
+验证值必须是正确的IP段，如130.5.5.25/24。当验证规则为前端验证时，参数支持编辑表达式或绑定变量。
+
+| 参数    | 参数类型 | 默认值 | 参数说明         |
+| :------ | :------- | :----- | :--------------- |
+| version | 整数     | -      | IP版本，接受4或6 |
+
+#### isbn
+
+验证值必须是一个合法的国际标准书号（ISBN）。当验证规则为前端验证时，参数支持编辑表达式或绑定变量。
+
+| 参数    | 参数类型 | 默认值 | 参数说明             |
+| :------ | :------- | :----- | :------------------- |
+| version | 整数     | -      | ISBN版本，接受10或13 |
+
+#### isin
+
+验证值必须是一个合法的国际证券识别码（ISIN）。
+
+#### iso31661Alpha2
+
+验证值必须是一个合法的ISO-31661 Alpha-2国家代码。
+
+#### iso31661Alpha3
+
+验证值必须是一个合法的ISO-31661 Alpha-3国家代码。
+
+#### iso8601
+
+验证值必须为合法的ISO8601日期。当验证规则为前端验证时，参数支持编辑表达式或绑定变量。
+
+| 参数   | 参数类型 | 默认值 | 参数说明                                               |
+| :----- | :------- | :----- | :----------------------------------------------------- |
+| strict | 布尔     | -      | 是否检测闰年日期，如果为true，则2019-02-29属于非法日期 |
+
+#### issn
+
+验证值必须是一个合法的国际标准连续出版物号（ISSN）。
+
+#### json
+
+验证值必须可以被解析为JSON格式。
+
+#### jwt
+
+验证值必须为合法的JSON Web Token。
+
+#### latLong
+
+验证值必须合法的经纬度坐标。
+
+#### macAddress
+
+验证值必须为正确的 MAC 地址。
+
+#### md5
+
+验证值必须符合md5算法。
+
+#### mobile
+
+验证值必须为合法手机号。当验证规则为前端验证时，参数支持编辑表达式或绑定变量。
+
+| 参数   | 参数类型           | 默认值 | 参数说明                                                                    |
+| :----- | :----------------- | :----- | :-------------------------------------------------------------------------- |
+| strict | 布尔               | false  | 是否检验国家代号。如果为true，则必须以+和国家码开头                         |
+| locale | 字符串\|字符串数组 | -      | 所在地区，例如zh-CN,ja-JP等，可以是一个字符串或字符串数组，为空匹配所有地区 |
+
+#### mongoId
+
+验证值必须为合法的MongoDB对象的ID。
+
+#### port
+
+验证值必须为正确的端口。
+
+#### postalCode
+
+验证值必须为合法的邮政编码。当验证规则为前端验证时，参数支持编辑表达式或绑定变量。
+
+| 参数   | 参数类型           | 默认值 | 参数说明               |
+| :----- | :----------------- | :----- | :--------------------- |
+| locale | 字符串\|字符串集合 | CN     | 所在地区，例如CH，JP等 |
+
+#### url
+
+验证值必须为合法的URL格式，例如`http://aa.bb`。
+
+#### uuid
+
+验证值必须为合法的UUID 。当验证规则为前端验证时，参数支持编辑表达式或绑定变量。
+
+| 参数    | 参数类型 | 默认值 | 参数说明                                          |
+| :------ | :------- | :----- | :------------------------------------------------ |
+| version | 整数     | -      | 采用的UUID版本，接受3，4，5，不填默认匹配所有版本 |
+
+### 正则判断规则
+
+#### 正则表达式
+
+根据正则表达式判断验证值。
+
+| 参数 | 参数类型 | 默认值 | 参数说明                                                                                                                                              |
+| ---- | -------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
+| re   | Regex    | -      | 默认填入[“新建”组件](../15.逻辑功能实现/40.逻辑组件使用/20.原子项.md)并选择正则表达式，支持双击编辑正则表达式。 |
+
+### 调用自定义验证规则
+
+用户可自主编写自定义逻辑作为校验依据，可以是服务端逻辑或页面逻辑，逻辑的输出结果需要为Boolean 类型或 ValidateError 类型。
+
+该验证规则当前支持为Vue3表单项添加。
+
+**验证时机说明**
+
+调用自定义验证逻辑时，支持为该验证规则单独自定义验证时机。默认触发时机为表单提交阶段，用户可根据实际需求，自主选择是否叠加 “值改变时验证”“失焦时验证” 的触发条件。
+
+**操作说明**
+
+验证规则中包含变量validateValue，其值来源于当前组件需要被校验的数据状态。在编写自定义验证逻辑时，这个变量常被用作逻辑函数的输入参数，使开发者能够基于组件的实际数据值来构建灵活的判断条件（如比较、格式匹配等）。
+
+<img src="../assets/yanzheng_202511211506_1.png" class="imgStyle" style="" />
+
+<div style="text-align: right;font-size: 14px;">
+    <span style="color: rgb(78, 110, 142);">创建人：</span>
+    <span style="color: rgb(118, 118, 118);">有鲤</span>
+    <span style="color: rgb(78, 110, 142);margin: 0 0 0 40px;">更新时间：</span>
+    <span style="color: rgb(118, 118, 118);">2026年02月04日</span>
+</div>
+
+<style>
+  h4 {
+    font-size: 18px;
+  }
+  h5 {
+    font-size: 16px;
+  }
+</style>