初始化
通过以下三个步骤在页面上创建 Kanban 控件:
- 引入源文件。
- 创建容器。
- 初始化 Kanban。
Include source files
下载软件包并将其内容解压到您的项目文件夹中。
在页面中引入以下源文件:
- kanban.js
- kanban.css
为两个文件设置正确的相对路径:
index.html
<script type="text/javascript" src="./dist/kanban.js"></script>
<link rel="stylesheet" href="./dist/kanban.css">
Create a container
为 Kanban 添加一个容器,并为其分配一个 ID,例如 root:
index.html
<div id="root"></div>
如果需要同时创建带有 Toolbar 的控件,请为 Toolbar 单独添加一个容器:
index.html
<div id="toolbar"></div> // Toolbar 的容器
<div id="root"></div> // Kanban 的容器
Initialize Kanban
使用 kanban.Kanban 构造函数初始化 Kanban。构造函数接受两个参数:
- HTML 容器的 CSS 选择器(或容器元素本身)
- 配置对象(参见完整属性列表)
以下代码片段创建一个 Kanban 实例:
index.html
// create Kanban
new kanban.Kanban("#root", {
// configuration properties
});
如需同时创建带有 Toolbar 的控件,请使用 kanban.Toolbar 构造函数单独初始化 Toolbar。Toolbar 控件通过 api 参数操作 Kanban 实例。传入 board.api 以将 Toolbar 绑定到看板:
index.html
// create Kanban
const board = new kanban.Kanban("#root", {
// configuration properties
});
new kanban.Toolbar("#toolbar", {
api: board.api, // required: links Toolbar controls to the Kanban instance
// other configuration properties
});
信息
有关 Toolbar 配置的详细信息,请阅读配置章节。
Configuration properties
完整配置参考:
- Kanban 属性概览 — 所有 Kanban 配置属性
- Toolbar 属性概览 — 所有 Toolbar 配置属性
示例
以下代码片段使用示例数据初始化 Kanban: