BarChart 柱状图

BarChart 柱状图 的基础用法、公开 API 与示例。

基础示例

展示分类指标的柱状对比。

示例使用本地演示数据；上传、校验和提交不会连接业务后端。

<script setup lang="ts">
import { ref, } from "vue";
import { BarChart } from "@/components/chart/bar-chart";

const demoProps = { height: "260px", xAxisData: ["一月", "二月", "三月"], data: [12, 20, 16] };
</script>

<template>
  <ClientOnly>
    <div class="demo-surface">
      <BarChart v-bind="demoProps"></BarChart>
    </div>
  </ClientOnly>
</template>

隐藏源代码

堆叠柱状图

使用多组数据、图例和堆叠配置展示预算构成。

示例使用本地演示数据；上传、校验和提交不会连接业务后端。

<script setup lang="ts">
import { BarChart } from "@/components/chart/bar-chart";

const demoProps: InstanceType<typeof BarChart>["$props"] = {
  height: "280px",
  xAxisData: ["材料", "人工", "设备", "管理"],
  data: [
    { name: "预算", data: [42, 28, 16, 12] },
    { name: "追加", data: [8, 6, 4, 3] },
  ],
  stack: true,
  showLegend: true,
  legendPosition: "bottom",
  barWidth: 28,
};
</script>

<template>
  <ClientOnly>
    <div class="demo-surface">
      <BarChart v-bind="demoProps" />
    </div>
  </ClientOnly>
</template>

隐藏源代码

引入方式

import { BarChart } from "@/components/chart/bar-chart";

Props

参数	说明	类型	默认值	必填
height	图表高度	string	DEFAULT_CHART_HEIGHT	否
loading	是否加载中	boolean	false	否
isEmpty	是否为空数据	boolean	false	否
colors	颜色配置	string[]	-	否
showAxisLabel	是否显示坐标轴标签	boolean	true	否
showAxisLine	是否显示坐标轴线	boolean	true	否
showSplitLine	是否显示分割线	boolean	true	否
showTooltip	是否显示提示框	boolean	true	否
showLegend	是否显示图例	boolean	false	否
legendPosition	图例位置	LegendPosition	"bottom"	否
legendOptions	自定义图例配置，会与默认配置合并	ChartCustomOptions	-	否
data	图表数据，支持单组数据或多组数据	number[] | BarDataItem[]	[0, 0, 0, 0, 0, 0, 0]	否
xAxisData	X 轴标签数据	string[]	[]	否
barWidth	柱状图宽度	string | number	"40%"	否
stack	是否堆叠显示	boolean	false	否
borderRadius	圆角	number | number[]	4	否
xAxisLabelConfig	X 轴标签自定义配置，合并到 axisLabel	ChartCustomOptions	-	否

Events

事件名	说明	回调参数
-	该组件未声明 Events。	-

Slots

插槽名	说明	参数
-	该组件未声明 Slots。	-

Expose

名称	说明	类型
-	该组件未声明 Expose。	-

Module API

名称	说明	类型
BarChart	导出 BarChart 供业务侧复用。	useInstall(index)

Types

BarChartProps

柱状图 Props

字段	说明	类型	默认值	必填
height	图表高度	string	-	否
loading	是否加载中	boolean	-	否
isEmpty	是否为空数据	boolean	-	否
colors	颜色配置	string[]	-	否
showAxisLabel	是否显示坐标轴标签	boolean	-	否
showAxisLine	是否显示坐标轴线	boolean	-	否
showSplitLine	是否显示分割线	boolean	-	否
showTooltip	是否显示提示框	boolean	-	否
showLegend	是否显示图例	boolean	-	否
legendPosition	图例位置	LegendPosition	-	否
legendOptions	自定义图例配置，会与默认配置合并	ChartCustomOptions	-	否
data	图表数据，支持单组数据或多组数据	number[] | BarDataItem[]	-	是
xAxisData	X 轴标签数据	string[]	-	否
barWidth	柱状图宽度	string | number	-	否
stack	是否堆叠显示	boolean	-	否
borderRadius	圆角	number | number[]	-	否
xAxisLabelConfig	X 轴标签自定义配置，合并到 axisLabel	ChartCustomOptions	-	否

BarDataItem

柱状图数据项

字段	说明	类型	默认值	必填
name	系列名称	string	-	是
data	数据值	number[]	-	是
barWidth	柱状图宽度	string | number	-	否
stack	堆叠分组名称	string	-	否
color	自定义颜色	string	-	否

API 根据当前组件源码生成；同步版本与验证记录见维护说明。