!!!###!!!title=标记线——VisActor/VTable 教程文档!!!###!!!!!!###!!!description=VTable-Gantt组件支持在甘特图上添加标记线,标记线可以用于表示真个项目的重要时间节点。!!!###!!!

甘特图标记线

VTable-Gantt组件支持在甘特图上添加标记线,标记线可以用于表示真个项目的重要时间节点。

配置

markLine支持(boolean | IMarkLine | Array)类型,

  • boolean: 是否显示标记线,默认为false。标记线配置为false时,不显示标记线。
  • IMarkLine: 单个标记线配置
  • Array: 多个标记线配置

IMarkLine 配置项如下:

export interface IMarkLine {
  date: string;
  style?: ILineStyle;
  /** 标记线显示在日期列下的位置 默认为'left' */
  position?: 'left' | 'right' | 'middle' | 'date';
  /** 自动将日期范围内 包括改标记线 */
  scrollToMarkLine?: boolean;
  content?: string; // markLine中内容
  /** markLine中内容的样式 */
  contentStyle?: {
    color?: string;
    fontSize?: string;
    fontWeight?: string;
    lineHeight?: string;
    backgroundColor?: string;
    cornerRadius?: string;
  }
}

标记线样式

markLine的样式配置项示例如下:

const ganttOptions = {
  markLine: [
    {
      date: '2024-01-01',
      style: {
        color: 'red',
      },
    },
    {
      date: '2024-01-02',
      style: {
        color: 'blue',
      },
    },
  ],
};

## 标记线位置

markLine的位置配置支持'left' | 'right' | 'middle' | 'date'四种类型,

- 'left': 标记线显示在日期列的左侧
- 'right': 标记线显示在日期列的右侧
- 'middle': 标记线显示在日期列的中间
- 'date': 标记线显示在日期时刻的位置

## 标记线内容及样式

markLine的内容配置支持string类型,

- string: 标记线内容

markLine的内容样式配置支持ITaskBarLabelTextStyle类型,

- ITaskBarLabelTextStyle: 标记线内容样式

示例:

```javascript
const ganttOptions = {
  markLine: [
    {
      date: '2024-01-01',
      content: '项目启动',
      contentStyle: {
        color: 'red',
        fontSize: '16px',
        fontWeight: 'bold',
      },
    },
  ],
};  

甘特图是否自动滚动到标记线位置

markLine的滚动配置支持boolean类型,

  • boolean: 是否自动滚动到标记线

示例:

const ganttOptions = {
  markLine: [
    {
      date: '2024-01-01',
      scrollToMarkLine: true,
    },
  ],
};

正常如果日期 '2024-01-01'在甘特图的显示范围之外,当配置scrollToMarkLine: true时,甘特图会自动滚动到标记线位置。