Gestion des événements ECharts
Dans ECharts, nous pouvons déclencher les fonctions de rappel correspondantes en écoutant les comportements d'interaction de l'utilisateur.
ECharts utilise la méthodeonpour écouter les comportements des utilisateurs, par exemple en surveillant les actions de clic de l'utilisateur.
Les événements dans ECharts sont divisés en deux types :
Clics d'opération de souris de l'utilisateur, tels que'click'、'dblclick'、'mousedown'、'mousemove'、'mouseup'、'mouseover'、'mouseout'、'globalout'、'contextmenu'événement.
L'autre type correspond aux événements comportementaux déclenchés après que les utilisateurs interagissent avec des composants interactifs, tels que l'événement 'legendselectchanged' déclenché lors du basculement de la légende, l'événement 'datazoom' déclenché lors du zoom sur la zone de données, etc.
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);
});
Événement souris
Types d'événements souris pris en charge par ECharts, notamment les événements 'click'、'dblclick'、'mousedown'、'mousemove'、'mouseup'、'mouseover'、'mouseout'、'globalout'、'contextmenu'.
L'exemple suivant affiche une boîte de dialogue lors d'un clic sur un diagramme à barres :
Exemple
var myChart = echarts.init(document.getElementById('main'));
// Spécifier les options de configuration et les données du graphique
var option = {
xAxis: {
data: ["Chemise",Pull en laine,Blouse en mousseline,"Pantalon",Talons hauts,"Chaussettes"]
},
yAxis: {},
series: [{
name: 'Ventes',
type: 'bar',
data: [5, 20, 36, 10, 10, 20]
}]
};
// Utilisez les éléments de configuration et les données qui viennent d’être spécifiés pour afficher le graphique.
myChart.setOption(option);
// Gérer l’événement click et afficher une pop-up avec le nom de la donnée
myChart.on('click', function (params) {
alert(params.name);
});
Essayez-le vous-même »
Tous les événements de souris incluent le paramètre params, qui est un objet contenant les informations de données relatives à l’élément graphique cliqué, au format suivant :
{
// 当前点击的图形元素所属的组件名称,
// 其值如 '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
}
Comment distinguer l’endroit où la souris a cliqué :
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(节点)上。
}
}
}
});
Utilisez query pour déclencher des fonctions de rappel uniquement pour les éléments graphiques du composant spécifié :
chart.on(eventName, query, handler);
query peut être une chaîne de caractères ou un objet.
S’il s’agit d’une chaîne de caractères, elle indique le type de composant. Le format peut être 'mainType' ou 'mainType.subType'. Par exemple :
chart.on('click', 'series', function () {...});
chart.on('click', 'series.line', function () {...});
chart.on('click', 'dataZoom', function () {...});
chart.on('click', 'xAxis.category', function () {...});
S’il s’agit d’un objet, il peut contenir un ou plusieurs des attributs suivants, chacun étant facultatif :
{
<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
}
Par exemple :
chart.setOption({
// ...
series: [{
name: 'uuu'
// ...
}]
});
chart.on('mouseover', {seriesName: 'uuu'}, function () {
// series name 为 'uuu' 的系列中的图形元素被 'mouseover' 时,此方法被回调。
});
Par exemple :
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' 时,此方法被回调。
});
Par exemple :
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 () {
// 关系图的边被点击时此方法被回调。
});
Par exemple :
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' 时,此方法被回调。
});
Vous pouvez obtenir le nom de la donnée et le nom de la série dans cet objet à partir de la fonction de rappel, puis indexer d’autres informations dans votre propre référentiel de données pour mettre à jour le graphique, afficher des superpositions, etc., comme le montre l’exemple de code suivant :
Exemple
$.get('detail?q=' + params.name, function (detail) {
myChart.setOption({
series: [{
name: 'pie',
// Afficher la répartition des données dans une seule barre au moyen d'un diagramme circulaire
data: [detail.data]
}]
});
});
});
Événements comportementaux d'interaction des composants
Dans ECharts, pratiquement tous les comportements d'interaction des composants déclenchent des événements correspondants. Les événements couramment utilisés et leurs paramètres correspondants sont répertoriés dans la documentation des événements.
L'exemple suivant montre comment écouter un changement de légende :
Exemple
myChart.on('legendselectchanged', function (params) {
// Obtenir l'état de sélection de la légende cliquée
var isSelected = params.selected[params.name];
// Afficher dans la console
console.log((isSelected ? 'Sélectionné' : 'Désélectionné') + 'Légende' + params.name);
// Afficher l'état de toutes les légendes
console.log(params.selected);
});
Essayez-le vous-même »
Déclencher les comportements des composants dans ECharts avec du code
Ci-dessus, nous n'avons décrit que les interactions utilisateur, mais parfois nous devons également appeler des méthodes dans le programme pour déclencher des comportements de graphique, comme afficher une infobulle.
ECharts déclenche des comportements de graphique via dispatchAction({ type: '' }), en gérant centralement toutes les actions, et peut également enregistrer les chemins de comportement utilisateur selon les besoins.
L'exemple ci-dessus est utilisé pour l'infobulle dans le diagramme circulaire en carrousel :
Exemple
var dataLen = option.series[0].data.longueur;
// Retirer la surbrillance des graphiques précédemment mis en surbrillance
myChart.dispatchAction({
type: 'downplay',
seriesIndex: 0,
dataIndex: app.currentIndex
});
app.currentIndex = (app.currentIndex + 1) % dataLen;
// Mettre en surbrillance le graphique actuel
myChart.dispatchAction({
type: 'highlight',
seriesIndex: 0,
dataIndex: app.currentIndex
});
// Afficher l'info-bulle
myChart.dispatchAction({
type: 'showTip',
seriesIndex: 0,
dataIndex: app.currentIndex
});
}, 1000);
Essayez-le vous-même »