!!!###!!!title=Gantt Markline——VisActor/VTable tutorial documents!!!###!!!!!!###!!!description=VTable-Gantt component supports adding mark lines on the Gantt chart, which can be used to represent important time nodes of the entire project.!!!###!!!

Gantt Mark Line

VTable-Gantt component supports adding mark lines on the Gantt chart, which can be used to represent important time nodes of the entire project.

Configuration

markLine supports (boolean | IMarkLine | Array) type,

  • boolean: Whether to display the mark line, the default is false. When the mark line configuration is false, the mark line is not displayed.
  • IMarkLine: Single mark line configuration
  • Array: Multiple mark line configurations

The configuration items of IMarkLine are as follows:

export interface IMarkLine {
  date: string;
  style?: ILineStyle;
  /** The position of the mark line under the date column. The default is 'left'. */
  position?: 'left' | 'right' | 'middle' | 'date';
    /** Automatically scroll the date range to include this mark line. */
  scrollToMarkLine?: boolean;
  content?: string; // markLine中内容
  /** The style of the content in the markLine. */
  contentStyle?: {
    color?: string;
    fontSize?: string;
    fontWeight?: string;
    lineHeight?: string;
    backgroundColor?: string;
    cornerRadius?: string;
  }
}

Mark Line Style

The configuration example of the mark line style is as follows:

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

## Mark Line Position

The position configuration of markLine supports 'left' | 'right' | 'middle' | 'date' four types,

- 'left': The mark line is displayed on the left of the date column
- 'right': The mark line is displayed on the right of the date column
- 'middle': The mark line is displayed in the middle of the date column
- 'date': The mark line is displayed in the position of the date column

## Mark Line Content and Style

The content configuration of markLine supports string type,

- string: Mark line content

The content style configuration of markLine supports ITaskBarLabelTextStyle type,

- ITaskBarLabelTextStyle: Mark line content style

Example:

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

Whether the Gantt chart automatically scrolls to the mark line position

The scroll configuration of markLine supports boolean type,

  • boolean: Whether to automatically scroll to the mark line

Example:

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

Normally, if the date '2024-01-01' is outside the display range of the Gantt chart, when the scrollToMarkLine: true configuration is set, the Gantt chart will automatically scroll to the mark line position.