reform

改革

将对象与模型分离开来。 Reform 为您提供了带有验证和嵌套模型设置的表单对象。它完全无关乎框架，也不关心您的数据库。 虽然 Reform 可以用于任何 Ruby 框架中,但它带有 Rails 支持,可与 simple_form 和其他表单 gem 结合使用,允许嵌套表单实现 has_one 和 has_many 关系,可以 从多个对象构建表单,并为您提供强制转换。

完整文档

改革是 Trailblazer 框架的一部分。项目网站上提供了 完整文档。

2.2 变革

临时说明: Reform 2.2 不再 自动加载 Rails 文件 (例如 ActiveModel::Validations)。您需要安装 reform-rails gem,请参阅 安装。

1. #initialize 总是需要表单所代表的模型。 2. #validate(params) 会使用输入数据更新表单的字段(仅限表单,而不是模型),然后运行所有验证。 返回值是验证的布尔结果。 3. #errors 以典型的 ActiveModel 方式返回验证消息。 4. #sync 将表单数据写回模型。 此操作只会使用模型上的 setter 方法。 5. #save (可选) 将调用模型和嵌套模型上的 #save。 请注意,这意味着还会调用 #sync。 6. #prepopulate! (可选) 会运行预填充钩子,在渲染前"填写"您的表单。

除了主 API 外,表单还暴露了对定义的属性的访问器。这用于渲染或手动操作。