@ant-design/flowchart

中文文档
1.2.3发布于 2024/03/08MITTypeScriptESM + CJS近 30 天下载 6.9万

Flowchart

原始使用文档
文档目录8 节
  1. Case
  2. ✨ Features
  3. 📦 Installation
  4. 🔨 Usage
  5. 📜 Document & API
  6. 🤝 How to Contribute
  7. 📧 Contact us
  8. License

@ant-design/flowchart

Flowchart solutions, based on XFlow.

npm npm GitHub stars npm License

Website • Quick Start • Gallery • FAQ • Blog

Case

✨ Features

  • Easy to use
  • TypeScript

📦 Installation

$ npm install @ant-design/flowchart

🔨 Usage

import React from 'react';
import { Flowchart } from '@ant-design/flowchart';
import 'antd/dist/antd.css';
import '@ant-design/flowchart/dist/index.css';

const DemoFlowchart = () => {
  return (
    <div style={{ height: 600 }}>
      <Flowchart
        onSave={(d) => {
          console.log(d, JSON.stringify(d));
        }}
        toolbarPanelProps={{
          position: {
            top: 0,
            left: 0,
            right: 0,
          },
        }}
        scaleToolbarPanelProps={{
          layout: 'horizontal',
          position: {
            right: 0,
            top: -40,
          },
          style: {
            width: 150,
            height: 39,
            left: 'auto',
            background: 'transparent',
          },
        }}
        canvasProps={{
          position: {
            top: 40,
            left: 0,
            right: 0,
            bottom: 0,
          },
        }}
        nodePanelProps={{
          position: { width: 160, top: 40, bottom: 0, left: 0 },
        }}
        detailPanelProps={{
          position: { width: 200, top: 40, bottom: 0, right: 0 },
        }}
      />
    </div>
  );
};
export default DemoFlowchart;

Preview

📜 Document & API

export interface FlowchartProps extends FlowchartContainerProps {
  /** 默认数据 */
  data?: Datum;

  /** 画布是否自动居中 */
  isAutoCenter?: boolean;

  /** 节点面板配置 */
  nodePanelProps?: NodePanelProps;

  /** 画布主要区域配置 */
  canvasProps?: CanvasProps;

  /**
   * @title 画布状态
   * @description scan 会禁用一些画布事件,例如连线、鼠标右键等
   * @default "edit"
   */
  mode?: 'edit' | 'scan';

  /** toolbar */
  toolbarPanelProps?: ToolbarPanelProps;

  /** keyBinding */
  keyBindingProps?: false | KeybindingConfig;

  /** scale toolbar */
  scaleToolbarPanelProps?: ScaleToolbarPanelProps;

  /** form editor */
  detailPanelProps?: DetailPanelProps;

  /** 右键菜单配置 */
  contextMenuPanelProps?: ContextMenuPanelProps;

  /** popover */
  popoverProps?: PopoverProps;

  /** onReady */
  onReady?: (graph: IFlowchartGraph, app: IApplication) => void;

  /** 点击回调,仅支持 save-graph-data */
  onSave?: (data: Datum) => void;

  /** 新增节点时回调 */
  onAddNode?: (node: NsGraph.INodeConfig) => void;

  /** 新增边时回调 */
  onAddEdge?: (edge: NsGraph.IEdgeConfig) => void;

  /** xflow app 销毁前的回调 */
  onDestroy?: IAppDestroy;

  /** xflow app 初始化后的回调 */
  onConfigReady?: IAppConfigReady;

  /** 节点或边更新数据时调用 */
  onConfigChange?: (params: { data: Datum; type: string; config?: NsGraph.INodeConfig | NsGraph.IEdgeConfig }) => void;
}

🤝 How to Contribute

Your contributions are always welcome! Please Do have a look at the issues first.

📧 Contact us

DingTalk group number: 44788198 .

License

MIT

版本与发布记录

@ant-design/flowchart 共发布 38 个版本,首次发布于 2021/10/15;过去 12 个月发布了 0 个版本。

版本发布日期距今
1.2.3latest2024/03/082 年前
1.2.22023/01/123 年前
1.2.12022/08/234 年前
1.2.02022/08/164 年前
1.1.92022/07/264 年前
1.1.82022/07/194 年前

其他发布通道:beta → 1.0.6-beta.1。

关于 @ant-design/flowchart 的常见问题

@ant-design/flowchart 是什么?

Flowchart

如何安装 @ant-design/flowchart?

在项目目录运行 npm install @ant-design/flowchart,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:antd(^4.6.3)、react(>=16.8.4)、lodash(^4.17.20)、react-dom(>=16.8.4)、@ant-design/icons(^4.6.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@ant-design/flowchart 支持 TypeScript 吗?

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

@ant-design/flowchart 支持 ESM 还是 CommonJS?

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

@ant-design/flowchart 可以商用吗?

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

@ant-design/flowchart 的下载量有多少?

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

@ant-design/flowchart 还在维护吗?

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