# @fieldia/gantt 中文文档

规范地址：https://npmcn.com/package/%40fieldia/gantt/

版本：0\.36\.1
npm 元数据更新时间：2026-10-28T10:18:35.219Z
中文译文更新时间：2026-11-14T18:07:30.626Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40fieldia/gantt
原文对照：https://npmcn.com/package/%40fieldia/gantt/?lang=original
项目主页：https://fieldia.dev/
源码仓库：https://github.com/fieldia-dev/fieldia

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

- 包体积（解压后）：489 kB，99 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：4 个
- 首次发布：2026-10-23T01:16:04.109Z
- 最新版本发布：2026-10-28T10:18:34.486Z
- 近 30 天下载量：2399（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：13（近 12 个月 13 个）

## 中文简介

Fieldia's Gant Timor:一个列表中的记录作为时间轴上的条,分组,由记录相接,每个记录等待,通过拖放或从键盘上拖放来移动并拉长. 仅在显示时间表时装入 .

## 安装

```sh
npm install @fieldia/gantt
```

也可以使用：`pnpm add @fieldia/gantt`、`yarn add @fieldia/gantt`、`bun add @fieldia/gantt`

## README

# @ fieldia/ gantt (英语)

[外地](https://fieldia.dev/)甘特的时间:a **列表的记录为栏 时间轴**按天数、周数或月分列(项目、个人、 ),每个都加一箭头到它等待的记录. 人们拖拉拉 栏来移动它,拖动它的末端来拉伸它,并一天地移动它从 键盘。 动作是通过数据源的 `save`,与 **撤销**。它共享列表的搜索、过滤器和最爱,在 页面的时钟,右到左 打印整个计划 在页面的宽度, 讲英语、阿拉伯语、法语和德语——以及土耳其语、波斯语、乌尔都语和德语 西班牙语,机器辅助,尚未由母语者审查——及其代码, 及其除英语外每种语言的词句,只有在首次显示时才加载。 它用平面 DOM 和 SVG 绘制:没有图表库.

```sh
npm install @fieldia/gantt
```

```ts
import { mountViewer } from '@fieldia/viewer';
import { ganttListViews } from '@fieldia/gantt';

mountViewer(host, {
  page,
  dataSource,
  listViews: ganttListViews(),
  // A bar pressed, or Enter on it: the app opens the record.
  onOpenRecord: (id) => openTask(id),
});
```

以日历或地图登记: `listViews: { ...mapListViews({ provider }), ...calendarListViews(), ...ganttListViews() }`。 。 。 .

## 页面

列表页 `gantt` 提议 **时间线** 在会议桌旁:

```json
"layout": {
  "type": "list", "id": "tasks", "columns": ["name", "phase", "start", "days"],
  "gantt": {
    "start": "start", "duration": "days", "title": "name",
    "group": "phase", "colour": "trade", "dependsOn": "after",
    "zooms": ["day", "week", "month"], "zoom": "day", "opens": "gantt"
  }
}
```

| 选项 | 它会做什么 |
| --- | --- |
| `start` | 每个记录开始时: a `date` 或一个 `datetime`要求。 一张没有排行榜的唱片 也没有酒吧. |
| `end` | 当它结束的时候,一个同类的球场:它的最后一天,为约会. |
| `duration` | 或者持续多少天,一个 `integer` 或者说 `float` 字段,没有 `end` (一或相会. `0` 是一个里程碑,被画成钻石。 两者都一样 酒吧一天就能维持下去. |
| `title` | 每条栏上所出之词. 要求. |
| `group` | 一个链接、一个选择、一个文本或一个整数,其价值将栏条按组排列,每个栏条被划下;一个栏条将其组折开。 一个选择的团体是按其选择的顺序排列的,其他的则在它们的第一个开始;没有最后一个的记录. |
| `colour` | 一个字段,每个字段的颜色是相同的值,同样的颜色。 表示颜色本身的值( E)`#0f766e`)用如来. |
| `dependsOn` | A 类 `many2many` 至列表本身的记录:每个记录等待。 一箭从一箭取出一箭取出一箭取出一箭取出一箭取出一箭取出一箭取出一箭取出一箭取出一箭取出一箭取出一箭取出一箭取出一箭取出一箭取出一箭取出一箭取出一箭取出一箭取出一箭取出一箭取出一箭取出一箭取出一箭取出一箭取出一箭取出一箭取出一箭取出一箭取出一箭取出一箭取出一箭取出一箭取出一箭取出一箭取出一箭取出一箭出一箭出一箭出一箭出一箭出一箭出一箭出一箭出一箭出一箭出一箭出一箭出一箭出一箭出一箭出一箭出一箭出一箭出一箭出一箭出一箭出一箭出一箭出一箭出一箭出一箭出一箭出一箭出一箭出一箭出一箭出一箭出一箭出一箭出一箭出一箭出一. |
| `zooms` | 提供的比额表,顺序如下: `day`, (中文(简体) ), `week`, (中文(简体) ), `month`所有三个,除非说. |
| `zoom` | 它首先显示的尺度: `week` 除非是说. |
| `opens` | `gantt` 打开其时间表上的列表; `list` 在他的桌子上. |
| `firstDay` | 这周的第一天, `0` 周日到 `6` 周六,周首:除非说,否则区域先从“R”开始`firstWeekday`:页面属于自己,否则读者的浏览器用一个(一个)来要求页面的语言 `en` 页面读入 `en-EG`: 星期六, (笑声), `en-GB`:星期一),其他最通用语:阿拉伯语和波斯语的星期六;英语的星期日(英语:`en`乌尔都语、德语、法语、土耳其语和西班牙语. |

页面检查拒绝页面缺少的字段或错误的字段, 结束 另一种类型,而不是开始、结束和持续时间,a `dependsOn` 那个 链接到另一个模型的记录, a `zoom` 不属于 `zooms`列表 它打开的时间线和地图、日历或画廊.

**在一个区的时钟.** 一个时间线在区域时钟上 它的起动场 名称 (`timeZone` 在日期和时间字段上),否则其页面 (单位:千美元)`"timeZone": "Europe/Berlin"`),否则读者自己的:它的时代,今天的行 每一个酒吧的时间都是那个区域 不管它从哪里看,它的短 计划之外的名字,如果它的时代不是读者自己的。 一个酒吧移动过 一天的一天 保持一天的时间在那里, 通过一个变化的钟表太.

