@graphysdk/geom-waterfall

中文文档
0.1.1-beta.1794847602792发布于 2026/11/17SEE LICENSE IN LICENSE.mdTypeScriptESM + CJS零依赖近 30 天下载 1.6万

地平面图 SDK (β) 瀑布地平面

中文使用文档
文档目录5 节
  1. 安装
  2. 使用量
  3. 文档
  4. 反馈
  5. 许可证

@graphysdk/geom-瀑布

贝塔. 这颗地上是 0.x 版本行:小版发行可能改变其美学,风格部件或外观. 使用护目范围( E)^0.1.0)只取补丁.

用来绘制SDK图的瀑布地缘图 它显示一个运行的总数是如何从它开始到结束的:每个变化一个浮动条,其颜色是增加还是取消,总数站在零上,一个连接器将总数从每个条带到下一个条.

学习更多 图表.dev。 。 。 .

安装

npm install @graphysdk/geom-waterfall @graphysdk/react

需要反应19。 它唯一的对等者是 @graphysdk/react。 。 。 .

使用量

数据是每行一行,按总运行顺序排列. 将分类映射到 x 更改为 y地图 measure 标记行的列 'total' (目前运行总数)或 'absolute' (将运行总数设置为行值); 空或 'relative' 行是一个步骤,任何其他值都是错误:

import { createGraphyKit, GraphRenderer } from '@graphysdk/react';
import { waterfall } from '@graphysdk/geom-waterfall';

const kit = createGraphyKit({ plugins: [waterfall] });

const data = {
  columns: [{ key: 'item' }, { key: 'amount' }, { key: 'measure' }],
  rows: [
    { item: 'Opening', amount: 100, measure: 'absolute' },
    { item: 'Sales', amount: 60 },
    { item: 'Payroll', amount: -50 },
    { item: 'Closing', measure: 'total' },
  ],
};

const spec = kit.pipe(
  kit.createSpec({ x: 'item', y: 'amount' }),
  kit.geom.waterfall({ aes: { measure: 'measure' } }),
  kit.scale.x.discrete(),
  kit.scale.y.continuous()
);

export function CashFlow() {
  return (
    <kit.GraphProvider spec={spec} data={data}>
      <GraphRenderer />
    </kit.GraphProvider>
  );
}

当运行中的总和已经在数据中时, 设置 stat: kit.stat.identity() 和地图 start 财务报告和审定财务报表 end 改为 y· ; measure 仍然标出总数。 以图例、地图通过比例尺来显示类型 color: 'waterfallKind'。 。 。 .

params.width 设置每个栏的分数 (0, 1] (默认) 0.8),以及 params.connector 设置横列之间总线的运行位置: 'spanning' (违约)或 'between'。 。 。 .

将条条涂上 kit.style.geom.waterfall.increase(), (中文(简体) ), .decrease() 财务报告和审定财务报表 .total()它们之间的线条 kit.style.geom.waterfall.connector() (单位:千美元)alpha: 0 把他们藏起来,一个 where 选择那些离开一些栏杆的人, 和栏杆的共享的外观 kit.style.geom.waterfall()。 。 。 .

文档

反馈

这颗地em提前发布,以听到什么是可行的. 告诉我们 解析器。 。 。 .

许可证

此套件可在PolyForm非商业,小企业,或32天自由审判下提供. 自由审判(Free Trial)只是局部或内部的评价——它并不覆盖一个公开的页面. 见 在审判中你能做的。 。 。 .

商业许可证, 跟我们谈谈。 。 。 .

版本与发布记录

@graphysdk/geom-waterfall 共发布 155 个版本,首次发布于 2026/10/08;过去 12 个月发布了 155 个版本。

版本发布日期距今
0.1.1-beta.1794847602792latest2026/11/17今天
0.1.1-beta.17948408135452026/11/16今天
0.1.1-beta.17948401073962026/11/16今天
0.1.1-beta.17948274193392026/11/16今天
0.1.1-beta.17945866913282026/11/143 天前
0.1.1-beta.17945823311012026/11/133 天前

关于 @graphysdk/geom-waterfall 的常见问题

@graphysdk/geom-waterfall 是什么?

地平面图 SDK (β) 瀑布地平面

如何安装 @graphysdk/geom-waterfall?

在项目目录运行 npm install @graphysdk/geom-waterfall,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^19.0.0)、@graphysdk/react(^1.9.0-beta.1794847602792)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@graphysdk/geom-waterfall 支持 TypeScript 吗?

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

@graphysdk/geom-waterfall 支持 ESM 还是 CommonJS?

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

@graphysdk/geom-waterfall 可以商用吗?

@graphysdk/geom-waterfall 使用 SEE LICENSE IN LICENSE.md 许可。许可条款写在包内的独立文件中,请阅读该文件确认可否商用。以上为概括,不构成法律意见,请以许可原文为准。

@graphysdk/geom-waterfall 的下载量有多少?

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

@graphysdk/geom-waterfall 还在维护吗?

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