Обработка событий ECharts
В ECharts мы можем вызывать соответствующие функции обратного вызова, прослушивая действия пользователя при взаимодействии.
ECharts черезonиспользует метод для прослушивания поведения пользователя, например отслеживания кликов пользователя.
События в ECharts делятся на два типа:
Пользовательские операции кликов мышью, такие как'click'、'dblclick'、'mousedown'、'mousemove'、'mouseup'、'mouseover'、'mouseout'、'globalout'、'contextmenu'событие.
Другой тип — это поведенческие события, запускаемые после взаимодействия пользователя с интерактивными компонентами, например событие 'legendselectchanged', запускаемое при переключении легенды, событие 'datazoom', запускаемое при масштабировании области данных, и так далее.
myChart.on('click', function (params) {
// 在用户点击后控制台打印数据的名称
console.log(params);
});
myChart.on('legendselectchanged', function (params) {
console.log(params);
});
chart.on('click', 'series.line', function (params) {
console.log(params);
});
chart.on('mouseover', {seriesIndex: 1, name: 'xx'}, function (params) {
console.log(params);
});
Событие мыши
Поддерживаемые в ECharts типы событий мыши, включая события 'click'、'dblclick'、'mousedown'、'mousemove'、'mouseup'、'mouseover'、'mouseout'、'globalout'、'contextmenu'.
В следующем примере при клике по столбчатой диаграмме всплывает диалоговое окно:
Пример
var myChart = echarts.init(document.getElementById('main'));
// Указать параметры конфигурации и данные диаграммы
var option = {
xAxis: {
data: ["Рубашка",Шерстяной свитер,Шифоновая блузка,"Брюки",Туфли на высоком каблуке,"Носки"]
},
yAxis: {},
series: [{
name: 'Sales',
type: 'bar',
data: [5, 20, 36, 10, 10, 20]
}]
};
// Используйте элементы конфигурации и данные, только что указанные, для отображения диаграммы.
myChart.setOption(option);
// Обработайте событие клика и выведите имя данных во всплывающем окне.
myChart.on('click', function (params) {
alert(params.name);
});
Попробуйте сами »
Все события мыши включают параметр params, который является объектом, содержащим информацию о данных выбранного графического элемента, в следующем формате:
{
// 当前点击的图形元素所属的组件名称,
// 其值如 'series'、'markLine'、'markPoint'、'timeLine' 等。
componentType: string,
// 系列类型。值可能为:'line'、'bar'、'pie' 等。当 componentType 为 'series' 时有意义。
seriesType: string,
// 系列在传入的 option.series 中的 index。当 componentType 为 'series' 时有意义。
seriesIndex: number,
// 系列名称。当 componentType 为 'series' 时有意义。
seriesName: string,
// 数据名,类目名
name: string,
// 数据在传入的 data 数组中的 index
dataIndex: number,
// 传入的原始数据项
data: Object,
// sankey、graph 等图表同时含有 nodeData 和 edgeData 两种 data,
// dataType 的值会是 'node' 或者 'edge',表示当前点击在 node 还是 edge 上。
// 其他大部分图表中只有一种 data,dataType 无意义。
dataType: string,
// 传入的数据值
value: number|Array
// 数据图形的颜色。当 componentType 为 'series' 时有意义。
color: string
}
Как определить, где произошёл щелчок мышью:
myChart.on('click', function (params) {
if (params.componentType === 'markPoint') {
// 点击到了 markPoint 上
if (params.seriesIndex === 5) {
// 点击到了 index 为 5 的 series 的 markPoint 上。
}
}
else if (params.componentType === 'series') {
if (params.seriesType === 'graph') {
if (params.dataType === 'edge') {
// 点击到了 graph 的 edge(边)上。
}
else {
// 点击到了 graph 的 node(节点)上。
}
}
}
});
Используйте query, чтобы вызывать обратные вызовы только для графических элементов указанного компонента:
chart.on(eventName, query, handler);
query может быть строкой или Object.
Если это строка, она указывает тип компонента. Формат может быть 'mainType' или 'mainType.subType'. Например:
chart.on('click', 'series', function () {...});
chart.on('click', 'series.line', function () {...});
chart.on('click', 'dataZoom', function () {...});
chart.on('click', 'xAxis.category', function () {...});
Если это Object, он может содержать один или несколько следующих атрибутов, каждый из которых необязателен:
{
<mainType>Index: number // 组件 index
<mainType>Name: string // 组件 name
<mainType>Id: string // 组件 id
dataIndex: number // 数据项 index
name: string // 数据项 name
dataType: string // 数据项 type,如关系图中的 'node', 'edge'
element: string // 自定义系列中的 el 的 name
}
Например:
chart.setOption({
// ...
series: [{
name: 'uuu'
// ...
}]
});
chart.on('mouseover', {seriesName: 'uuu'}, function () {
// series name 为 'uuu' 的系列中的图形元素被 'mouseover' 时,此方法被回调。
});
Например:
chart.setOption({
// ...
series: [{
// ...
}, {
// ...
data: [
{name: 'xx', value: 121},
{name: 'yy', value: 33}
]
}]
});
chart.on('mouseover', {seriesIndex: 1, name: 'xx'}, function () {
// series index 1 的系列中的 name 为 'xx' 的元素被 'mouseover' 时,此方法被回调。
});
Например:
chart.setOption({
// ...
series: [{
type: 'graph',
nodes: [{name: 'a', value: 10}, {name: 'b', value: 20}],
edges: [{source: 0, target: 1}]
}]
});
chart.on('click', {dataType: 'node'}, function () {
// 关系图的节点被点击时此方法被回调。
});
chart.on('click', {dataType: 'edge'}, function () {
// 关系图的边被点击时此方法被回调。
});
Например:
chart.setOption({
// ...
series: {
// ...
type: 'custom',
renderItem: function (params, api) {
return {
type: 'group',
children: [{
type: 'circle',
name: 'my_el',
// ...
}, {
// ...
}]
}
},
data: [[12, 33]]
}
})
chart.on('mouseup', {element: 'my_el'}, function () {
// name 为 'my_el' 的元素被 'mouseup' 时,此方法被回调。
});
Вы можете получить имя данных и имя серии в этом объекте из функции обратного вызова, затем найти другую информацию в вашем собственном хранилище данных, чтобы обновить диаграмму, отобразить наложения и т. д., как показано в следующем примере кода:
Пример
$.get('detail?q=' + params.name, function (detail) {
myChart.setOption({
series: [{
name: 'pie',
// Отображение распределения данных в одном столбце с помощью круговой диаграммы
data: [detail.data]
}]
});
});
});
Поведенческие события взаимодействия компонентов
В ECharts практически все виды взаимодействия с компонентами вызывают соответствующие события. Часто используемые события и соответствующие им параметры перечислены в документации по событиям.
Ниже приведён пример прослушивания переключения легенды:
Пример
myChart.on('legendselectchanged', function (params) {
// Получить состояние выбора нажатой легенды
var isSelected = params.selected[params.name];
// Вывести в консоль
console.log((isSelected ? 'Selected' : 'Deselected') + 'Legend' + params.name);
// Вывести состояние всех легенд
console.log(params.selected);
});
Попробуйте сами »
Запуск поведения компонентов в ECharts с помощью кода
Выше мы описали только поведение при взаимодействии пользователя в ECharts. Иногда нам также нужно использовать код, чтобы запускать поведение диаграмм. Например, показывать всплывающую подсказку, выделять графические элементы, выбирать легенды и т. д.
ECharts запускает поведение диаграмм через dispatchAction({ type: '' }), централизованно управляя всеми действиями, и может записывать пути пользователя по мере необходимости.
Приведённый выше пример используется для всплывающей подсказки в карусельной круговой диаграмме;
Пример
var dataLen = option.series[0].data.length;
// Снять выделение с ранее выделенных графических элементов
myChart.dispatchAction({
type: 'downplay',
seriesIndex: 0,
dataIndex: app.currentIndex
});
app.currentIndex = (app.currentIndex + 1) % dataLen;
// Выделить текущую графику
myChart.dispatchAction({
type: 'highlight',
seriesIndex: 0,
dataIndex: app.currentIndex
});
// Показать подсказку
myChart.dispatchAction({
type: 'showTip',
seriesIndex: 0,
dataIndex: app.currentIndex
});
}, 1000);
Попробуйте сами »