MDCharts #

march.dev charts library. Provides highly customizable and configurable charts.

Getting Started #

LineChart #

Data

• REQUIRED data

  • data - set of data with DateTime keys and double values based on which chart will be drawned.

• There are 2 general types of the LineChart:

  • Periodical grid type (only monthly available for now):

    Periodical means that if there's not enough data to draw full chart (there's gaps between dates) chart will automatically fulfill lacking data based on LineChartDataType.

    • For LineChartDataType.bidirectional data type lacking data will be set to 0.

    • For LineChartDataType.unidirectional data type lacking data will calculated from previous values so, that charts will be looking like ascending (e.g. Progress) or descending (e.g. Burndown) chart.

  • Undefined grid type:

    Undefined means that the chart will be drawned using only provided data.

    Note that LineChartDataType is omitted with this type of grid.

• Limits

  • limit - if provided will be painted on the chart as a horizontal indication line.
  • limitText - custom text to set to the label of the limit line.

  Note that if limitText is set without provided limit, there will be no limit line.

• Tooltip builders

  • titleBuilder - builds title of the tooltip based on DateTime key and/or double value from provided data.
  • subtitleBuilder - builds subtitle of the tooltip based on DateTime key and/or double value from provided data.

• Label builder

  • xAxisLabelBuilder - builds X axis label based on DateTime value from provided data.

Settings

• xAxisDivisions - quantity of the X axis divisions, defaults to 3.
• yAxisDivisions - quantity of the Y axis divisions, defaults to 2.
• showAxisX - whether to show X axis or not, defaults to true.
• showAxisY - whether to show Y axis or not, defaults to true.
• lineFilling - whether to fill chart between the line and the X axis or not, defaults to true.
• lineShadow - whether to draw shadow beneath the line or not, defaults to true.
• altitudeLine - whether to draw the altitude line or not, defaults to true.
• showAxisXLabels - whether to show labels on the X axis or not, defaults to true.

Styles

• gridStyle - styling options for the grid, for more details please refer to the source code of the LineChartGridStyle.
• axisStyle - styling options for the axis, for more details please refer to the source code of the LineChartAxisStyle.
• lineStyle - styling options for the chart line, for more details please refer to the source code of the LineChartLineStyle.
• limitStyle - styling options for the limit, for more details please refer to the source code of the LineChartLimitStyle.
• pointStyle - styling options for the point and tooltip above point, for more details please refer to the source code of the LineChartPointStyle.

Examples #

To see usage example navigate to the Example section.

Feature requests and Bug reports #

Feel free to post a feature requests or report a bug here.