什么是 oni.js
oni.js 是一个通过连接不同的表单控件和视觉元素来构建用户界面的库。它利用现代浏览器的众多特性，如 ES6，Web Components 和 Shadow DOM，使开发人员能够轻松构建丰富的界面效果。oni.js 提供了简洁的 API 来管理表单值和视觉状态，使得表单显得简洁而且易于维护。
安装
首先，我们需要在项目中安装 oni.js 包。在项目目录中，打开终端（Terminal），运行以下命令：
npm install oni.js --save
这个命令将会将 oni.js 包下载到你的项目中，安装完成后，你可以将其导入到你的项目中。
使用
1. 初始化
首先，你需要在项目中引入 oni.js 包。在你的 JavaScript 文件中，使用以下命令：
import oni from 'oni.js';
这个命令将会导入 oni.js 包，并将其存储在变量 oni 中。
2. 创建表单组件
你可以通过调用 oni.js 的 registerForm 方法来创建表单组件。每个表单组件都需要一个 HTML 模板，并有一个唯一的名称。
下面是一个 HTML 模板：
-- -------------------- ---- ------- ---- ------------- ------ ----------------------- ------ ----------- --------------- ---------- ------ ------------------------- ------ ----------- ---------------- ---------- ------ ----------------------------- --------- ------------------------------ ------- ----------------------------- ------
注意，每个控件都需要一个 oni-name 属性，该属性将会在 oni.js 中作为控件名称来使用。
下面是如何通过 oni.js 来注册表单组件：
-- -------------------- ---- -------
--------------------------- -
--------- -
---- -------------
------ -----------------------
------ ----------- --------------- ----------
------ -------------------------
------ ----------- ---------------- ----------
------ -----------------------------
--------- ------------------------------
------- -----------------------------
------
--
------- -
----- -
----- --------
--
------ -
----- --------
--
-------- -
----- --------
-
-
---这个命令将会通过调用 oni.js 的 registerForm 方法来注册一个名为 my-form 的表单组件，并将其存储在 oni.js 中。
3. 创建表单实例
我们需要使用实例化方法将表单组件转换为实际表单，这可以通过调用 oni.js 的 createForm 方法来实现。createForm 方法需要两个参数，即表单名称和表单数据。表单数据应遵循前一页中定义的模式。
const form = oni.createForm('my-form', {
name: '',
email: '',
message: ''
});这个命令将会通过调用 oni.js 的 createForm 方法来创建一个 my-form 实例，并将其存储在变量 form 中。
4. 验证表单
你可以通过调用 oni.js 的 validate 方法来验证表单。
const isValid = form.validate();
这个命令将会通过调用 oni.js 的 validate 方法来验证表单是否有效，并将结果存储在变量 isValid 中。如果表单有效，则 isValid 的值为 true；如果无效，则为 false。
5. 获取表单数据
你可以通过调用 oni.js 的 getValue 方法来获取表单数据。
const formData = form.getValue();
这个命令将会通过调用 oni.js 的 getValue 方法来获取表单数据，并将其存储在变量 formData 中。表单数据包含 my-form 实例中定义的所有控件数据。
6. 更新表单数据
你可以通过调用 oni.js 的 setValue 方法来更新表单数据。
form.setValue({
name: 'Tom',
email: 'tom@example.com',
message: 'Hello World'
});这个命令将会通过调用 oni.js 的 setValue 方法来设置新的表单数据。
我们已经了解了如何使用 oni.js 来创建表单组件，实例化表单，验证表单，获取和更新表单数据。现在，我们看看如何通过 oni.js 来处理表单事件。
7. 处理表单事件
oni.js 提供了以下事件供开发人员使用：
onsubmit: 当表单提交时触发。onload: 当表单加载时触发。onchange: 当表单数据更改时触发。
你可以通过在 my-form 实例上使用 addEventListener 方法来注册这些事件。
-- -------------------- ---- ------- --------------------------------- -- -- - ----------------- ------------- --- ------------------------------- -- -- - ----------------- ---------- --- --------------------------------- -- -- - ----------------- ----------- ---
这些命令将会通过调用 oni.js 的 addEventListener 方法来添加事件监听器并处理事件。
结论
oni.js 是一个非常强大的前端库，可以让你快速简便地构建表单组件。通过本文介绍的方法，你可以快速上手，并能够自信地开始使用 oni.js 来构建自己的前端应用程序。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60066fb03d1de16d83a67366