柱状图

下载和安装

TIP

当你不想全部导入所有的图表时请执行以下操作, 安装你想要的图表即可

下载

bun

bun add @v-charts2/histogram

pnpm

pnpm add @v-charts2/histogram

yarn

yarn add @v-charts2/histogram

npm

npm i @v-chart2/histogram

安装

当你当前的打包工具为 webpack 时, 推荐你进行以下的安装步骤

WARNING

传统的 webpack4.x 没有 Tree Shaking 的支持, 如果你想引入 @v-charts2/histogram/vue2 或者 @v-charts2/histogram/vue3 的话, 可能会报错

import Vue from 'vue'
import VeHistogram from '@v-charts2/histogram' // 兼容 vue2.x 和 vue3.x 的支持, 将会自动加载支持 vue2.x 的支持包或者支持 vue3.x 的支持包
Vue.use(VeHistogram)

当你当前的打包工具为 vite 或者 rollup 时, 推荐你进行以下的安装步骤

Vue 2.x

import Vue from 'vue'
import VeHistogram from '@v-charts2/histogram/vue2' // 更好的 Tree Shaking 推荐引入 vue2.x 的专属支持包
import '@v-charts2/histogram/v-charts.css' // 需要手动引入样式
Vue.use(VeHistogram)

Vue 3.x

import { createApp } from 'vue'
const app = createApp()
import VeHistogram from '@v-charts2/histogram/vue3' // 更好的 Tree Shaking 推荐引入 vue3.x 的专属支持包
import '@v-charts2/histogram/v-charts.css' // 需要手动引入样式
app.use(VeHistogram)

DEMO

示例

<template>
  <ve-histogram :data="chartData" />
</template>

<script>
export default {
  data() {
    return {
      chartData: {
        columns: ['日期', '访问用户', '下单用户', '下单率'],
        rows: [
          {
            日期: '1/1',
            访问用户: 1393,
            下单用户: 1093,
            下单率: 0.32
          },
          {
            日期: '1/2',
            访问用户: 3530,
            下单用户: 3230,
            下单率: 0.26
          },
          {
            日期: '1/3',
            访问用户: 2923,
            下单用户: 2623,
            下单率: 0.76
          },
          {
            日期: '1/4',
            访问用户: 1723,
            下单用户: 1423,
            下单率: 0.49
          },
          {
            日期: '1/5',
            访问用户: 3792,
            下单用户: 3492,
            下单率: 0.323
          },
          {
            日期: '1/6',
            访问用户: 4593,
            下单用户: 4293,
            下单率: 0.78
          }
        ]
      }
    }
  }
}
</script>

设置显示的指标维度

<template>
  <ve-histogram :data="chartData" :settings="chartSettings" />
</template>

<script>
export default {
  data() {
    this.chartSettings = {
      metrics: ['访问用户', '下单用户'],
      dimension: ['日期']
    }
    return {
      chartData: {
        columns: ['日期', '访问用户', '下单用户', '下单率'],
        rows: [
          {
            日期: '1/1',
            访问用户: 1393,
            下单用户: 1093,
            下单率: 0.32
          },
          {
            日期: '1/2',
            访问用户: 3530,
            下单用户: 3230,
            下单率: 0.26
          },
          {
            日期: '1/3',
            访问用户: 2923,
            下单用户: 2623,
            下单率: 0.76
          },
          {
            日期: '1/4',
            访问用户: 1723,
            下单用户: 1423,
            下单率: 0.49
          },
          {
            日期: '1/5',
            访问用户: 3792,
            下单用户: 3492,
            下单率: 0.323
          },
          {
            日期: '1/6',
            访问用户: 4593,
            下单用户: 4293,
            下单率: 0.78
          }
        ]
      }
    }
  }
}
</script>

设置双y轴

<template>
  <ve-histogram :data="chartData" :settings="chartSettings" />
</template>

