客户端参数 - 简易格式

简单窗体 用于 客户端参数

安装

在您的 Gem 文件中添加以下内容:

gem 'simple_form'
gem 'client_side_validations'
gem 'client_side_validations-simple_form'

这里有秩序. simple_form 财务报告和审定财务报表 client_side_validations 必须 所需经费 在此之前 client_side_validations-simple_form。 。 。 .

遵循客户端的其余安装指令

Java 脚本文件

指令取决于您的技术堆栈 .

此软件包扩展为 jQuery- 无查询, DOM- first ClientSideValidations 运行时间.

使用 Web 包装器时

在简单窗体插件之前, 请确定您需要客户端验证 .

添加以下软件包:

yarn add @client-side-validations/simple-form

然后,根据您使用的CSS框架和模块系统,添加 一个 线条编号 app/javascript/packs/application.js 组合 :

// No framework / Generic frameworks / Bootstrap 3 with `import` syntax
import '@client-side-validations/simple-form'

// Bootstrap 4+ with `import` syntax
import '@client-side-validations/simple-form/dist/simple-form.bootstrap4.esm'

// No framework / Generic frameworks / Bootstrap 3 with `require` syntax
require('@client-side-validations/simple-form')

// Bootstrap 4+ with `require` syntax
require('@client-side-validations/simple-form/dist/simple-form.bootstrap4.esm')

使用螺旋桨时

在简单窗体插件之前, 请确定您需要客户端验证 .

根据您使用的网络框架, 添加 一个 改为: 线条到您的 app/assets/javascripts/application.js, (中文(简体) ), 之后 //= require rails.validations

// No framework / Generic frameworks / Bootstrap 3
//= require rails.validations.simple_form

// Bootstrap 4+
//= require rails.validations.simple_form.bootstrap4

如果您需要将资产文件从宝石复制到您的项目中, 请运行 :

rails g client_side_validations:copy_assets

注:如果运行 copy_assets,您每次更新此项目时都需要再次运行.

移徙指南

删除 j 查询依赖性

client_side_validations-simple_form 现在插入 DOM- first ClientSideValidations 运行时间和不再假设 jQuery 存在 .

跟着主 ClientSideValidations 公共 API 的迁移指南 。 特别是装入当前 DOM- first ClientSideValidations 装入此软件包前捆绑, 并更新任何仍然期望 jQuery- wraped 对象的自定义代码 .

自定义简单窗体构建器现在在其中接收本地 DOM 元素 add 财务报告和审定财务报表 remove 钩子,所以自定义覆盖应该使用 DOM API 如 .closest(), (中文(简体) ), .querySelector(),以及 .classList。 。 。 .

如果将编成的资产出售给 rails g client_side_validations:copy_assets,在升级后再次运行该生成器,以便复制的简单窗体资产与当前保持同步 ClientSideValidations 捆绑.

使用量

其用法与 ClientSideValidations刚刚通过 validate: true 到窗体构建器

<%= simple_form_for @book, validate: true do |book| %>
  <%= book.input :name %>
<% end %>

使用 :validate

<%= book.input :name, validate: { presence: true, uniqueness: false } %>

作者数

布莱恩·卡达雷拉

格列米亚·塔利亚拉特拉

我们非常感谢许多捐助者

版本

这颗宝石紧随其后 语义版本

想帮忙吗?

请吧! 我们一直想改进这颗宝石 请看我们的 贡献准则 关于如何妥善提交问题和处理请求.

法律

码头页:1

@dockyard (英语)

获得麻省理工学院许可证