@hanzo/data

中文文档
1.4.8发布于 2026/11/17MITTypeScriptESM + CJS近 30 天下载 1.3万

Hanzo Data——跨平台,由元数据驱动的数据应用组件(类型字段,记录表,kanban board,记录细节,保存视图)在@hanzo/gui上. 通用对象/字段/记录/视图层,可赋予我们任何基于基础的客户关系管理、客户关系管理或商业应用

中文使用文档
文档目录6 节
  1. 安装
  2. 旗舰: RecordsView
  3. 字段类型
  4. 扩展
  5. 纯逻辑(可用主机,测试)
  6. 表面

@hanzo/数据

跨平台、元数据驱动 数据应用组件 用于任何 半藏基地-后置应用——CRM,CMS,商业,或一次性内部工具. 一种模式(类型) 字段 → 记录 → 视图)在任何地方,在网络上,在本地(iOS)和桌面上制作,因为它是建立在 @hanzo/gui 并绘制 @hanzo/ui'记录套件——表qq板,过滤器,排序,组,内置编辑,保存视图.

对象是一组被打字的字段。 记录是这些字段的值。 每一个视图——表、板、细节——都通过登记册发送,从这个模型中得出,所以,增加一个字段类型就是: 一次登记从来没有 switch 编辑. 商业应用软件(CMM/CMS/ERP)只是一套对这些组件的看法.

安装

bun add @hanzo/data @hanzo/ui @hanzo/gui

@hanzo/ui, (中文(简体) ), @hanzo/gui 财务报告和审定财务报表 react 是同龄人。 把它挂起来 <Hanzo> (单位:千美元) @hanzo/ui root)和单元格,卡片和编辑都跟随主题. 环绕记录 表面在 <Density value="compact"> 记录密度: 32px行和 控件, 8px 沟道, 13px 文本; 没有它, 表格将保留 44px 行和 编辑工具包的36px.

旗舰: RecordsView

一个外壳将任何收藏变成一个记录表面——一个工具栏(视图开关、搜索、过滤器构建器、排序构建器、棋盘组合),通过一个 数据表 或一个 董事会,由单人驱动 ViewConfig. 演示式+数据注入:主机提供原始记录和持续回调;视图拥有交互状态.

import { RecordsView, type FieldDefinition } from '@hanzo/data'

<RecordsView
  fields={fields}
  records={records}                              // raw rows; the view applies search + filter + sort
  onOpen={openDetail}                            // expand a record
  onEditCommit={(rec, field, value) => save(rec, field, value)}  // inline cell / board edit
  onCreate={createRecord}
  savedViews={{ views, activeId, onSelect, onSave, onDelete, deletable }}  // optional named views; deletable(id) keeps built-ins
/>
  • 数据表 ——点击-按键头,拖放-调整大小+拖放-重排列,用页眉选择行选择全部,内置单元格编辑(字段自有编辑器),页码,悬浮-回放打开,诚实地空入/装入.
  • 董事会 由选定/状态/boolean/关系字段组合的 kanban; 将卡拖到另一个行并释放出记录补丁( 乐观, 失败时返回) .
  • 详细记录 - 题为 " 可选内在编辑的栏目 " ,其中 related 插槽 . 记录格式 ——创建/编辑形式.

风景的规则结合 match数字 : and (所有规则,默认)或 or (任何一种);两条规则之间的词交换. 数字、金钱和日期也过滤 between 两个值, 任意一端开着, 一个结束一天的距离 需要整个一天.

服务器的一页. 收藏量太大,无法保存,主机在查询时运行该视图,并通过它带回的一页 remote:记录显示为给定,从不重新过滤,寻呼器读取总计.

<RecordsView
  fields={fields}
  records={page.items}                                       // already searched, filtered, sorted
  view={view}
  onViewChange={setView}                                     // the host re-queries on every change
  remote={{ page: page.page, total: page.total, onPage: setPageNumber }}
/>

字段类型

text · longText · number · percent · currency · boolean · select · multiSelect · date · dateTime · email · url · links · phone · rating · relation · json · uuid · fullName · address · files · richText · position · actor

