Infer component

[Aarebecca]

Component 可选组件

⚠️ Tooltip 不在此范围内
Scrollable、Timeline 需要用户手动指定，不在推断范围中

组件	细分	说明
Axis	Linear	直线坐标轴
	Arc	弧线坐标轴
	Helix	螺旋坐标轴(todo)
Legend	Category	分类图例
	Continuous	连续图例
Scrollable	Slider	缩略轴
	Scrollbar	滚动条
Timeline		时间轴(todo)

组件推断

目前来说，组件推断主要依据三个条件：通道(Channel)、坐标系(Coordinate)、比例尺(Scale)。
例如坐标轴可以通过当前坐标系来确定是直角坐标系还是极坐标系下的轴类型，并依据通道、是否转置等条件进行进一步推断。

Channel 通道

G2 5.0 目前可视相关的通道包括：

通道	说明
x, x1
y, y1
series
color	颜色
size	尺寸
opacity	透明度
shape	形状

坐标系

G2 5.0 目前支持的坐标系和坐标系变换包括：

坐标系	说明
cartesian	直角坐标系(笛卡尔坐标系)
polar	极坐标系
parrallel	平行坐标系
helix	螺旋变换
theta	角度变换
radial	径向变换
transpose	转置
reflect	镜像反转(沿中心点)
reflectX	沿 X 轴反转
reflectY	沿 Y 轴反转
fisheye	鱼眼变换
fisheyeX	鱼眼变换(X 轴方向)
fisheyeY	鱼眼变换(Y 轴方向)

Scale 比例尺

目前 G2 5.0 提供了 14 种比例尺：

类型	比例尺	说明
连续比例尺	Linear	线性比例尺
	Identity	等比比例尺
	Log	对数比例尺
	Pow	指数比例尺
	Sqrt	平方数比例尺
	Sequential	连续比例尺
	Time	时间比例尺
分类比例尺	Threshold	阈值比例尺
	Quantize	等比例比例尺
	Quantile	等分位比例尺
离散比例尺	Ordinal	序数比例尺
	Band	分段比例尺
	Point	点比例尺

组件推断

组件类型推断

基于通道+坐标系推断

可推断组件：Axis

坐标系\通道	x	x1	y	y1	说明
直角坐标系	axisX	axisX	axisY	axisY	转置取反
极坐标系	arc	arc	axisY	axisY
平行坐标系	axisX		axisY		转置取反

基于通道+比例尺推断

可推断组件：category、continuous，其中连续图例根据类型可细分为：

• continuous 默认类型
• continuousSize 尺寸类型
• continuousBlock 分块类型
• continuousSizeBlock 尺寸分块类型

比例尺\通道	color	size	opacity	shape
连续比例尺 (不含时间比例尺)	continuous	continuousSize	continuous	/
分类比例尺	continuousBlock	continuousBlockSize	continuousBlock	/
离散比例尺	category	category	category	category

组件位置

top、bottom、left、right 即可描述大多数组件相对于可视化主体元素的位置。

⚠️ 直角坐标系下的坐标轴理论上应当于其所描述的元素对齐。
在极坐标系下，需要考虑Axis是位于环内还是环外

type PrimitivePosition = 'top' | 'bottom' | 'left' | 'right' | 'center' | 'inner' | 'outer';
type Position = PrimitivePosition | `${PrimitivePosition}-${PrimitivePosition}`

此外，大多数组件是具有方向性的，即水平朝向Horizontal和垂直朝向Vertical。

⚠️ 对于一些组件来说，可选的方向与其所在的位置是有密切关联的
例如直角坐标系下位于left、right位置的坐标轴、缩略轴和滚动条，其方向一定是vertical朝向的，因此对这类组件设置Orientation则不会生效
此外， Orientation 支持设定一个数值来指定其朝向。

type Orientation = 'Horizontal' | 'Vertical' | number;

⚠️ 平行坐标系下，Anchor、Align、Orientation对坐标轴组件无效。

⚠️ 极坐标系下通常同时具有直线坐标轴和弧线坐标轴，配置Align对直线坐标轴无效，
配置Orientation对弧线坐标轴无效。

组件位置推断

Axis 位置推断

坐标轴的 Position 通常来说仅支持基本的 Primitive Position , 不支持复合 Position
⚠️ 极坐标系下 linear axis 还取决于其角度，若在 angle % 180 === 0 则应当为 axisX, angle % 90 === 0 则为 axisY。

坐标系	Position	Orientation	组件/(转置时)	说明
直角坐标系	left / right	-	axisY (axisX)	直线坐标轴
	top / bottom	-	axisX (axisY)	直线坐标轴
极坐标系	center	'horizontal' | 'vertical' | number	axisY (axisX)	直线坐标轴
	inner / outer	-	axisArc	弧线坐标轴
平行坐标系	center	'horizontal' | 'vertical'	axisX / axisY	常规平行坐标图
	center	number	axisLinear	雷达图

通用组件位置推断

组件位置默认为：

{
  position: 'top',
  orientation: 'horizontal'
}

其余位置需要用户手动指定。

[pearmini]

这个梳理的挺好的，等 2 月份重构的时候可以再深入讨论一下