Column

简介

柱状图（Column）是一种以矩形条的高度来表示数据大小的可视化图表，用于展示不同类别之间的比较或显示数据分布。

代码演示

更多示例详见柱状图

基础用法

背景色

柱子颜色

通过配置 style.fill 设置柱子颜色，也可以使用 colorField 结合 scale.color.range: ['color1', 'color2', xx] 实现。

分组柱状图

通过 group: true 实现，可配置为对象调整分组间距离。

堆叠柱状图

通过 stack: true 实现，并通过 interaction.tooltip.render 实现自定义提示。

转化率柱状图

通过 conversionTag 实现。

conversionTag: {
  size: 40,
  spacing: 4,
  text: {
    formatter: (prev, next) => `${((next / prev) * 100).toFixed(1)}%`,
  },
},

自定义轴标签

配置项

通用属性参考：通用配置

概览

配置项	说明	类型	默认值
data	数据	Array	[]
xField	横轴字段	string	-
yField	纵轴字段	string \| string[]	-
seriesField	多柱状图区分字段	string（可选）	-
colorField	和 seriesField 类似，不过会加上颜色通道，详见color	string（可选）	-
stack	柱状图是否堆叠	boolean\|Stack	false
group	柱状图是否分组	boolean\|Group	false
percent	堆叠状态下柱状图是否百分比展示	boolean	false
conversionTag	转化率配置	conversionTag	-
markBackground	元素背景配置，和配置柱子无区别，可以看做是放置于底层的 Column 组件，需要配置 `scale.y.domain` 才能生效	MarkBackground	-
title	用于指定图表的标题内容，详见标题	object（可选）	-
axis	用于建立数据与视觉位置的映射关系，详见坐标轴	object（可选）	-
legend	图表的辅助元素，使用颜色、大小、形状区分不同的数据类型，用于图表中数据的筛选，详见图例	object（可选）	-
scrollbar	用于过滤数据，可以和 x 或者 y 通道绑定，详见滚动条	object（可选）	-
slider	用于过滤数据，让用户在数据量较大的情况下一次只用关注局部的数据，是一种辅助看数据的组件，详见滑块	object（可选）	-
label	数据标签是给图表添加标注的手段之一，详见标签	object（可选）	-
tooltip	用于动态展示数据点的详细信息，详见提示	object（可选）	-
style	视觉样式，配置项详见绘图属性	object（可选）	-
theme	用于控制图表的整体外观，包括颜色、字体、边距等视觉属性，详见主题	string \| object（可选）	`light`
onReady	图表加载回调，用于后续的事件事件绑定	Function（可选）	-
scale	将抽象数据映射为视觉数据，详见比例尺	object（可选）	-
animate	动画作为可视化的重要组成部分，能显著提高数据可视化的表现力，详见动画	object（可选）	-
interaction	提供了按需探索数据的能力，详见交互	object（可选）	-
state	实现交互反馈、高亮、选中等效果，详见状态，不同交互下图表样式	object（可选）	-
annotations	视图好比一个画板，`Column` 组件默认在其上绘制了一个柱状图，我们可以通过 annotations 在上面叠加更多的图层，详见标注	Array（可选）	-

Stack

属性	描述	类型	默认值
groupBy	指定分组通道	`string \| string[]`	`x`
orderBy	指定排序的数据	`TransformOrder`	null
y	y 通道选择的数据通道来源	`'y'\|'y1'`	`y`
y1	y1 通道选择的数据通道来源	`'y'\|'y1'`	`y1`
reverse	是否逆序	`boolean`	false
series	是否有分组字段	`boolean`	true

Group

属性	描述	类型	默认值
groupBy	数据分组的通道或通道组合	string \| string[]	`x`
orderBy	分组内元素的排序规则	TransformOrder	() => null
reverse	是否逆序排列分组内的元素	boolean	false
padding	分组内元素之间的间距（0 ~ 1）	number	0

ConversionTag

属性	描述	类型	默认值	必选
size	Icon 高度	number	40	false
arrowSize	箭头大小	number	20	false
spacing	距离柱子间距	boolean	4	false
text	文本配置	number	0
style	Icon 样式	ShapeAttrs	-	false

type Text = {
  /** 文字样式 */
  style?: ShapeAttrs;
  /** 文本格式化 */
  formatter?: (prev: number, next: number) => string;
};

MarkBackground

type MarkBackground = {
  /** background 样式 */
  style?: ShapeAttrs;
  [key: string]: any
};

事件

详见选项-事件。

方法

详见图表概览-图表方法。

常见问题

如何调整分组距离

组内距离

group: {
  padding: 0, // 0 ~ 1
}

组间距离，详见比例尺

scale: {
  x: {
    padding: 0.2 // 0 ~ 1
  }
}

如何设置柱子最小高度

style: {
  minHeight: 20
}

如何设置柱子宽度占比

style: {
  columnWidthRatio: 0.2, // 0 ~ 1
}

如何设置柱子宽度

style: {
  minWidth: 20,
  maxWidth: 20
}

如何设置组内柱子间距离

style: {
  inset: 2,
  // insetRight: 2
  // insetLeft: 2
}