每个类型都有读数 显示 和(可编辑之处) a 投入@hanzo/ui的唱片包:选择是 标记 在其选项的颜色(三十个数据色, TagColor)及其编辑器的可搜索菜单有"不..."一行;数个值是一行标签或药丸,有一个 +N 组合键; 电子邮件、链接和电话是带有邮件/ https/ 电话目标的药丸; 关系是一个记录芯片 有远见; 货币是带有 货币拾取器 (b) 电话号码和 调用代码拾取器{\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}一个工具箱的约会 {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}我 日历 在打字日下; 评分一行恒星. 输入承诺编辑, 退出取消 .

扩展

登记任何类型——内置或自定义——的渲染器

import { registerField } from '@hanzo/data'

registerField('rating', { Display: MyStars, Input: MyStarPicker })

纯逻辑(可用主机,测试)

排序 / 过滤 / 搜索 / 组 / 视图帮助器是纯和导出( 也在子路径上) @hanzo/data/{table,board,view}/logic 这样一个节点主机就可以在没有gui运行时间的情况下导入它们 :

import { applyView, sortRecords, filterRecords, boardColumns } from '@hanzo/data'

表面

  • 型号 —— 说 FieldDefinition, (中文(简体) ), FieldType, (中文(简体) ), FieldMetadata, (中文(简体) ), SelectOption, (中文(简体) ), TagColor, (中文(简体) ), CurrencyValue, (中文(简体) ), LinkValue, (中文(简体) ), AddressValue, (中文(简体) ), FullNameValue, (中文(简体) ), ActorValue
  • 名单 —— 说 regions(), (中文(简体) ), currencies() (从Intl,用读者的语言),, CALLING (E.164呼叫代码)
  • 视图 —— 说 RecordsView, (中文(简体) ), DataTable, (中文(简体) ), BoardView, (中文(简体) ), RecordDetail, (中文(简体) ), RecordForm, (中文(简体) ), RecordCard, (中文(简体) ), RecordsToolbar
  • 初级 —— 说 Menu, (中文(简体) ), MenuItem, (中文(简体) ), CheckBox, (中文(简体) ), Toggle, (中文(简体) ), Calendar
  • 路由器/登记 —— 说 FieldDisplay, (中文(简体) ), FieldInput, (中文(简体) ), isEditable, (中文(简体) ), registerField, (中文(简体) ), getFieldRenderers
  • 逻辑 —— 说 applyView, (中文(简体) ), sortRecords, (中文(简体) ), filterRecords, (中文(简体) ), searchRecords, (中文(简体) ), paginate, (中文(简体) ), boardColumns, (中文(简体) ), movePatch, (中文(简体) ), operatorsForType, (中文(简体) ), emptyView, (中文(简体) ), describeView,, , , , , , , ,
  • 主题 —— 说 TAG_TONES, (中文(简体) ), tagTone (数据调色板的标签对作为自定义属性); tokens (旧的固定暗色调色板,为呼叫者保留)

• 麻省理工学院 利比里亚HIP-0137 (中文(简体) )hanzoai/hips) (中文(简体) ).

版本与发布记录

@hanzo/data 共发布 19 个版本,首次发布于 2024/07/24;过去 12 个月发布了 17 个版本。

版本发布日期距今
1.4.8latest2026/11/17今天
1.4.72026/11/17今天
1.4.62026/11/134 天前
1.4.52026/11/0215 天前
1.4.42026/11/0215 天前
1.4.32026/11/0215 天前

关于 @hanzo/data 的常见问题

@hanzo/data 是什么?

Hanzo Data——跨平台,由元数据驱动的数据应用组件(类型字段,记录表,kanban board,记录细节,保存视图)在@hanzo/gui上. 通用对象/字段/记录/视图层,可赋予我们任何基于基础的客户关系管理、客户关系管理或商业应用

如何安装 @hanzo/data?

在项目目录运行 npm install @hanzo/data,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(>=19.2.8)、@hanzo/ui(>=8.28.0)、@hanzo/gui(>=8.3.5)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@hanzo/data 支持 TypeScript 吗?

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

@hanzo/data 支持 ESM 还是 CommonJS?

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

@hanzo/data 可以商用吗?

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

@hanzo/data 的下载量有多少?

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

@hanzo/data 还在维护吗?

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