3.6.0

Documentation~/en/changelog.md

@@ -2,6 +2,7 @@
 # 更新日志
 
 [master](#master)  
+[v3.6.0](#v360)  
 [v3.5.0](#v350)  
 [v3.4.0](#v340)  
 [v3.3.0](#v330)  
@@ -60,6 +61,41 @@
 
 ## master
 
+## v3.6.0
+
+* (2023.04.01) Release `v3.6.0` version
+* (2023.03.14) Fix for Tooltip's `titleFormater` setting `{b}` may not take effect
+* (2023.03.14) Fix for `BarChart` not drawing bar background when data is 0 (#250) (by __Ambitroc__)
+* (2023.03.12) Added `LabelStyle` `autoRotate` to set automatic rotation of angled vertical text
+* (2023.03.10) Added `VR` and other non-mouse input for Point location acquisition (#248) (by __Ambitroc__)
+* (2023.03.09) Adds callbacks to Chart's `onSerieClick`, `onSerieDown`, `onSerieEnter` and `onSerieExit`
+* (2023.03.09) Fixed click-check offset for `Pie` not taking effect
+* (2023.03.04) Added Positions for Legend to customize legend positions
+* (2023.03.03) Fixed `Animation` changing animation that might not work
+* (2023.02.28) Fixed issue with Serie's Label not refreshing when `Legend` is clicked
+* (2023.02.26) Adds DataZoom's `startEndFunction` delegate
+* (2023.02.12) Refactor the Component code and adjust the API
+* (2023.02.10) Fix `Axis` with incorrect minimum in `Log` axis in some cases
+* (2023.02.10) Optimizes the default display format of Axis's value Label
+* (2023.02.08) Added startLock and endLock for DataZoom
+* (2023.02.02) Fixed bug where datazoom xaxis label could be displayed off-chart when datazoom is turned on
+* (2023.02.02) Optimizes the `ignore` setting of `SerieData` to ignore data
+* (2023.02.01) Fix `XChartsMgr.ContainsChart()` interface exception
+* (2023.01.31) Added support for `InputSystem` (#242) (by __Bian-Sh__)
+* (2023.01.11) Fixed chart not refreshing after removing Component from Inspector (#241)
+* (2023.01.06) Fixed bug with `Pie` displaying abnormal Label when the last few values are 0 (#240)
+* (2023.01.03) deletes serie `MarkColor` and adds ItemStyle `MarkColor`
+* (2022.12.29) Added `+` to list editor
+* (2022.12.29) Fixed `UpdateXYData()` interface affecting data accuracy (#238)
+* (2022.12.28) Fixed abnormal display when setting `border` when `Pie` has only one data (#237)
+* (2022.12.22) Adjust `Covert` rename to `Convert`, involving interfaces such as: `ConvertXYAxis()`, `CovertSerie()`, etc
+* (2022.12.22) Fixed abnormal display of `Label` after `Convert XY Axis`
+* (2022.12.12) Fixed an issue where the `Value` Axis of `axis` calculated the value range incorrectly in some cases
+* (2022.12.12) Optimized legend's formatter to support `{h}` wildcards
+* (2022.12.12) Fixed abnormal display of Legend's formatter when set to a fixed value
+* (2022.12.08) Added `AreaStyle` `toTop` parameter to set whether the line graph gradient goes to the top or to the actual position
+* (2022.12.07) Adds text wildcard `{h}` for `Formatter` to support setting current color values
+
 ## v3.5.0
 
 Highlights:

Documentation~/en/configuration.md

@@ -1129,7 +1129,7 @@ Inherits or Implemented: [BaseSerie](#baseserie),[IComparable](#icomparable)
 |sampleType|||the type of sample.<br/>`SampleType`:<br/>- `Peak`: Take a peak. When the average value of the filter point is greater than or equal to 'sampleAverage', take the maximum value; If you do it the other way around, you get the minimum.<br/>- `Average`: Take the average of the filter points.<br/>- `Max`: Take the maximum value of the filter point.<br/>- `Min`: Take the minimum value of the filter point.<br/>- `Sum`: Take the sum of the filter points.<br/>|
 |sampleAverage|0||设定的采样平均值。当sampleType 为 Peak 时，用于和过滤数据的平均值做对比是取最大值还是最小值。默认为0时会实时计算所有数据的平均值。
 |lineType|||The type of line chart.<br/>`LineType`:<br/>- `Normal`: the normal line chart，<br/>- `Smooth`: the smooth line chart，<br/>- `StepStart`: step line.<br/>- `StepMiddle`: step line.<br/>- `StepEnd`: step line.<br/>|
-|smoothLimit|true|v3.4.0|Whether to restrict the curve. When true, the curve between two continuous data of the same value is restricted to not exceed the data point, and is flat to the data point.
+|smoothLimit|false|v3.4.0|Whether to restrict the curve. When true, the curve between two continuous data of the same value is restricted to not exceed the data point, and is flat to the data point.
 |barType|||柱形图类型。<br/>`BarType`:<br/>- `Normal`: normal bar.<br/>- `Zebra`: zebra bar.<br/>- `Capsule`: capsule bar.<br/>|
 |barPercentStack|false||柱形图是否为百分比堆积。相同stack的serie只要有一个barPercentStack为true，则就显示成百分比堆叠柱状图。
 |barWidth|0||The width of the bar. Adaptive when default 0.

Documentation~/zh/changelog.md

@@ -6,6 +6,7 @@ slug: /changelog
 # 更新日志
 
 [master](#master)  
+[v3.6.0](#v360)  
 [v3.5.0](#v350)  
 [v3.4.0](#v340)  
 [v3.3.0](#v330)  
@@ -65,6 +66,27 @@ slug: /changelog
 
 ## master
 
+## v3.6.0
+
+版本要点：
+
+* 增加`InputSystem`支持 (by __Bian-Sh__)
+* 增加官网[在线示例](https://xcharts-team.github.io/examples/)多版本支持 (by __SHL-COOL__)
+* 完善对`VR`的支持 (by __Ambitroc__)
+* 增加`UITable`，`UIStatistic`等[扩展UI组件](https://xcharts-team.github.io/docs/ui)
+* 增加`ItemStyle`的`MarkColor`
+* 增加通配符`{h}`的支持
+* 优化`Tooltip`，`Legend`，`DataZoom`，`Axis`等组件
+* 重构相关`API`接口，完善回调接口
+* 修复若干问题
+
+升级注意：
+
+* 部分接口有调整，可根据提示更换下接口即可。
+
+日志详情：
+
+* (2023.04.01) 发布`v3.6.0`版本
 * (2023.03.14) 修复`Tooltip`的`titleFormater`设置`{b}`可能不生效的问题
 * (2023.03.14) 修复`BarChart`在数据为0时不绘制柱条背景的问题 (#250) (by __Ambitroc__)
 * (2023.03.12) 增加`LabelStyle`的`autoRotate`可设置有角度的竖版文本的自动旋转

Documentation~/zh/configuration.md

@@ -1129,7 +1129,7 @@ Inherits or Implemented: [BaseSerie](#baseserie),[IComparable](#icomparable)
 |sampleType|||采样类型。当sampleDist大于0时有效。<br/>`SampleType`:<br/>- `Peak`: 取峰值。<br/>- `Average`: 取过滤点的平均值。<br/>- `Max`: 取过滤点的最大值。<br/>- `Min`: 取过滤点的最小值。<br/>- `Sum`: 取过滤点的和。<br/>|
 |sampleAverage|0||设定的采样平均值。当sampleType 为 Peak 时，用于和过滤数据的平均值做对比是取最大值还是最小值。默认为0时会实时计算所有数据的平均值。
 |lineType|||折线图样式类型。<br/>`LineType`:<br/>- `Normal`: 普通折线图。<br/>- `Smooth`: 平滑曲线。<br/>- `StepStart`: 阶梯线图：当前点。<br/>- `StepMiddle`: 阶梯线图：当前点和下一个点的中间。<br/>- `StepEnd`: 阶梯线图：下一个拐点。<br/>|
-|smoothLimit|true|v3.4.0|是否限制曲线。当为true时，两个连续相同数值的数据间的曲线会限制为不超出数据点，和数据点是平直的。
+|smoothLimit|false|v3.4.0|是否限制曲线。当为true时，两个连续相同数值的数据间的曲线会限制为不超出数据点，和数据点是平直的。
 |barType|||柱形图类型。<br/>`BarType`:<br/>- `Normal`: 普通柱形图。<br/>- `Zebra`: 斑马柱形图。<br/>- `Capsule`: 胶囊柱形图。<br/>|
 |barPercentStack|false||柱形图是否为百分比堆积。相同stack的serie只要有一个barPercentStack为true，则就显示成百分比堆叠柱状图。
 |barWidth|0||柱条的宽度，不设时自适应。支持设置成相对于类目宽度的百分比。

Documentation~/zh/support.md

@@ -11,17 +11,18 @@ slug: /support
 
 ## 订阅VIP服务
 
-订阅服务分个人订阅和企业订阅：
+订阅服务分`个人订阅`和`企业订阅`：
 
-- `个人`订阅：`个人VIP`属于个人，不可转让，`XCharts`团队只服务于订阅当事人。
-- `企业`订阅：`企业VIP`属于企业，席位内可安排固定职员，职员离职后席位可重新安排，`XCharts`团队通过专属企业群为企业服务。
+- `个人订阅`：`个人VIP`属于个人，不可转让，`XCharts`团队只服务于订阅当事人。
+- `企业订阅`：`企业VIP`属于企业，席位内可安排固定职员，职员离职后席位可重新安排，`XCharts`团队通过专属企业群为企业服务。
 
-订阅服务的优势？
+订阅服务有哪些优势？
 
-- 提高工作效率，节省时间成本。一方面，`XCharts`功能强大，相关配置项非常多，`VIP`服务可快速帮您定位，节省去查找和核对的时间；另一方面，`VIP`的即时回答服务可快速为您答疑解惑，避免中断开发流程。总之，订阅`VIP`可让您能快速上手，快速处理问题，至少能提高`10`倍以上的工作效率。
+- 提高工作效率，节省时间成本。一方面，`XCharts`功能强大，相关配置项非常多，`VIP`服务可快速帮您定位，节省去查找和核对的时间；另一方面，`VIP`的即时回答服务可快速为您答疑解惑，避免中断开发流程,快速上手，快速处理问题，至少能提高`10`倍以上的工作效率。
 - 更多技术交流，更多经验交流。`XCharts`团队成员从业多年，有丰富的技术和工作经验。`VIP`服务不仅可以交流`XCharts`相关的内容，也可以咨询其他方面的技术。`VIP`群也有更多的交流。
-- 扩展图表的需要订阅`VIP`服务后才能购买，扩展图表超过1年后的更新支持也需要持续订阅`VIP`服务。
-- `VIP`用户可加入`XCharts`的`GitHub`组织，参与`XCharts`社区构建，访问专有仓库。
+- 扩展图表需要订阅`VIP`服务后才能购买，扩展图表超过1年后的更新支持也需要持续订阅`VIP`服务。
+- `VIP`用户可加入`XCharts`的`GitHub`组织，参与`XCharts`的社区构建，访问专有仓库。拥有`扩展UI组件`等专属功能。
+- 在`XCharts交流群`里拥有`VIP`专属标识，问题会第一时间得到响应，有问即答。
 
 | |免费用户|付费咨询|个人`VIP` | 个人`SVIP` | 企业`VIP` |
 | ----- |--|--|--|--|--|
@@ -35,8 +36,7 @@ slug: /support
 | __`服务内容：`__|
 | 可商用           | √ | √ | √ | √ | √ |
 | 可二次开发        | √ | √ | √ | √ | √ |
-| 有问必答          |   | √ | √ | √ | √ |
-| 即时回答          |   | √ | √ | √ | √ |
+| 有问即答          |   | √ | √ | √ | √ |
 | 新手指导          |   | √ | √ | √ | √ |
 | 开发指导          |   | √ | √ | √ | √ |
 | 优化指导          |   | √ | √ | √ | √ |
@@ -45,7 +45,7 @@ slug: /support
 | 需求优先考虑       |   |   | √ | √ | √ |
 | 可另付费定制       |   |   | √ | √ | √ |
 | 可另付费加急       |   |   | √ | √ | √ |
-| VIP专有功能教程和文档 |   |   | √待开放 | √待开放 | √待开放 |
+| 扩展UI组件        |   |   | √ | √ | √ |
 | 扩展图表购买       |   |   | 按需购买 | __全部免费__ | __全部免费__ |
 | 扩展图表源码       |   |   | 永久持有 | 永久持有 | 永久持有 |
 | 扩展图表更新       |   |   | 1年更新支持 | 1年更新支持 | 1年更新支持 |
@@ -54,7 +54,7 @@ slug: /support
 
 扩展图表为另付费购买图表，只对订阅了`VIP`服务的用户开放购买。对于`SVIP`的订阅用户，所有扩展图表仓库可免费使用，不用再单独购买。
 
-对所有已购买的扩展图表，源码可永久持有，并获得持续一年的更新支持，一年后如需更新支持服务，需再继续订阅`VIP`服务。
+对所有已购买的扩展图表，源码可永久持有，并获得持续一年的更新支持，一年后如需更新支持服务，可再继续订阅`VIP`服务。
 
 |编号|扩展图表|价格|备注|
 |--|--|--|--|
@@ -73,11 +73,11 @@ slug: /support
 1. __`付费定制`__ 是指用户可根据自己的需求定制不同的图表或新功能，只有`VIP`用户才享有`付费定制`权利。
 2. __`付费加急`__ 是指用户可对自己非常紧急的需求进行付费，将开发优先级提到最高，并可要求在指定`截止日期`内交付，只有`VIP`用户才享有`付费加急`权利。
 3. __`付费咨询`__ 付费咨询有效期`7`天，且总咨询时长不超过`7`个小时。
-4. __`扩展图表`__ 购买后代码可永久持有和商用，1年的更新支持。
+4. __`扩展图表`__ 购买后代码可永久持有和商用，1年的更新和技术支持。
 
 ## 捐助支持
 
-如果这个项目对您有帮助，请右上方点 `Star` 予以支持！也欢迎任意金额的捐助，非常您的支持！
+如果这个项目对您有帮助，请右上方点 `Star` 予以支持！也欢迎任意金额的捐助，非常感谢您的支持！
 
 ## 二维码
 

README-en.md

@@ -110,7 +110,7 @@ A powerful, easy-to-use, configurable charting and data visualization library fo
 
 ![extendchart](Documentation~/en/img/readme_extendchart.png)
 
-For more examples, see [XCharts-Demo](https://github.com/XCharts-Team/XCharts-Demo), You can also go to [Online Demo](https://xcharts-team.github.io/demo/) to see the running effect of `WebGL`.
+For more examples, see [XCharts-Demo](https://github.com/XCharts-Team/XCharts-Demo), You can also go to [Online Demo](https://xcharts-team.github.io/examples/) to see the running effect of `WebGL`.
 
 ## Use
 

README.md

@@ -46,13 +46,14 @@
 一款基于`UGUI`的功能强大、简单易用的数据可视化图表插件。支持`折线图`、`柱状图`、`饼图`、`雷达图`、`散点图`、`热力图`、`环形图`、`K线图`、`极坐标`、`平行坐标`等十多种内置图表，以及`3D饼图`、`3D柱图`、`3D金字塔`、`漏斗图`、`仪表盘`、`水位图`、`象形柱图`、`甘特图`、`矩形树图`等扩展图表。
 
 [XCharts3.0 官方主页](https://xcharts-team.github.io)
+[XCharts3.0 在线示例](https://xcharts-team.github.io/examples)
 
-[XCharts3.0 教程](Documentation~/zh/tutorial01.md)  
-[XCharts3.0 API](Documentation~/zh/api.md)  
-[XCharts3.0 问答](Documentation~/zh/faq.md)  
-[XCharts3.0 配置项手册](Documentation~/zh/configuration.md)  
-[XCharts3.0 更新日志](Documentation~/zh/changelog.md)  
-[XCharts3.0 订阅服务](Documentation~/zh/support.md)  
+[XCharts3.0 教程](Documentation~/zh/tutorial01.md)
+[XCharts3.0 API](Documentation~/zh/api.md)
+[XCharts3.0 问答](Documentation~/zh/faq.md)
+[XCharts3.0 配置项手册](Documentation~/zh/configuration.md)
+[XCharts3.0 更新日志](Documentation~/zh/changelog.md)
+[XCharts3.0 订阅服务](Documentation~/zh/support.md)
 
 ## 特性
 
@@ -78,48 +79,22 @@
 
 ![扩展图表](Documentation~/zh/img/readme_extendchart.png)
 
-XCharts不再内置Demo，Demo已独立出单独的仓库 [XCharts-Demo](https://github.com/XCharts-Team/XCharts-Demo)，也可以在浏览器查看`WebGL`下的运行效果 [在线Demo](https://xcharts-team.github.io/demo/) 。
-
-## `XCharts3.0`
-
-- 增加`Time`时间轴。
-- 增加`SingleAxis`单轴。
-- 增加多种坐标系：`Grid`、`Polar`、`Radar`、`SingleAxis`。
-- 增加多种动画方式。
-- 增加多种图表交互。
-- 增加国际化支持。
-- 增加`Widgets`小组件。
-- 增加多种扩展图表。
-
-## `XCharts3.0` 相比 `XCharts2.0`
-
-- 更健壮的底层框架。
-- 更强大的性能。
-- 更小的序列化文件。
-- 更好的交互体验。
-- 更多的组件支持。
-- 更强大的文本自述能力。
-- 更合理的组件调整。
-- 更灵活的组件插拔。
-- 更高效的二次开发。
-- 更丰富的Demo示例。
-
 ![XCharts 3.0和2.0的对比](Documentation~/zh/img/readme_xcharts3.png)
 
 ## 注意
 
-- `XCharts3.0` 不完全兼容 `XCharts2.0` 版本，升级`3.0`可能需要调整部分代码和配置。建议旧项目可以继续使用`XCharts2.0`，新项目推荐使用`XCharts3.0`。
-- `XCharts2.0` 进入维护阶段，后续只修复严重`bug`，理论上不再加新功能。
+- `XCharts3.0` 不完全兼容 `XCharts2.0` 版本，升级`3.0`可能需要调整部分代码，图表部分配置需要重新调整。建议旧项目可以继续使用`XCharts2.0`，新项目推荐使用`XCharts3.0`。
+- `XCharts2.0` 进入维护阶段，后续只修复严重`bug`，原则上不再加新功能。
 - `XCharts` 理论上支持`Unity 5.6`及以上版本，但由于版本测试有限难免疏漏，发现版本兼容问题可提`Issue`。
-- 本仓库只包含`XCharts`源码，不包含`Demo`示例部分。需要查看`Demo`请到[XCharts-Demo](https://github.com/XCharts-Team/XCharts-Demo)仓库。
+- 本仓库只包含`XCharts`源码，不包含`Demo`示例部分。需要查看`Demo`示例源码请到[XCharts-Demo](https://github.com/XCharts-Team/XCharts-Demo)仓库。也可以在浏览器查看`WebGL`下的运行效果 [在线Demo](https://xcharts-team.github.io/examples/) 。
 
 ## 使用
 
 1. 导入`XCharts`的`unitypackage`或者源码到项目。
 2. 在`Hierarchy`视图下右键选择`XCharts->LineChart`，即可创建一个默认的折线图。
 3. 在`Inspector`视图可以调整各个组件的参数，`Game`视图可看到实时效果。
 
-- 更多使用细节，请看：[XCharts教程：5分钟上手教程](Documentation~/zh/tutorial01.md)
+- 更多细节，请看：[XCharts教程：5分钟上手教程](Documentation~/zh/tutorial01.md)
 - 首次使用，建议先认真看一遍教程。
 
 ## 分支
@@ -131,13 +106,18 @@ XCharts不再内置Demo，Demo已独立出单独的仓库 [XCharts-Demo](https:/
 - `1.0`：XCharts 1.0的稳定分支。带Demo，不再维护。
 - `1.0-upm`：XCharts 1.0的稳定UMP分支。不带Demo，不再维护。
 
+## 扩展
+
+- [扩展图表](https://xcharts-team.github.io/docs/extra) 扩展图表订阅`VIP`后再按需购买，订阅详情请查看[☞ 看这里](Documentation~/zh/support.md)
+- [扩展组件](https://xcharts-team.github.io/docs/ui) 扩展组件订阅`VIP`后即可免费使用。
+
 ## FAQ
 
 1. `XCharts`可以免费使用吗？  
    答：`XCharts`使用`MIT`协议，可以免费使用。也可以订阅`VIP`享受更多增值服务。
 
 2. `XCharts`支持代码动态添加和修改数据吗？支持从`Excel`或数据库中获取数据吗？  
-   答：`XCharts`提供了各种数据操作的接口，支持代码动态修改配置，添加和修改数据，但数据来源需要自己解析或获取，再调用`XCharts`的接口添加到`XCharts`。
+   答：`XCharts`提供了各种数据操作的接口，支持代码动态修改配置，添加和修改数据，但数据来源需要自己解析和获取，再调用`XCharts`的接口添加到图表。
 
 3. 这个插件除了用在`Unity`，还能用在其他平台（如`Winform`或`WPF`）吗？  
    答：目前只支持在`Unity`平台使用。理论上任何支持`UGUI`的`Unity`版本都能运行`XCharts`。
@@ -161,4 +141,4 @@ XCharts不再内置Demo，Demo已独立出单独的仓库 [XCharts-Demo](https:/
 - 邮箱：`[email protected]`  
 - QQ群：XCharts交流群（`202030963`）  
 - VIP群：XCharts技术支持VIP群（`867291970`）  
-- 捐助、合作和技术支持：[☞ 看这里](Documentation~/zh/support.md)
+- 捐助、合作、订阅和技术支持：[☞ 看这里](Documentation~/zh/support.md)