详解Echarts中的配置项

2023-10-14 09:06:13 浏览数 (3)

上一个博客介绍了详细介绍了Echarts提供的图表类型及其适用场景,vue3中安装和使用Echarts,以及自定义图表和处理事件等内容,在上一个博客中我也提到过,Echarts中的配置项非常多,今天我们就来详细的聊一聊Echart是中的配置项。 我把Echarts的配置项分为如下五类:即 基本配置项、数据系列配置项 、样式配置项 、交互配置项和高级配置项。我们一个一个来介绍

基本配置项

我把Echarts中常用的标题、图例、提示框、工具栏等配置项归类到Echarts 图表的基本配置项。各个配置项主要的配置参数如下:

title配置

title配置项是Echarts中的 title 标题组件,它包含主标题和副标题。其常用的配置项有下面几个

text:标题文本内容。

show:是否显示标题组件,默认为true。

subtext:副标题文本内容。

left:标题组件离容器左侧的距离。

top:标题组件离容器上侧的距离。

textStyle:标题文本样式配置项,包括颜色、字体大小等。

link:主标题文本超链接,默认值true 。

target: 指定窗口打开主标题超链接,支持’self’ | ‘blank’,不指定等同为’blank’(新窗口)。

subtext: ‘副标题’, //副标题文本,'n’指定换行。

sublink: 副标题文本超链接。

subtarget: 指定窗口打开副标题超链接,支持’self’ | ‘blank’,不指定等同为’blank’(新窗口)。

backgroundColor: 标题背景颜色,默认’rgba(0,0,0,0)'透明。

borderWidth: 标题边框线宽,单位px,默认为0(无边框)。

borderColor: 标题边框颜色,默认’#ccc’。

padding: 标题内边距,单位px,默认各方向内边距为5,接受数组分别设定上右下左边距 。

itemGap: 主副标题纵向间隔,单位px,默认为10。

textStyle:主标题文本样式,是一个对象,该对象包含下面的属性。

代码语言:javascript复制
 textStyle:{
     
    color: 副标题文字的颜色。
    fontStyle:  副标题文字字体的风格。 'normal'  'italic'  'oblique'
    fontWeight: 副标题文字字体的粗细。 'normal' 'bold'  'bolder'  'lighter' 500|600。
    fontSize: 字体大小
    lineHeight:  行高
    textBorderColor:  文字本身的描边颜色。
    textBorderWidth:  文字本身的描边宽度。
    textShadowColor:  文字本身的阴影颜色。
    textShadowBlur: 文字本身的阴影长度。
    textShadowOffsetX: 文字本身的阴影 X 偏移。
    textShadowOffsetY:  文字本身的阴影 Y 偏移。
 }

subtextStyle:副标题样式,是一个对象,里面配置项和上面的textStyle里面的配置项相同。

标题配置项示例代码:

代码语言:javascript复制
<template>
  <div ref="chart" style="width: 50%;height: 400px;"></div>
</template>
<script setup>
import * as echarts from 'echarts'
import {
    ref,onMounted,reactive } from 'vue'
const chart = ref(null) 
const chartData = [
        {
   name: 'Mon', value: 320},
        {
   name: 'Tue', value: 932},
        {
   name: 'Wed', value: 901},
        {
   name: 'Thu', value: 934},
        {
   name: 'Fri', value: 1290},
        {
   name: 'Sat', value: 1330},
        {
   name: 'Sun', value: 1320}
      ]
onMounted(() => {
    
  const myChart = echarts.init(chart.value)
  const option = {
   
    title: {
   
        text: '柱状图示例',
        subtext: '这是一个副标题',
        left: 'center',
        top: 'top',
        textStyle: {
   
          color: '#333',
          fontSize: 16,
          fontWeight: 'bold',
        },
    },
    // 其他配置项代码
  } 
  myChart.setOption(option)
}) 
</script> 

legend配置项

legend是Echarts的图例组件,可以通过 legend 配置项对图例进行设置,常用的配置项包括:

  • data:图例数据,可以是一个数组或者对象。
  • left:图例组件离容器左侧的距离。值可以是像 20 这样的具体像素值,可以是像 ‘20%’ 这样相对于容器高宽的百分比,也可以是 ‘left’, ‘center’, ‘right’
  • top:图例组件离容器上侧的距离。
  • textStyle:图例文本样式配置项,包括颜色、字体大小等。
  • show: 是否显示。
  • icon: 图例样式。
  • bottom: 组件离容器底部的距离。
  • right: 组件离容器右侧的距离。
  • padding: 图例内边距。
  • itemWidth: 图例标记的图形宽度。
  • itemGap: 图例每项之间的间隔。
  • itemHeight: 图例标记的图形高度。
  • itemStyle:图例的图形样式,是一个对象。其属性的取值为 ‘inherit’ 时,表示继承系列中的属性值。
  • lineStyle:图例图形中线的样式,用于诸如折线图图例横线的样式设置。其属性的取值为 ‘inherit’ 时,表示继承系列中的属性值。
  • selectedMode: 图例选择的模式,控制是否可以通过点击图例改变系列的显示状态。默认开启图例选择,可以设成 false 关闭。
  • inactiveColor: 图例关闭时的颜色。

图例配置项示例代码

代码语言:javascript复制
legend: {
   
    data: ['数据1', '数据2', '数据3'],
    left: 'center',
    top: 'bottom',
    textStyle: 

0 人点赞