增加GridLayout网格布局组件

2026-05-24 18:00:26 +00:00 · 2023-08-29 18:30:11 +08:00
parent e0f6b8c2dc
commit e4fbe5670f
31 changed files with 399 additions and 51 deletions
--- a/Documentation~/zh/api.md
+++ b/Documentation~/zh/api.md
@@ -34,6 +34,7 @@ slug: /api
 - [DefineSymbolsUtil](#definesymbolsutil)
 - [FormatterHelper](#formatterhelper)
 - [GridCoordContext](#gridcoordcontext)
+- [GridLayoutContext](#gridlayoutcontext)
 - [HeatmapChart](#heatmapchart)
 - [IgnoreDoc](#ignoredoc)
 - [INeedSerieContainer](#ineedseriecontainer)
@@ -500,7 +501,7 @@ slug: /api
 |GetTextHeight()||public float GetTextHeight()|
 |GetTextWidth()||public float GetTextWidth()|
 |GetWidth()||public float GetWidth()|
-|IsActive()||public override bool IsActive()|
+|IsActiveByScale()||public bool IsActiveByScale()|
 |SetActive()||public void SetActive(bool flag)|
 |SetIcon()||public void SetIcon(Image image)|
 |SetIconActive()||public void SetIconActive(bool flag)|
@@ -516,7 +517,7 @@ slug: /api
 |SetTextColor()||public void SetTextColor(Color color)|
 |SetTextPadding()||public void SetTextPadding(TextPadding padding)|
 |SetTextRotate()||public void SetTextRotate(float rotate)|
-|UpdateIcon()||public void UpdateIcon(IconStyle iconStyle, Sprite sprite = null)|
+|UpdateIcon()||public void UpdateIcon(IconStyle iconStyle, Sprite sprite = null, Color color = default(Color))|

 ## ChartObject

@@ -633,6 +634,10 @@ slug: /api

 > XCharts.Runtime.GridCoordContext : [MainComponentContext](#maincomponentcontext)

+## GridLayoutContext
+
+> XCharts.Runtime.GridLayoutContext : [MainComponentContext](#maincomponentcontext)
+
 ## HeatmapChart

 > XCharts.Runtime.HeatmapChart : [BaseChart](#basechart)
@@ -668,9 +673,8 @@ slug: /api
 |SetColor()||public void SetColor(ref bool needInteract, Color32 color)|
 |SetColor()||public void SetColor(ref bool needInteract, Color32 color, Color32 toColor)|
 |SetPosition()||public void SetPosition(ref bool needInteract, Vector3 pos)|
-|SetValue()||public void SetValue(float value)|
-|SetValue()||public void SetValue(ref bool needInteract, float value)|
 |SetValue()||public void SetValue(ref bool needInteract, float value, bool highlight, float rate = 1.3f)|
+|SetValue()||public void SetValue(ref bool needInteract, float value, bool previousValueZero = false)|
 |SetValueAndColor()||public void SetValueAndColor(ref bool needInteract, float value, Color32 color)|
 |SetValueAndColor()||public void SetValueAndColor(ref bool needInteract, float value, Color32 color, Color32 toColor)|
 |ToString()||public override string ToString()|
@@ -707,7 +711,7 @@ slug: /api

 ## IUpdateRuntimeData

-> XCharts.Runtime.IUpdateRuntimeData / Subclasses: [SingleAxis](#singleaxis),[DataZoom](#datazoom),[CalendarCoord](#calendarcoord),[GridCoord](#gridcoord),[ParallelCoord](#parallelcoord) 
+> XCharts.Runtime.IUpdateRuntimeData / Subclasses: [SingleAxis](#singleaxis),[DataZoom](#datazoom),[CalendarCoord](#calendarcoord),[GridCoord](#gridcoord),[GridLayout](#gridlayout),[ParallelCoord](#parallelcoord) 

 ## LayerHelper

@@ -790,7 +794,7 @@ slug: /api

 ## MainComponentContext

-> XCharts.Runtime.MainComponentContext / Subclasses: [AxisContext](#axiscontext),[DataZoomContext](#datazoomcontext),[LegendContext](#legendcontext),[RadarCoordContext](#radarcoordcontext),[VisualMapContext](#visualmapcontext),[GridCoordContext](#gridcoordcontext),[ParallelCoordContext](#parallelcoordcontext),[PolarCoordContext](#polarcoordcontext) 
+> XCharts.Runtime.MainComponentContext / Subclasses: [AxisContext](#axiscontext),[DataZoomContext](#datazoomcontext),[LegendContext](#legendcontext),[RadarCoordContext](#radarcoordcontext),[VisualMapContext](#visualmapcontext),[GridCoordContext](#gridcoordcontext),[GridLayoutContext](#gridlayoutcontext),[ParallelCoordContext](#parallelcoordcontext),[PolarCoordContext](#polarcoordcontext) 

 ## MainComponentHandler

@@ -1149,11 +1153,11 @@ serie事件的数据。
 |GetSerieState()||public static SerieState GetSerieState(SerieData serieData)|
 |GetSerieSymbol()||public static SerieSymbol GetSerieSymbol(Serie serie, SerieData serieData, SerieState state = SerieState.Auto)|
 |GetStateStyle()||public static StateStyle GetStateStyle(Serie serie, SerieData serieData, SerieState state)|
-|GetSysmbolSize()||public static float GetSysmbolSize(Serie serie, SerieData serieData, float defaultSize, SerieState state = SerieState.Auto)|
+|GetSysmbolSize()||public static float GetSysmbolSize(Serie serie, SerieData serieData, float defaultSize, SerieState state = SerieState.Auto, bool checkAnimation = false)|
 |GetTitleStyle()||public static TitleStyle GetTitleStyle(Serie serie, SerieData serieData)|
 |IsAllZeroValue()||public static bool IsAllZeroValue(Serie serie, int dimension = 1)<br/>系列指定维数的数据是否全部为0。 |
 |IsDownPoint()||public static bool IsDownPoint(Serie serie, int index)|
-|UpdateCenter()||public static void UpdateCenter(Serie serie, Vector3 chartPosition, float chartWidth, float chartHeight)<br/>更新运行时中心点和半径 |
+|UpdateCenter()||public static void UpdateCenter(Serie serie, BaseChart chart)<br/>更新运行时中心点和半径 |
 |UpdateFilterData()||public static void UpdateFilterData(Serie serie, DataZoom dataZoom)<br/>根据dataZoom更新数据列表缓存 |
 |UpdateMinMaxData()||public static void UpdateMinMaxData(Serie serie, int dimension, double ceilRate = 0, DataZoom dataZoom = null)<br/>获得指定维数的最大最小值 |
 |UpdateRect()||public static void UpdateRect(Serie serie, Vector3 chartPosition, float chartWidth, float chartHeight)|
@@ -1165,12 +1169,9 @@ serie事件的数据。

 |public method|since|description|
 |--|--|--|
-|AvoidLabelOverlap()||public static void AvoidLabelOverlap(Serie serie, ComponentTheme theme)|
 |CanShowLabel()||public static bool CanShowLabel(Serie serie, SerieData serieData, LabelStyle label, int dimesion)|
 |GetLabelColor()||public static Color GetLabelColor(Serie serie, ThemeStyle theme, int index)|
-|GetRealLabelPosition()||public static Vector3 GetRealLabelPosition(Serie serie, SerieData serieData, LabelStyle label, LabelLine labelLine)|
 |SetGaugeLabelText()||public static void SetGaugeLabelText(Serie serie)|
-|UpdatePieLabelPosition()||public static void UpdatePieLabelPosition(Serie serie, SerieData serieData)|

 ## SerieLabelPool

@@ -1306,6 +1307,10 @@ UGUI 图形库
 |DrawDiamond()||public static void DrawDiamond(VertexHelper vh, Vector3 center, float size, Color32 color, Color32 toColor)<br/>Draw a diamond. 画菱形（钻石形状） |
 |DrawDiamond()||public static void DrawDiamond(VertexHelper vh, Vector3 center, float xRadius, float yRadius, Color32 color, Color32 toColor)|
 |DrawEllipse()||public static void DrawEllipse(VertexHelper vh, Vector3 center, float w, float h, Color32 color, float smoothness = 1)|
+|DrawEmptyDiamond()||public static void DrawEmptyDiamond(VertexHelper vh, Vector3 center, float xRadius, float yRadius, float tickness, Color32 color)|
+|DrawEmptyDiamond()||public static void DrawEmptyDiamond(VertexHelper vh, Vector3 center, float xRadius, float yRadius, float tickness, Color32 color, Color32 emptyColor)|
+|DrawEmptyTriangle()||public static void DrawEmptyTriangle(VertexHelper vh, Vector3 pos, float size, float tickness, Color32 color)|
+|DrawEmptyTriangle()||public static void DrawEmptyTriangle(VertexHelper vh, Vector3 pos, float size, float tickness, Color32 color, Color32 backgroundColor)|
 |DrawLine()||public static void DrawLine(VertexHelper vh, List&lt;Vector3&gt; points, float width, Color32 color, bool smooth, bool closepath = false)|
 |DrawLine()||public static void DrawLine(VertexHelper vh, Vector3 startPoint, Vector3 endPoint, float width, Color32 color)<br/>Draw a line. 画直线 |
 |DrawLine()||public static void DrawLine(VertexHelper vh, Vector3 startPoint, Vector3 endPoint, float width, Color32 color, Color32 toColor)<br/>Draw a line. 画直线 |
--- a/Documentation~/zh/changelog.md
+++ b/Documentation~/zh/changelog.md
@@ -78,6 +78,7 @@ slug: /changelog

 日志详情：

+* (2023.08.29) 增加`GridLayout`网格布局组件用于管理多个`GridCoord`的布局
 * (2023.08.25) 修复`MarkLine`多个时只显示一个`Label`的问题
 * (2023.08.25) 修复`MarkLine`在开启`Clip`后还绘制在坐标系外的问题
 * (2023.08.24) 优化`YAxis`在数据全为0时默认设置0-1的范围
--- a/Documentation~/zh/configuration.md
+++ b/Documentation~/zh/configuration.md
@@ -56,6 +56,7 @@ import APITable from '@site/src/components/APITable';
 - [CoordSystem](#coordsystem)
 - [DataZoom](#datazoom)
 - [GridCoord](#gridcoord)
+- [GridLayout](#gridlayout)
 - [Legend](#legend)
 - [MarkArea](#markarea)
 - [MarkLine](#markline)
@@ -952,6 +953,7 @@ Drawing grid in rectangular coordinate. Line chart, bar chart, and scatter chart
 |field|default|since|comment|
 |--|--|--|--|
 |show|true||是否显示直角坐标系网格。
+|layoutIndex|-1|v3.8.0|
 |left|0.1f||grid 组件离容器左侧的距离。
 |right|0.08f||grid 组件离容器右侧的距离。
 |top|0.22f||grid 组件离容器上侧的距离。
@@ -965,6 +967,34 @@ Drawing grid in rectangular coordinate. Line chart, bar chart, and scatter chart
 </APITable>
 ```

+## GridLayout
+
+> XCharts.Runtime.GridLayout : [MainComponent](#maincomponent), [IUpdateRuntimeData](#iupdateruntimedata)
+
+> 从 `v3.8.0` 开始支持
+
+网格布局组件。用于管理多个`GridCoord`的布局，可以通过`row`和`column`来控制网格的行列数。
+
+```mdx-code-block
+<APITable name="GridLayout">
+```
+
+
+|field|default|since|comment|
+|--|--|--|--|
+|show|true||是否显示直角坐标系网格。
+|left|0.1f||grid 组件离容器左侧的距离。
+|right|0.08f||grid 组件离容器右侧的距离。
+|top|0.22f||grid 组件离容器上侧的距离。
+|bottom|0.12f||grid 组件离容器下侧的距离。
+|row|2||网格布局的行数。
+|column|2||网格布局的列数。
+|spacing|Vector2.zero||网格布局的间距。
+
+```mdx-code-block
+</APITable>
+```
+
 ## Heatmap

 > XCharts.Runtime.Heatmap : [Serie](#serie), [INeedSerieContainer](#ineedseriecontainer)
@@ -1142,7 +1172,7 @@ Drawing grid in rectangular coordinate. Line chart, bar chart, and scatter chart

 ## IUpdateRuntimeData

-> XCharts.Runtime.IUpdateRuntimeData / Subclasses: [SingleAxis](#singleaxis), [DataZoom](#datazoom), [CalendarCoord](#calendarcoord), [GridCoord](#gridcoord), [ParallelCoord](#parallelcoord)
+> XCharts.Runtime.IUpdateRuntimeData / Subclasses: [SingleAxis](#singleaxis), [DataZoom](#datazoom), [CalendarCoord](#calendarcoord), [GridCoord](#gridcoord), [GridLayout](#gridlayout), [ParallelCoord](#parallelcoord)

 ## LabelLine

@@ -1160,7 +1190,7 @@ Drawing grid in rectangular coordinate. Line chart, bar chart, and scatter chart
 |show|true||是否显示视觉引导线。
 |lineType|||视觉引导线类型。<br/>`LabelLine.LineType`:<br/>- `BrokenLine`: 折线<br/>- `Curves`: 曲线<br/>- `HorizontalLine`: 水平线<br/>|
 |lineColor|Color32(0,0,0,0)||视觉引导线颜色。默认和serie一致取自调色板。
-|lineAngle|60||视觉引导线的固定角度。对折线和曲线有效。
+|lineAngle|60||视觉引导线的固定角度。对折线和曲线有效。在Pie中无效。
 |lineWidth|1.0f||视觉引导线的宽度。
 |lineGap|1.0f||视觉引导线和容器的间距。
 |lineLength1|25f||视觉引导线第一段的长度。
@@ -1385,7 +1415,7 @@ Drawing grid in rectangular coordinate. Line chart, bar chart, and scatter chart

 ## MainComponent

-> XCharts.Runtime.MainComponent : [IComparable](https://docs.unity3d.com/ScriptReference/30_search.html?q=IComparable) / Subclasses: [Axis](#axis), [Background](#background), [Comment](#comment), [DataZoom](#datazoom), [Legend](#legend), [MarkArea](#markarea), [MarkLine](#markline), [Settings](#settings), [Title](#title), [Tooltip](#tooltip), [VisualMap](#visualmap), [CoordSystem](#coordsystem)
+> XCharts.Runtime.MainComponent : [IComparable](https://docs.unity3d.com/ScriptReference/30_search.html?q=IComparable) / Subclasses: [Axis](#axis), [Background](#background), [Comment](#comment), [DataZoom](#datazoom), [Legend](#legend), [MarkArea](#markarea), [MarkLine](#markline), [Settings](#settings), [Title](#title), [Tooltip](#tooltip), [VisualMap](#visualmap), [GridLayout](#gridlayout), [CoordSystem](#coordsystem)

 ## MarkArea

@@ -1704,6 +1734,7 @@ Radar coordinate conponnet for radar charts. 雷达图坐标系组件，只适
 |polarIndex|0||所使用的 polar 组件的 index。
 |singleAxisIndex|0||所使用的 singleAxis 组件的 index。
 |parallelIndex|0||所使用的 parallel coord 组件的 index。
+|gridIndex|-1|v3.8.0|所使用的 layout 组件的 index。 默认为-1不指定index, 当为大于或等于0时, 为第一个layout组件的第index个格子。
 |minShow|||系列所显示数据的最小索引
 |maxShow|||系列所显示数据的最大索引
 |maxCache|||系列中可缓存的最大数据量。默认为0没有限制，大于0时超过指定值会移除旧数据再插入新数据。