一、前言
本文来自于实际大屏需求，由于走了半天弯路特意记录一下，主要实现的是在echarts中堆叠柱状图的 默认选中 以及 定时切换选中 效果；
二、效果图
大致效果图如下：
三、效果实现
切换的核心在于echarts官网提供的 dispatchAction 这个API方法（官网地址如下：https://echarts.apache.org/zh/api.html#action.highlight），这个方法在type项具有两个参数，分别是 highlight 和 showTip，这里利用的就是这两个参数，关于这两个参数的说明如下：
3.1 highlight
highlight的主要作用是将图形高亮，换句话说，在柱状图中这个设置可以让柱状图形处于高亮状态
// 如果要高亮系列：
dispatchAction({
type: 'highlight',
// 用 index 或 id 或 name 来指定系列。
// 可以使用数组指定多个系列。
seriesIndex?: number | number[],
seriesId?: string | string[],
seriesName?: string | string[],
// 数据项的 index，如果不指定也可以通过 name 属性根据名称指定数据项
dataIndex?: number | number[],
// 可选，数据项名称，在有 dataIndex 的时候忽略
name?: string | string[],
});
具体高亮效果，效果：
这里的白色背景条就是高亮效果；
3.2 showTip
这个参数的作用是 主动显示tips，也就是上方图例中的白色小框
dispatchAction({
type: 'showTip',
// 系列的 index，在 tooltip 的 trigger 为 axis 的时候可选。
seriesIndex?: number,
// 数据项的 index，如果不指定也可以通过 name 属性根据名称指定数据项
dataIndex?: number,
// 可选，数据项名称，在有 dataIndex 的时候忽略
name?: string,,
// 本次显示 tooltip 的位置。只在本次 action 中生效。
// 缺省则使用 option 中定义的 tooltip 位置。
position: number[] | string | Function,
})
当执行这段代码后，可以指定图像的tips显示；
3.3 实现代码
知道了高亮和显示tips的api，那么接下来方便了
// 取消之前高亮的图形
chart.dispatchAction({
type: "downplay",
seriesIndex: option.yAxis.data.length,
dataIndex: app.currentIndex,
});
// 计算下一个高亮的位置
app.currentIndex =
app.currentIndex - 1 > -1
? app.currentIndex - 1
: option.yAxis.data.length;
// 执行高亮
chart.dispatchAction({
type: "highlight",
seriesIndex: 0,
dataIndex: app.currentIndex,
});
// 执行
chart.dispatchAction({
type: "showTip",
seriesIndex: 0,
dataIndex: app.currentIndex,
});
这里注意的是，在执行高亮前，为了保险起见务必去取消上一次的高亮，这样确保执行高亮的时候结果是符合预期的；
3.4 整体代码
下面是完整代码，具体效果为本文第二章节的效果；
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Document</title>
<style>
html,
body {
position: relative;
width: 100%;
height: 100%;
margin: 0;
padding: 0;
}
.main {
position: relative;
width: 100%;
height: 100%;
padding: 20px;
box-sizing: border-box;
background-color: #333333;
}
</style>
</head>
<body>
<div class="main" id="app"></div>
<script src="https://cdn.bootcdn.net/ajax/libs/echarts/5.4.2/echarts.js"></script>
<script>
let chart = echarts.init(document.getElementById("app"));
let option = {
tooltip: {
trigger: "axis",
axisPointer: {
// Use axis to trigger tooltip
type: "shadow", // 'shadow' as default; can also be 'line' or 'shadow'
},
},
legend: {},
grid: {
left: "3%",
right: "4%",
bottom: "3%",
containLabel: true,
},
xAxis: {
type: "value",
},
yAxis: {
type: "category",
data: ["Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun"],
},
series: [
{
name: "Direct",
type: "bar",
stack: "total",
label: {
show: true,
},
emphasis: {
focus: "series",
},
data: [320, 302, 301, 334, 390, 330, 320],
},
{
name: "Mail Ad",
type: "bar",
stack: "total",
label: {
show: true,
},
emphasis: {
focus: "series",
},
data: [120, 132, 101, 134, 90, 230, 210],
},
{
name: "Affiliate Ad",
type: "bar",
stack: "total",
label: {
show: true,
},
emphasis: {
focus: "series",
},
data: [220, 182, 191, 234, 290, 330, 310],
},
],
};
chart.setOption(option);
var app = {
currentIndex: option.yAxis.data.length,
};
setInterval(() => {
// 取消之前高亮的图形
chart.dispatchAction({
type: "downplay",
seriesIndex: option.yAxis.data.length,
dataIndex: app.currentIndex,
});
app.currentIndex =
app.currentIndex - 1 > -1
? app.currentIndex - 1
: option.yAxis.data.length;
chart.dispatchAction({
type: "highlight",
seriesIndex: 0,
dataIndex: app.currentIndex,
});
chart.dispatchAction({
type: "showTip",
seriesIndex: 0,
dataIndex: app.currentIndex,
});
}, 1000);
</script>
</body>
</html>
四、小结
echarts的功能很强大，本文中的默认选中和定时切换主要借用的是 dispatchAction 这个API中的 highlight 和 showTip；
通过highlight 指定图形高亮，之后通过 **showTip 显示提示窗口，**最后通过setInterval执行定时切换完成了这个需求（当然，setInterval是有一定问题的，可以通过递归setTimeout解决）；