# 甘特图

提供甘特图的基础功能,支持通过条状图来显示项目、进度等维度随着时间进展的情况。

# 概念说明

# 属性

# 基础信息

  • 组件名称:由字母、数字和下划线组成,用于在表达式中引用、权限上报等场景。
  • 是否控制权限:可根据角色设置权限,对无权限的角色的用户隐藏该组件,设置权限前,必须先设置组件名称。
  • 条件:可通过表达式设置组件显示的条件,当条件为True时显示,为False时隐藏该组件。

# 数据属性

  • 数据源:数据图表的数据源,可选用List<T>或Pageof<T>类型的变量,或输出参数为List<T>或Pageof<T>类型数据的逻辑作为数据源。

  • 文本字段:设置甘特图横道图上文本的的字段。

  • 开始日期字段:设置甘特图横道图上开始时间的字段。

  • 持续时间字段:设置甘特图横道图上持续时间的字段。

  • 进度字段:设置甘特图横道图上各项进度百分比的字段。

  • id字段:设置数据每项的id字段,用于配合父级字段生成树形结构。

  • 父级字段:设置数据的每项的父级字段,会根据父级字段的值指向的id字段具体值,来生成树型结构。比如,某一列parent-field值为1,他将会转为id-field为1的数据的子节点。

  • 数据颜色字段:设置数据列表每一项数据颜色,不填默认为黑色。

  • 图标字段:设置数据列表图标字段,仅支持png,jpg类型的图片链接。

    image-20230613195957617

    # 甘特图表格配置:用于配置甘特图表格数据,包含以下列属性。

    image-20230614100236805
    • 列字段:设置甘特图数据表格每一列从数据源中所取的字段。

    • 列名称:设置甘特图数据表格,每一列的列名称。

    • 列宽度:设置设置甘特图数据表格,每一列的具体宽度。

    • 是否显示工具提示:设置设置甘特图数据表格的某一列,是否在鼠标浮动时显示在工具提示中,效果如下图。

      image-20230613200540347

# 展示属性

切换日期视图:设置甘特图上横道图部分显示日期的维度,支持绑定变量值分别为d(日),w(周),m(月),y(年),来动态控制。

展示今日标记线:设置显示今日标记线。

# 事件

  • 任务点击时:任务点击时触发。
  • 刻度点击时:横道图时间刻度点击时触发。

# 方法

  • 重新加载(load): 重新加载甘特图。
  • 定位到今日标记线(changeToday):定位甘特图横道图部分到今日标记线。

# 样式

样式说明请参见组件通用说明

# 常见问题

  • Q:数据属性中有哪些必填字段:

    A:为保证甘特图的正常渲染,请配置必填字段:数据源、甘特图表格配置、文本字段、开始日期字段、持续时间字段、进度字段。以上几个属性为用于渲染甘特图的必要数据字段。而id字段、父级字段、数据颜色字段、图标字段用于个性化改变甘特图样式,没有相关需求可以不设置。

  • Q:工具提示怎么设置:

    A:工具提示通过甘特图表格配置字段中的“是否显示工具提示”来设置,工具提示中会至少保证留文本字段,和开始日期,结束日期几个字段的显示。

上次更新: 2023年06月14日