跳到主要内容

BarChart 柱状图 ​

uni-appH5微信小程序App

uni-app 跨端柱状图。使用 <canvas type="2d"> 绘制,支持多序列、横向/纵向切换、图例与网格。

何时使用 ​

类别间的数值大小对比、排名、分布频次。

何时不使用 ​

时间序列趋势用 LineChart;占比构成用 PieChart。

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
BarChart 柱状图 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
dataChartDatum[]"[]"柱状数据 {name, value, series?}
titlestring""图表标题
heightnumber300图表高度(px)
horizontalboolean"false"横向柱状图
showLegendboolean"true"显示图例
showGridboolean"true"显示网格线
stackedbooleanfalse多序列堆叠(需 data 带 series)
histogrambooleanfalse直方图,柱间无间隙
showTooltipbooleantrue是否显示悬浮提示

示例 ​

基础柱状图 ​

vue
<BarChart :data="lineData" title="访问 / 下单" :height="220" />

横向柱状图 ​

vue
<BarChart :data="pieData" :height="180" horizontal />

隐藏网格 ​

vue
<BarChart :data="lineData" :height="200" :show-grid="false" />

堆叠与直方 ​

vue
<BarChart :data="lineData" title="堆叠柱状" stacked />
<BarChart :data="lineData" title="直方图(柱间无距)" histogram style="margin-top:16px" />