Skip to content

提交时忽略部分字段 ​

在 FormCreate 中,可以通过全局配置和规则配置来设置在提交表单时忽略特定字段,提高表单数据处理的灵活性和效率。以下是关于如何使用这些配置项的详细说明。

全局配置:ignoreHiddenFields ​

ts
type IgnoreHiddenFields = Boolean;

当设置为 true 时,表单将自动忽略所有处于隐藏状态的字段,即 hidden=true 的字段在提交时不会包含在提交的数据中。

注意

ignoreHiddenFields 只在表单初始化时生效,创建后修改该配置不会更新提交数据。需要忽略隐藏字段时,请在创建表单的 option 中设置。

使用示例 ​

ts
const options = {
  ignoreHiddenFields: true
};

规则配置:ignore ​

每个表单字段可单独配置 ignore 属性,用于决定该字段的提交行为。ignore 属性有两种配置:

ts
type Ignore = Boolean | 'hidden';
  • true: 无论字段是否隐藏,提交时都忽略该字段。
  • 'hidden': 仅当字段隐藏时忽略提交。

使用示例 ​

ts
const rule = {
  type: 'input',
  field: 'temporaryField',
  title: '临时字段',
  hidden: true, // 可动态改变
  ignore: 'hidden' // 将根据字段的隐藏状态决定是否忽略
}

解释: 在这个示例中,temporaryField 字段仅在其处于隐藏状态时才会被忽略。

示例 ​

提交后可以对比哪些字段被忽略:

  • 姓名始终提交
  • 令牌设置了 ignore: true,显示着也不会提交
  • 备注设置了 ignore: 'hidden',只有隐藏时才不提交
  • 附加信息是隐藏字段。示例在初始化时设置了 ignoreHiddenFields: true,所以不会提交

FormCreate 是一个开源项目,基于 MIT 许可证发布,欢迎个人和企业用户免费使用