<script>
export default {
  data() {
    this.chartSettings = {
      axisSite: { right: ['下单率'] },
      yAxisType: ['KMB', 'percent'],
      yAxisName: ['数值', '比率']
    }
    return {
      chartData: {
        columns: ['日期', '访问用户', '下单用户', '下单率'],
        rows: [
          {
            日期: '1/1',
            访问用户: 1393,
            下单用户: 1093,
            下单率: 0.32
          },
          {
            日期: '1/2',
            访问用户: 3530,
            下单用户: 3230,
            下单率: 0.26
          },
          {
            日期: '1/3',
            访问用户: 2923,
            下单用户: 2623,
            下单率: 0.76
          },
          {
            日期: '1/4',
            访问用户: 1723,
            下单用户: 1423,
            下单率: 0.49
          },
          {
            日期: '1/5',
            访问用户: 3792,
            下单用户: 3492,
            下单率: 0.323
          },
          {
            日期: '1/6',
            访问用户: 4593,
            下单用户: 4293,
            下单率: 0.78
          }
        ]
      }
    }
  }
}
</script>

柱状图+折线图

<template>
  <ve-histogram :data="chartData" :settings="chartSettings" />
</template>

<script>
export default {
  data() {
    this.chartSettings = { showLine: ['下单用户'] }
    return {
      chartData: {
        columns: ['日期', '访问用户', '下单用户', '下单率'],
        rows: [
          {
            日期: '1/1',
            访问用户: 1393,
            下单用户: 1093,
            下单率: 0.32
          },
          {
            日期: '1/2',
            访问用户: 3530,
            下单用户: 3230,
            下单率: 0.26
          },
          {
            日期: '1/3',
            访问用户: 2923,
            下单用户: 2623,
            下单率: 0.76
          },
          {
            日期: '1/4',
            访问用户: 1723,
            下单用户: 1423,
            下单率: 0.49
          },
          {
            日期: '1/5',
            访问用户: 3792,
            下单用户: 3492,
            下单率: 0.323
          },
          {
            日期: '1/6',
            访问用户: 4593,
            下单用户: 4293,
            下单率: 0.78
          }
        ]
      }
    }
  }
}
</script>

堆叠柱状图

<template>
  <ve-histogram :data="chartData" :settings="chartSettings" />
</template>

<script>
export default {
  data() {
    this.chartSettings = { stack: { 用户: ['访问用户', '下单用户'] } }
    return {
      chartData: {
        columns: ['日期', '访问用户', '下单用户', '下单率'],
        rows: [
          {
            日期: '1/1',
            访问用户: 1393,
            下单用户: 1093,
            下单率: 0.32
          },
          {
            日期: '1/2',
            访问用户: 3530,
            下单用户: 3230,
            下单率: 0.26
          },
          {
            日期: '1/3',
            访问用户: 2923,
            下单用户: 2623,
            下单率: 0.76
          },
          {
            日期: '1/4',
            访问用户: 1723,
            下单用户: 1423,
            下单率: 0.49
          },
          {
            日期: '1/5',
            访问用户: 3792,
            下单用户: 3492,
            下单率: 0.323
          },
          {
            日期: '1/6',
            访问用户: 4593,
            下单用户: 4293,
            下单率: 0.78
          }
        ]
      }
    }
  }
}
</script>

默认显示柱状图数据

<template>
  <ve-histogram :data="chartData" :extend="extend" />
</template>

<script>
export default {
  data() {
    this.extend = {
      series: {
        label: {
          show: true,
          position: 'top'
        }
      }
    }
    return {
      chartData: {
        columns: ['日期', '访问用户', '下单用户', '下单率'],
        rows: [
          {
            日期: '1/1',
            访问用户: 1393,
            下单用户: 1093,
            下单率: 0.32
          },
          {
            日期: '1/2',
            访问用户: 3530,
            下单用户: 3230,
            下单率: 0.26
          },
          {
            日期: '1/3',
            访问用户: 2923,
            下单用户: 2623,
            下单率: 0.76
          },
          {
            日期: '1/4',
            访问用户: 1723,
            下单用户: 1423,
            下单率: 0.49
          },
          {
            日期: '1/5',
            访问用户: 3792,
            下单用户: 3492,
            下单率: 0.323
          },
          {
            日期: '1/6',
            访问用户: 4593,
            下单用户: 4293,
            下单率: 0.78
          }
        ]
      }
    }
  }
}
</script>

修改别名

<template>
  <ve-histogram :data="chartData" :settings="chartSettings" />
</template>

