@bimetal/kanban-headless

中文文档
0.42.0发布于 2026/10/30Apache-2.0TypeScriptES Module近 30 天下载 1.2万

在@bimetal/headles-core上, 拥有所有棋盘交互语义——拖放,对话框,过滤,WIP-error-as-state,撤销. 组件家族的例2; 框架将其绑为纯

中文使用文档

@ bimetal/ kanban- 无头

犬科,框架-不可知论 kanban 控制器 - 2号案例 BIMETAL 组成家族. 建造在 @bimetal/headless-core 完全一样 日历控制器, 因此它共享身份稳定 getSnapshot编号 :subscribe 合同和错误-状态表面;框架约束是纯粹的约束.

createKanbanController({ store, boardId, config }) 拥有每个棋盘 交互决定 :

  • 对话框 —— 说 openCreateCard 编号 : openEditCard 编号 : saveCard 编号 : deleteCard。 。 。 .
  • 拖放( D) —— 说 dropCard(cardId, toColumnId, toIndex) 编号 : reorderCard, (中文(简体) ), 与 startDrag 编号 : updateDragPreview 编号 : endDrag 用于现场预览.
  • 指针拖曳 —— 说 pointerDownCard 编号 : pointerMoveCard 编号 : pointerUpCard 编号 : pointerCancelCard。鼠标拖动后 4 px. A touch 或者说 pen 指针 (通过) e.pointerType) 只有在 config.touchHoldMs (默认450毫秒)不动. 浏览器的刷子 滚动( 卡片有 touch-action: pan-x pan-y) (中文(简体) ). 一拿到一张卡片, touchMoveCard(e) 停止滚动; 在 touchmove 与 { passive: false }。 。 。 . contextMenuCard(e) 保留长压菜单 (双金属363). touchHoldMs: 0 在触地得分时取出卡片; 刷取 开始于一纸牌,然后拖动它而不滚动(bimetal-386).
  • WIP - 错误状态 - 被拒绝的创建/移动(WIP限制)表面为 snapshot.lastAction 永远不要扔进装订箱里.
  • 撤销 —— 说 undo() 恢复整个董事会的一步; Ctrl/Cmd+Z 通过 handleKeydown。 。 。 .
  • 过滤/ 选择 —— 说 setFilter, (中文(简体) ), selectCard 编号 : clearSelection。 。 。 .
  • 激活 ——卡片点击(不是按下拖放的点击)和 Enter 离开 结束 activateCard: 它选择了卡片( e)onSelectionChange 火烧了 调用可选 onCardActivate(cardId) 钩. 用钩子,或用 config.cardDialog: false,内置编辑对话框不打开——用于 在自己的详细视图中显示卡片的主机(master-detail).
  • 锁定 —— 说 config.readOnly 锁定一切, 移动包含. config.lockStructure (栏:增加、重命名、重排、删除、WIP)和 config.lockCardContent (卡:创建,编辑,删除) 锁更细并保存 按指针和键盘移动牌; 撤消/重做在任意锁下被关闭 。 这个 快照携带 canEditStructure 编号 : canEditCards 编号 : undoRedoAvailable, (中文(简体) ), 捆绑者们以这等人的衣食遮盖他们的衣食.

切线与日历控制器相同: DOM 测量和 听者注册属于框架 if 属于这里.

版本与发布记录

@bimetal/kanban-headless 共发布 15 个版本,首次发布于 2026/07/16;过去 12 个月发布了 15 个版本。

版本发布日期距今
0.42.0latest2026/10/308 天前
0.41.02026/10/2415 天前
0.40.02026/10/1128 天前
0.39.02026/10/061 个月前
0.38.02026/10/041 个月前
0.37.02026/09/131 个月前

其他发布通道:next → 1.0.0-rc.3。

关于 @bimetal/kanban-headless 的常见问题

@bimetal/kanban-headless 是什么?

在@bimetal/headles-core上, 拥有所有棋盘交互语义——拖放,对话框,过滤,WIP-error-as-state,撤销. 组件家族的例2; 框架将其绑为纯

如何安装 @bimetal/kanban-headless?

在项目目录运行 npm install @bimetal/kanban-headless,或使用 pnpm add / yarn add / bun add。

@bimetal/kanban-headless 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@bimetal/kanban-headless 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@bimetal/kanban-headless 可以商用吗?

@bimetal/kanban-headless 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@bimetal/kanban-headless 的下载量有多少?

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

@bimetal/kanban-headless 还在维护吗?

最新版本 0.42.0 发布于 2026/10/30(8 天前);至今共发布 15 个版本,其中过去 12 个月发布了 15 个;首次发布于 2026/07/16。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。