# 甘特图
提供甘特图的基础功能,支持通过条状图来显示项目、进度等维度随着时间进展的情况。
# 概念说明
# 属性
# 基础信息
- 组件名称:由字母、数字和下划线组成,用于在表达式中引用、权限上报等场景。
- 是否控制权限:可根据角色设置权限,对无权限的角色的用户隐藏该组件,设置权限前,必须先设置组件名称。
- 条件:可通过表达式设置组件显示的条件,当条件为True时显示,为False时隐藏该组件。
# 数据属性
数据源:数据图表的数据源,可选用List<T>或Pageof<T>类型的变量,或输出参数为List<T>或Pageof<T>类型数据的逻辑作为数据源。
文本字段:设置甘特图横道图上文本的的字段。
开始日期字段:设置甘特图横道图上开始时间的字段。
持续时间字段:设置甘特图横道图上持续时间的字段。
进度字段:设置甘特图横道图上各项进度百分比的字段。
id字段:设置数据每项的id字段,用于配合父级字段生成树形结构。
父级字段:设置数据的每项的父级字段,会根据父级字段的值指向的id字段具体值,来生成树型结构。比如,某一列parent-field值为1,他将会转为id-field为1的数据的子节点。
数据颜色字段:设置数据列表每一项数据颜色,不填默认为黑色。
图标字段:设置数据列表图标字段,仅支持png,jpg类型的图片链接。
# 甘特图表格配置:用于配置甘特图表格数据,包含以下列属性。
列字段:设置甘特图数据表格每一列从数据源中所取的字段。
列名称:设置甘特图数据表格,每一列的列名称。
列宽度:设置设置甘特图数据表格,每一列的具体宽度。
是否显示工具提示:设置设置甘特图数据表格的某一列,是否在鼠标浮动时显示在工具提示中,效果如下图。
# 展示属性
切换日期视图:设置甘特图上横道图部分显示日期的维度,支持绑定变量值分别为d(日),w(周),m(月),y(年),来动态控制。
展示今日标记线:设置显示今日标记线。
# 事件
- 任务点击时:任务点击时触发。
- 刻度点击时:横道图时间刻度点击时触发。
# 方法
- 重新加载(load): 重新加载甘特图。
- 定位到今日标记线(changeToday):定位甘特图横道图部分到今日标记线。
# 样式
样式说明请参见组件通用说明。
# 常见问题
Q:数据属性中有哪些必填字段:
A:为保证甘特图的正常渲染,请配置必填字段:数据源、甘特图表格配置、文本字段、开始日期字段、持续时间字段、进度字段。以上几个属性为用于渲染甘特图的必要数据字段。而id字段、父级字段、数据颜色字段、图标字段用于个性化改变甘特图样式,没有相关需求可以不设置。
Q:工具提示怎么设置:
A:工具提示通过甘特图表格配置字段中的“是否显示工具提示”来设置,工具提示中会至少保证留文本字段,和开始日期,结束日期几个字段的显示。