下面描述了一个能够实现拖拽的实例,该实例是在 Echarts 的基础上的扩展,我们可以通过该例子了解到怎么利用 Echarts 提供的 API 实现定制化的富有交互的功能。
创新互联专注于远安网站建设服务及定制,我们拥有丰富的企业做网站经验。 热诚为您提供远安营销型网站建设,远安网站制作、远安网页设计、远安网站官网定制、小程序定制开发服务,打造远安网络公司原创品牌,更为您提供远安网站排名全网营销落地服务。
点击编辑实例 》》
上述实例达到的功能:您可以使用鼠标拖拽图中曲线上的点,然后就能够改变曲线的形状。
上述实现拖拽的例子还很基础,但是学会上述例子之后我们能够进行更多的操作,比如在图中可视化的编辑。
Echarts 本身没有提供封装好的拖拽改变图表的功能,因为现在这个功能被认为不具备通用性。因此开发者要实现这个功能就要使用 API ,这样做的好处是能够让开发者按自己的需要进行设置。
在这个例子中,基础的图表是一个 折线图 (series-line)。详细配置如下:
var symbolSize = 20;
// 这个 data 变量在这里单独声明,在后面也会用到。
var data = [[15, 0], [-50, 10], [-56.5, 20], [-46.5, 30], [-22.1, 40]];
myChart.setOption({
xAxis: {
min: -100,
max: 80,
type: 'value',
axisLine: {onZero: false}
},
yAxis: {
min: -30,
max: 60,
type: 'value',
axisLine: {onZero: false}
},
series: [
{
id: 'a',
type: 'line',
smooth: true,
symbolSize: symbolSize, // 为了方便拖拽,把 symbolSize 尺寸设大了。
data: data
}
]
});
折线点原本并没有拖拽功能,需要我们为它加上:使用 graphic 组件,在每个点上面,覆盖一个隐藏的可拖拽的圆点,具体操作如下:
myChart.setOption({
// 声明一个 graphic component,里面有若干个 type 为 'circle' 的 graphic elements。
// 这里使用了 echarts.util.map 这个帮助方法,其行为和 Array.prototype.map 一样,但是兼容 es5 以下的环境。
// 用 map 方法遍历 data 的每项,为每项生成一个圆点。
graphic: echarts.util.map(data, function (dataItem, dataIndex) {
return {
// 'circle' 表示这个 graphic element 的类型是圆点。
type: 'circle',
shape: {
// 圆点的半径。
r: symbolSize / 2
},
// 用 transform 的方式对圆点进行定位。position: [x, y] 表示将圆点平移到 [x, y] 位置。
// 这里使用了 convertToPixel 这个 API 来得到每个圆点的位置,下面介绍。
position: myChart.convertToPixel('grid', dataItem),
// 这个属性让圆点不可见(但是不影响他响应鼠标事件)。
invisible: true,
// 这个属性让圆点可以被拖拽。
draggable: true,
// 把 z 值设得比较大,表示这个圆点在最上方,能覆盖住已有的折线图的圆点。
z: 100,
// 此圆点的拖拽的响应事件,在拖拽过程中会不断被触发。下面介绍详情。
// 这里使用了 echarts.util.curry 这个帮助方法,意思是生成一个与 onPointDragging
// 功能一样的新的函数,只不过第一个参数永远为此时传入的 dataIndex 的值。
ondrag: echarts.util.curry(onPointDragging, dataIndex)
};
})
});
我们在上述代码中使用了 convertToPixel 这个 API,进行了从 data 到像素坐标的转换,以确定每个圆点所处的位置,然后进行圆点的绘制。
myChart.convertToPixel('grid', dataItem) 中的第一个参数 ‘grid’ 表示 dataItem 在 grid(即直角坐标系)这个组件中进行的转换。
像素坐标,就是以 Echarts 容器 dom element 的左上角为零点的以像素为单位的坐标系中的坐标。
注意:只有在初始化直角坐标系(grid)后才能够调用 myChart.convertToPixel('grid', dataItem)。
加入上述代码之后,折线上就有了可拖拽的点,接着我们要为每个圆点添加拖拽响应的事件,具体操作如下:
// 拖拽某个圆点的过程中会不断调用此函数。
// 此函数中会根据拖拽后的新位置,改变 data 中的值,并用新的 data 值,重绘折线图,从而使折线图同步于被拖拽的隐藏圆点。
function onPointDragging(dataIndex) {
// 这里的 data 就是本文最初的代码块中声明的 data,在这里会被更新。
// 这里的 this 就是被拖拽的圆点。this.position 就是圆点当前的位置。
data[dataIndex] = myChart.convertFromPixel('grid', this.position);
// 用更新后的 data,重绘折线图。
myChart.setOption({
series: [{
id: 'a',
data: data
}]
});
}
我们在上面的代码中,使用了 convertFromPixel 这个 API。它是 convertToPixel 的逆向过程。
myChart.convertFromPixel('grid', this.position) :把当前像素坐标转换成 grid 组件中直角坐标系的 dataItem 值。
最后,为了使 dom 尺寸改变时,图中的元素能自适应得变化,加入下述代码:
window.addEventListener('resize', function () {
// 对每个拖拽圆点重新计算位置,并用 setOption 更新。
myChart.setOption({
graphic: echarts.util.map(data, function (item, dataIndex) {
return {
position: myChart.convertToPixel('grid', item)
};
})
});
});
到目前为止,我们已经基本实现了拖拽功能。
现在,我们开始学习使用 tooltip 组件来实时显示拖拽过程中被拖拽的点的 data 值的变化状况。
注意:虽然 tooltip 有其默认的显示和隐藏的触发规则,但是在我们的拖拽场景中不适用,因此需要手动添加它们。
在上述代码中分别添加如下定义:
myChart.setOption({
...,
tooltip: {
// 表示不使用默认的『显示』『隐藏』触发规则。
triggerOn: 'none',
formatter: function (params) {
return 'X: ' + params.data[0].toFixed(2) + '
Y: ' + params.data[1].toFixed(2);
}
}
});
myChart.setOption({
graphic: echarts.util.map(data, function (item, dataIndex) {
return {
type: 'circle',
...,
// 在 mouseover 的时候显示,在 mouseout 的时候隐藏。
onmousemove: echarts.util.curry(showTooltip, dataIndex),
onmouseout: echarts.util.curry(hideTooltip, dataIndex),
};
})
});
function showTooltip(dataIndex) {
myChart.dispatchAction({
type: 'showTip',
seriesIndex: 0,
dataIndex: dataIndex
});
}
function hideTooltip(dataIndex) {
myChart.dispatchAction({
type: 'hideTip'
});
}
这里使用了 dispatchAction 来显示隐藏 tooltip。用到了 showTip、hideTip。
总结一下,全部的代码如下:
在这些基础上,我们可以实现更多的功能,例如可以添加 dataZoom 组件、可以制作一个直角坐标系上的绘图板等等。
当前名称:创新互联ECharts教程:ECharts实例一:拖拽的实现
网站URL:http://www.mswzjz.com/qtweb/news40/180340.html
网站建设、网络推广公司-创新互联,是专注品牌与效果的网站制作,网络营销seo公司;服务项目有等
声明:本网站发布的内容(图片、视频和文字)以用户投稿、用户转载内容为主,如果涉及侵权请尽快告知,我们将会在第一时间删除。文章观点不代表本网站立场,如需处理请联系客服。电话:028-86922220;邮箱:631063699@qq.com。内容未经允许不得转载,或转载时需注明来源: 创新互联