diff --git a/examples/sites/demos/pc/app/form/form-validation-composition-api.vue b/examples/sites/demos/pc/app/form/form-validation-composition-api.vue index 080e1b019..1ae83589f 100644 --- a/examples/sites/demos/pc/app/form/form-validation-composition-api.vue +++ b/examples/sites/demos/pc/app/form/form-validation-composition-api.vue @@ -4,7 +4,7 @@
validate用法:
- + diff --git a/examples/sites/demos/pc/app/form/form-validation.vue b/examples/sites/demos/pc/app/form/form-validation.vue index 995d0bf06..c7453a318 100644 --- a/examples/sites/demos/pc/app/form/form-validation.vue +++ b/examples/sites/demos/pc/app/form/form-validation.vue @@ -4,7 +4,7 @@
validate用法:
- + diff --git a/examples/sites/demos/pc/app/form/popper-options.spec.ts b/examples/sites/demos/pc/app/form/popper-options.spec.ts index 162ca3a3a..e5de074d9 100644 --- a/examples/sites/demos/pc/app/form/popper-options.spec.ts +++ b/examples/sites/demos/pc/app/form/popper-options.spec.ts @@ -13,6 +13,7 @@ test('错误提示配置', async ({ page }) => { let beforeBox = await tooltip.first().boundingBox() await page.locator('#app').click() await page.mouse.wheel(0, 2000) + await page.waitForTimeout(200) let afterBox = await tooltip.first().boundingBox() expect(afterBox?.y).toBeLessThan(beforeBox?.y || 0) }) diff --git a/examples/sites/demos/pc/app/form/webdoc/form.js b/examples/sites/demos/pc/app/form/webdoc/form.js index 3785de396..aaaef178a 100644 --- a/examples/sites/demos/pc/app/form/webdoc/form.js +++ b/examples/sites/demos/pc/app/form/webdoc/form.js @@ -730,7 +730,8 @@ interface IFormRules { message?: number // 校验错误的提示 // 内置的类型校验 type?: 'date' | 'dateTime' | 'float' | 'array' | 'string' | 'number' | 'url' | 'time' | 'email' | 'object' | 'boolean' | 'enum' - trigger?: IFormTrigger | IFormTrigger[] // 校验触发时机, 可设置成数组 ['change', 'blur'] 两种场景都触发 + // 校验触发时机, 默认为 ['change', 'blur'] 两种场景都触发,如果仅在主动调用校验方式时触发,可设置为空数组 []。 + trigger?: IFormTrigger | IFormTrigger[] // 同步检验函数,调用回调传递错误信息。 validator?: ( rule: IFormInnerRule, // from内部处理后的rule diff --git a/examples/sites/demos/pc/webdoc/form-valid-en.md b/examples/sites/demos/pc/webdoc/form-valid-en.md index 75e1ddf06..97e899ced 100644 --- a/examples/sites/demos/pc/webdoc/form-valid-en.md +++ b/examples/sites/demos/pc/webdoc/form-valid-en.md @@ -117,14 +117,20 @@ rules: { #### trigger -By`trigger`Configure the method of triggering the verification rule.`change`When the input box value changes, the verification is triggered.`blur`When the focus is lost, the calibration is triggered. The following is an example: +Configure the way to trigger the verification rules through `trigger`. When it is `change`, the verification is triggered when the input box value changes. When it is `blur`, +the verification is triggered after the input box value is out of focus. Can be set to an array `['change', 'blur']` to trigger both scenarios. The default is to trigger both scenarios. +If it is only triggered when the verification method is actively called, it can be set to an empty array `[]`. An example of usage is as follows: ```js rules: { - users: { len: 2, message: 'The length must be 2', trigger: 'change' } + users: { len: 2, message: 'The length must be 2', trigger: 'change' }, + password: { len: 2, message: 'The length must be 2', trigger: ['change', 'blur'] }, + nickname: { len: 10, message: 'Duplicate name already exists', trigger: [] } } ``` +```` + The configurable values are as follows: - `blur`: The verification is triggered after the focus is out of focus. @@ -139,7 +145,7 @@ Enumerated value validation, which verifies whether the value of the field is in rules: { role: { type: 'enum', enum: ['admin', 'user', 'guest'] } } -``` +```` #### whitespace diff --git a/examples/sites/demos/pc/webdoc/form-valid.md b/examples/sites/demos/pc/webdoc/form-valid.md index be3928a50..261329ad7 100644 --- a/examples/sites/demos/pc/webdoc/form-valid.md +++ b/examples/sites/demos/pc/webdoc/form-valid.md @@ -117,12 +117,14 @@ rules: { #### trigger -通过 `trigger` 配置触发校验规则的方式,为 `change` 时,当输入框值改变即触发校验,为 `blur` 时则失焦后触发校验。可设置成数组 `['change', 'blur']` 两种场景都触发。使用示例如下所示: +通过 `trigger` 配置触发校验规则的方式,为 `change` 时,当输入框值改变即触发校验,为 `blur` 时则失焦后触发校验。可设置成数组 `['change', 'blur']` 两种场景都触发,默认为两种场景都触发。 +如果如果仅在主动调用校验方式时触发,可设置为空数组 `[]`。使用示例如下所示: ```js rules: { users: { len: 2, message: '长度必须为2', trigger: 'change' }, password: { len: 2, message: '长度必须为2', trigger: ['change', 'blur'] }, + nickname: { len: 10, message: '已存在重复名称', trigger: [] } } ```