Theme color Gray color Appearance SizeSmall(1) Medium(2) Large(3) Radius Scale90% 95% 100% 105% 110%
none
small
medium
large
full
通过validator
可自定义校验器,校验器返回自定义校验信息,其格式可以为:
export type ValidatorStatusResult = { status?: Status; message: string };
export type ValidatorResult = string | string[] | ValidatorStatusResult | ValidatorStatusResult[] | undefined | null;
export type Validator = (value: any, data: any, rule: Rule) => MaybePromise<ValidatorResult>;
校验信息可以指定其状态(与主题status
相同,包括:success
, warning
, error
, info
),通过visibleStatuses
可以指定表单项展示哪些状态的信息,默认为 error
;若校验信息为字符串,或者其为包含 message 的对象,但没有指定 status,则默认状态为 error
。
默认只展示错误信息,只有错误状态的信息会校验失败,而通过调整相关属性可以额外展示一些信息,如下示例
表单项有三种提示信息:help, tip, statusMessages,前两种由同名属性自行设置,statusMessages 由校验获得。help 侧重于展示帮助信息,tip 侧重于展示提示信息,当存在校验信息时则会覆盖它。它们支持多种形式展示:
tooltip
: 在输入框以 Tooltip 的形式展示,展示的优先级 statusMessages > help > tipnewLine
: 在输入框下方以新行的方式展示,help 总会展示,优先级 statusMessages > tipicon
: 在标签处以 Icon 加 Tooltip 的形式展示提示信息由以下属性控制它们的展示形式:
tipType
控制 tip 和 statusMessages 的展示形式,支持tooltip
和newLine
helpType
控制 help 的展示形式,支持icon
, tooltip
和newLine
默认情况下,表单项卸载后 Form 仍会保留其值,通过unmountBehavior
可设置表单项卸载后的行为,可为:
delete
: 卸载后删除值toNull
: 卸载后值设置为null
toUndefined
: 卸载后值设置为undefined