Chart.md

Chart 图表

Requirements 前置条件

Data和UI绑定

Caution 破坏性更新

[1.9.0]版本有一个破坏性变更。
在1.9.0之前图表是支持自动扩大的。但是出于实际使用的体验来说，去掉了这个特性，以支持样式继承和组合图表。
建议在模板里设置图表示例的时候，多设置几个系列。因为不能扩大，但是可以缩。

Tips 特别提示

A2:A5是categories，B1:D1是series。
B2:D5才是data部分（上图马克笔标记部分）

调用setData(List list)来设置数据的时候，请注意data只应包含数据。
考虑到java的习惯，我们也提供了setDataWithCategories(List list, String categoryField)来方便使用。

定制化函数钩子

图表是个非常常用的组件。
有时也会有一些定制化需求，比如说以年为范围，以月为维度，展示一个条形图。
那么条形图最少的时候是1月，只有1个柱。
条形图最多的时候是12月，有12个柱。
假如要求高亮当前月（以一个不同的颜色表示当前月），即最后一个柱子，在模板上是不好设置的。
因此增加了一个定制化函数钩子，可以在里面实现一些风格的定制化。
具体代码可以参见src/test/java/io/gitee/jinceon/core/data/ChartDataProcessorHookTest.java

SimpleEngine engine = new SimpleEngine("src/test/resources/chart-hook.pptx");
DataSource dataSource = new DataSource();
Chart chartA = ....();
chartA.setCustomizeFunction(xslfChart -> {
    xslfChart.getChartSeries().get(0).getSeries(0)
        .getDataPoint(8) // 因此示例里是9个月的数据，所有最后一个月下标是8
        .setFillProperties(new XDDFSolidFillProperties(XDDFColor.from(100_000, 0, 0)));
    });
dataSource.setVariable("chartA", chartA);
engine.setDataSource(dataSource);
engine.process();
engine.save("src/test/resources/test-chart-hook.pptx");