# @client-side-validations/simple-form 中文文档

规范地址：https://npmcn.com/package/%40client-side-validations/simple-form/

版本：19\.0\.0
npm 元数据更新时间：2026-07-05T13:18:48.520Z
中文译文更新时间：2026-11-10T01:39:17.457Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40client-side-validations/simple-form
原文对照：https://npmcn.com/package/%40client-side-validations/simple-form/?lang=original
项目主页：https://github.com/DavyJonesLocker/client_side_validations-simple_form
源码仓库：https://github.com/DavyJonesLocker/client_side_validations-simple_form

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：23.5 kB，10 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：未声明
- Node.js 要求：\>= 18\.12
- 运行依赖：0 个
- peer 依赖：@client-side-validations/client-side-validations \>=25\.0\.0
- 首次发布：2019-08-25T10:37:44.366Z
- 最新版本发布：2026-07-05T13:18:48.412Z
- 近 30 天下载量：12448（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：12（近 12 个月 3 个）

## 中文简介

客户端验证简单格式插件

## 安装

```sh
npm install @client-side-validations/simple-form
```

也可以使用：`pnpm add @client-side-validations/simple-form`、`yarn add @client-side-validations/simple-form`、`bun add @client-side-validations/simple-form`

## README

# 客户端参数 - 简易格式

[![Gem Version](https://badge.fury.io/rb/client_side_validations-simple_form.svg)](https://badge.fury.io/rb/client_side_validations-simple_form) [![npm version](https://badge.fury.io/js/%40client-side-validations%2Fsimple-form.svg)](https://badge.fury.io/js/%40client-side-validations%2Fsimple-form) [![Ruby Build Status](https://github.com/DavyJonesLocker/client_side_validations-simple_form/actions/workflows/ruby.yml/badge.svg)](https://github.com/DavyJonesLocker/client_side_validations-simple_form/actions) [![JavaScript Build Status](https://github.com/DavyJonesLocker/client_side_validations-simple_form/actions/workflows/javascript.yml/badge.svg)](https://github.com/DavyJonesLocker/client_side_validations-simple_form/actions) [![Maintainability](https://qlty.sh/gh/DavyJonesLocker/projects/client_side_validations-simple_form/maintainability.svg)](https://qlty.sh/gh/DavyJonesLocker/projects/client_side_validations-simple_form) [![Coverage Status](https://coveralls.io/repos/github/DavyJonesLocker/client_side_validations-simple_form/badge.svg?branch=main)](https://coveralls.io/github/DavyJonesLocker/client_side_validations-simple_form?branch=main)

[简单窗体](https://github.com/heartcombo/simple_form) 用于 [客户端参数](https://github.com/DavyJonesLocker/client_side_validations)

## 安装

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

```ruby
gem 'simple_form'
gem 'client_side_validations'
gem 'client_side_validations-simple_form'
```

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

[遵循客户端的其余安装指令](https://github.com/DavyJonesLocker/client_side_validations/blob/main/README.md)

### Java 脚本文件

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

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

#### 使用 Web 包装器时

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

添加以下软件包:

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

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

```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`

```js
// 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` 到窗体构建器

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

使用 `:validate`

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

## 作者数

[布莱恩·卡达雷拉](https://twitter.com/bcardarella)

[格列米亚·塔利亚拉特拉](https://twitter.com/gtagliala)

[我们非常感谢许多捐助者](https://github.com/DavyJonesLocker/client_side_validations-simple_form/graphs/contributors)

## 版本

这颗宝石紧随其后 [语义版本](https://semver.org/)

## 想帮忙吗?

请吧! 我们一直想改进这颗宝石 请看我们的 [贡献准则](https://github.com/DavyJonesLocker/client_side_validations-simple_form/blob/main/CONTRIBUTING.md) 关于如何妥善提交问题和处理请求.

## 法律

[码头](https://dockyard.com/)页:1

[@dockyard (英语)](https://twitter.com/dockyard)

[获得麻省理工学院许可证](https://opensource.org/licenses/mit)

## 常见问题

### @client-side-validations/simple-form 是什么？

客户端验证简单格式插件

### 如何安装 @client-side-validations/simple-form？

在项目目录运行 npm install @client-side-validations/simple-form，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@client-side-validations/client-side-validations（\>=25\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @client-side-validations/simple-form 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/client-side-validations\_\_simple-form 是否存在。

### @client-side-validations/simple-form 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @client-side-validations/simple-form 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>= 18\.12。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @client-side-validations/simple-form 可以商用吗？

@client-side-validations/simple-form 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @client-side-validations/simple-form 的下载量有多少？

根据 npm 官方下载统计，@client-side-validations/simple-form 在 2026/10/10 – 2026/11/08 这 30 天内被下载 12,448 次，日均约 415 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @client-side-validations/simple-form 还在维护吗？

最新版本 19\.0\.0 发布于 2026/07/05（4 个月前）；至今共发布 12 个版本，其中过去 12 个月发布了 3 个；首次发布于 2019/08/25。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。