在标明记录的一页上(`"records": { "one": "task", "other": "tasks" }`, (中文(简体) ), 一组说"4个任务".

## 一个人能做什么

-   **见** 计划:连续数天、连续数周或数年数的月轴 数月;每张记录的行数,其名称作为日记被保留; 其条,有色; 标题下各组; 箭头; 一条红线 为今天。 它从它的第一项任务——今天看它在哪里——开始计划 表示有多少条栏杆脱落 它("qq 3","7"),被逼去追他们. **现在** 将今天带入视野; **天数**, (中文(简体) ), **周数** 财务报告和审定财务报表 **月份数** 更改比例表.
-   **移动** 一个酒吧,拖到其他的日子,和 **缩放** 通过拖曳 其开始或结束时间为全天(保留一天的时间)。 逃跑时 拖放回来 移动立即被保存; **撤销** 把它放回去,还有.. 也一样 **缩写+Z** (QQZ)来自页面上的任何地方,但输入或输入的框 对话 **缩写+ 移动+Z** 或者说 **缩写+Y** 又来了.
-   **打开** 按下其栏或名称,或 Enter: app's `onOpenRecord`,作为一行桌子打开.
-   **密钥**整个时间线一站 上下到达上面的栏杆 或以下( " 家 " 和 " 后 " );左右移动栏a 日(如页面所写:从右到左翻转),并带有Shift 移动在键盘休息时被写入, 作为一个与 Undo 一起移动, 或者当 栏左;然后放回去。 每个栏杆对屏幕说 读者的时代,持续时间,等待什么,是否开始 太快了,我还没准备好.
-   **打印**:在纸上,整个计划符合时间表的宽度,颜色 保持,按钮离开.

不能做的事情是隐藏的,永远不灰:没有 `save` 关于数据来源, 或起始、结束或持续时间字段为 `readonly`,不移动;a 记录其列表行表示 `can: { edit: false }`,或者设置其中的一个字段 内 `can.readonlyFields` 或者说 `can.hiddenFields`并说为什么 (单位:千美元)`can.reason`) (中文(简体) ).

## 数据来源

时间问题 `list` 列表中的记录 开始顺序,直到 `limit`移动呼叫 `save` 改为 字段本身——开始和结束(日期的最后一天为 `"2026-10-16"`页:1 作为ISO瞬间的日期和时间),或持续时间——以 `changes.values` 内 `values`, (中文(简体) ), `fields` 单独点名 `partial: true` (还有这行) `version`,当列表给出一个时),所以保存完整记录的源 所有其它的字段; 撤消保存这些字段之前所持有的,同样的方式. A 类 拒绝,但把酒吧放回去,说为什么。 移动相等: a 一旦第一个有答案,第二个就被拯救了.

## 设置

`ganttListViews({ labels, now, limit })`数字 :

-   `labels`: 时间线上的单词,按语言分列(`GanttLabels` 统统点名).
-   `now`: 此时此刻, 用于演示或测试.
-   `limit`:它需要多少记录,最多500份,除非说。 过了, 时间线上说它漏掉了多少.

麻省理工学院有执照.

## 常见问题

### @fieldia/gantt 是什么？

Fieldia's Gant Timor:一个列表中的记录作为时间轴上的条,分组,由记录相接,每个记录等待,通过拖放或从键盘上拖放来移动并拉长\. 仅在显示时间表时装入 \.

### 如何安装 @fieldia/gantt？

在项目目录运行 npm install @fieldia/gantt，或使用 pnpm add / yarn add / bun add。

### @fieldia/gantt 支持 TypeScript 吗？

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

### @fieldia/gantt 支持 ESM 还是 CommonJS？

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

### @fieldia/gantt 可以商用吗？

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

### @fieldia/gantt 的下载量有多少？

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

### @fieldia/gantt 还在维护吗？

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