<script>
export default {
  data() {
    this.chartSettings = {
      labelMap: {
        PV: '访问用户',
        Order: '下单用户'
      },
      legendName: { 访问用户: '访问用户 total: 10000' }
    }
    return {
      chartData: {
        columns: ['date', 'PV', 'Order', 'OrderRate'],
        rows: [
          {
            date: '1/1',
            PV: 1393,
            Order: 1093,
            OrderRate: 0.32
          },
          {
            date: '1/2',
            PV: 3530,
            Order: 3230,
            OrderRate: 0.26
          },
          {
            date: '1/3',
            PV: 2923,
            Order: 2623,
            OrderRate: 0.76
          },
          {
            date: '1/4',
            PV: 1723,
            Order: 1423,
            OrderRate: 0.49
          },
          {
            date: '1/5',
            PV: 3792,
            Order: 3492,
            OrderRate: 0.323
          },
          {
            date: '1/6',
            PV: 4593,
            Order: 4293,
            OrderRate: 0.78
          }
        ]
      }
    }
  }
}
</script>

设置横轴为连续的数值轴

<template>
  <ve-histogram :data="chartData" :settings="chartSettings" />
</template>

<script>
export default {
  data() {
    this.chartSettings = { xAxisType: 'value' }
    return {
      chartData: {
        columns: ['日期', '访问用户', '下单用户', '下单率'],
        rows: [
          {
            日期: 1,
            访问用户: 1393,
            下单用户: 1093,
            下单率: 0.32
          },
          {
            日期: 2,
            访问用户: 3530,
            下单用户: 3230,
            下单率: 0.26
          },
          {
            日期: 5,
            访问用户: 2923,
            下单用户: 2623,
            下单率: 0.76
          },
          {
            日期: 10,
            访问用户: 1723,
            下单用户: 1423,
            下单率: 0.49
          },
          {
            日期: 20,
            访问用户: 3792,
            下单用户: 3492,
            下单率: 0.323
          },
          {
            日期: 22,
            访问用户: 4593,
            下单用户: 4293,
            下单率: 0.78
          }
        ]
      }
    }
  }
}
</script>

settings 配置项

配置项	简介	类型	备注
dimension	维度	array	默认columns第一项为维度
metrics	指标	array	默认columns第二项起为指标
yAxisType	左右坐标轴数据类型	array	可选值: KMB, normal, percent
yAxisName	左右坐标轴标题	array	-
axisSite	指标所在的轴	object	默认不在right轴的指标都在left轴
stack	堆叠选项	object	-
digit	设置数据类型为percent时保留的位数	number	默认为2
dataOrder	设置数据排序方式	boolean, object	默认为false
scale	是否是脱离 0 值比例	array	默认为[false, false], 表示左右 两个轴都不会脱离0值比例。 设置成 true 后坐标刻度不会 强制包含零刻度
min	左右坐标轴最小值	array	-
max	左右坐标轴最大值	array	-
labelMap	设置指标的别名, 同时作用于提示框和图例	object	-
legendName	设置图表上方图例的别名	object	-
label	设置图形上的文本标签	object	内容参考文档
itemStyle	图形样式	object	内容参考文档
showLine	展示为折线图的指标	array	-
xAxisType	横轴的类型	string	可选值'category', 'value', 默认为'category'
opacity	透明度	number	-

备注1. axisSite 可以设置 left 和 right, 例如示例所示 axisSite: { right: ['占比'] } 即将占比的数据置于右轴上。

备注2. stack 用于将两数据堆叠起来, 例如实例中所示stack: { '销售额': ['销售额-1季度', '销售额-2季度'] } 即将'销售额-1季度', '销售额-2季度'相应的数据堆叠在一起。

备注3. dataOrder 用于设置数据的排序方式, 用于更加清晰的展示数据的升降。例如： { label: '余额', order: 'asc } 表示数据按照余额指标升序展示, 降序为desc。

备注4. min和max的值可以直接设置为数字, 例如：[100, 300]；也可以设置为['dataMin', 'dataMin'], ['dataMax', 'dataMax'], 此时表示使用该坐标轴上的最小值或最大值为最小或最大刻度。

备注5. 有时我们需要将折线图与柱状图展示在同一个图上, 利用showLine属性可以设置需要展示为折线图的指标, 其他的指标则使用柱状图展示。

备注6. 为了优化连续的数值型横轴显示多指标的时候样式, 在此情况下默认设置opacity为0.5。