ECharts adaptatif
Les graphiques ECharts sont affichés dans un nœud DOM (conteneur) dont la largeur et la hauteur sont spécifiées par l'utilisateur.
Parfois, nous voulons afficher correctement le contenu d'un graphique à la fois sur PC et sur appareils mobiles, en obtenant un design responsive. Pour résoudre ce problème, ECharts a amélioré les paramètres de positionnement des composants et implémenté une capacité semblable à unerequête média CSScapacité d'adaptation.
Positionnement et disposition des composants ECharts
La plupart des "composants" et des "séries" suivent deux méthodes de positionnement.
méthode de positionnement left/right/top/bottom/width/height
Parmi ces six quantités, chacune peut être une "valeur absolue", un "pourcentage" ou une "description de position".
valeur absolue
L'unité est le pixel du navigateur (px), écrite sous la
numberforme (sans unités). Par exemple{left: 23, height: 400}。pourcentage
Indique quel pourcentage de la hauteur et de la largeur du conteneur DOM il occupe, en utilisant
stringS'écrit sous la forme. Par exemple{right: '30%', bottom: '40%'}。Description de position
- Peut être défini
left: 'center', indique un centrage horizontal. - Peut être défini
top: 'middle', indique un centrage vertical.
- Peut être défini
Les concepts de ces six quantités sont similaires à ceux du CSS :
- left : distance par rapport à la bordure gauche du conteneur DOM.
- right : distance par rapport à la bordure droite du conteneur DOM.
- top : distance par rapport à la bordure supérieure du conteneur DOM.
- bottom : distance par rapport à la bordure inférieure du conteneur DOM.
- width : largeur.
- height : hauteur.
Horizontalement, parmi les trois quantités left, right et width, seules deux doivent avoir une valeur, car deux quantités quelconques peuvent déterminer la position et la taille du composant. Par exemple, left et right, ou right et width, peuvent déterminer la position et la taille du composant. Verticalement, les trois quantités top, bottom et height sont similaires au cas horizontal et ne seront pas répétées.
méthode de positionnement center / radius
centerest un tableau, indiquant
[x, y], où,x、yIl peut s'agir d'une « valeur absolue » ou d'un « pourcentage », avec la même signification que celle décrite ci-dessus.radiusest un tableau, indiquant
[inner radius, outer radius]Les rayons intérieur et extérieur peuvent être des « valeurs absolues » ou des « pourcentages », avec les mêmes significations que celles décrites ci-dessus.Les réglages en pourcentage sont très utiles pour s'adapter à la taille du conteneur.
Horizontal et vertical
Les composants ECharts à « apparence allongée » (tels que legend, visualMap, dataZoom, timeline, etc.) offrent généralement un choix entre « disposition horizontale » et « disposition verticale ». Par exemple, sur un écran mobile haut et étroit, une « disposition verticale » peut convenir ; sur un écran large de PC, une « disposition horizontale » peut convenir.
Le réglage de la disposition horizontale/verticale se trouve généralement dans l'élément de configuration orient ou layout du « composant » ou de la « série », défini sur 'horizontal' ou 'vertical'.
Exemple
Dans l'exemple suivant, nous pouvons essayer de faire glisser le point dans le coin inférieur droit ; le graphique changera avec la taille de l'écran, et la légende et la série ajusteront automatiquement leurs positions et méthodes de disposition.
Dans l'exemple, nous avons utilisé jQuery pour charger des données externes. Pour l'utiliser, nous devons inclure la bibliothèque jQuery.
Exemple
$.getScript('https://www.example.com/static/js/timelineGDP.js'),
$.getScript('https://www.example.com/static/js/draggable.js')
).done(function () {
draggable.init(
$('div[_echarts_instance_]')[0],
myChart,
{
width: 700,
height: 400,
throttle: 70
}
);
myChart.hideLoading();
option = {
baseOption: {
title : {
text: 'Diagramme en rose de Nightingale',
subtext: Pure fiction,
x:'center'
},
tooltip : {
trigger: 'item',
formatter: "{a} <br/>{b} : {c} ({d}%)"
},
legend: {
data:['rose1','rose2','rose3','rose4','rose5','rose6','rose7','rose8']
},
toolbox: {
show : true,
feature : {
mark : {show: true},
dataView : {show: true, readOnly: false},
magicType : {
show: true,
type: ['pie', 'funnel']
},
restore : {show: true},
saveAsImage : {show: true}
}
},
calculable : true,
series : [
{
name:Mode rayon,
type:'pie',
roseType : 'radius',
label: {
normal: {
show: false
},
emphasis: {
show: true
}
},
lableLine: {
normal: {
show: false
},
emphasis: {
show: true
}
},
data:[
{value:10, name:'rose1'},
{value:5, name:'rose2'},
{value:15, name:'rose3'},
{value:25, name:'rose4'},
{value:20, name:'rose5'},
{value:35, name:'rose6'},
{value:30, name:'rose7'},
{value:40, name:'rose8'}
]
},
{
name:Mode aire,
type:'pie',
roseType : 'area',
data:[
{value:10, name:'rose1'},
{value:5, name:'rose2'},
{value:15, name:'rose3'},
{value:25, name:'rose4'},
{value:20, name:'rose5'},
{value:35, name:'rose6'},
{value:30, name:'rose7'},
{value:40, name:'rose8'}
]
}
]
},
media: [
{
option: {
legend: {
right: 'center',
bottom: 0,
orient: 'horizontal'
},
series: [
{
radius: [20, '50%'],
center: ['25%', '50%']
},
{
radius: [30, '50%'],
center: ['75%', '50%']
}
]
}
},
{
query: {
minAspectRatio: 1
},
option: {
legend: {
right: 'center',
bottom: 0,
orient: 'horizontal'
},
series: [
{
radius: [20, '50%'],
center: ['25%', '50%']
},
{
radius: [30, '50%'],
center: ['75%', '50%']
}
]
}
},
{
query: {
maxAspectRatio: 1
},
option: {
legend: {
right: 'center',
bottom: 0,
orient: 'horizontal'
},
series: [
{
radius: [20, '50%'],
center: ['50%', '30%']
},
{
radius: [30, '50%'],
center: ['50%', '70%']
}
]
}
},
{
query: {
maxWidth: 500
},
option: {
legend: {
right: 10,
top: '15%',
orient: 'vertical'
},
series: [
{
radius: [20, '50%'],
center: ['50%', '30%']
},
{
radius: [30, '50%'],
center: ['50%', '75%']
}
]
}
}
]
};
myChart.setOption(option);
});
Essayez-le vous-même »
Pour définir une requête média dans option, vous devez suivre le format suivant :
option = {
baseOption: { // 这里是基本的『原子option』。
title: {...},
legend: {...},
series: [{...}, {...}, ...],
...
},
media: [ // 这里定义了 media query 的逐条规则。
{
query: {...}, // 这里写规则。
option: { // 这里写此规则满足下的option。
legend: {...},
...
}
},
{
query: {...}, // 第二个规则。
option: { // 第二个规则对应的option。
legend: {...},
...
}
},
{ // 这条里没有写规则,表示『默认』,
option: { // 即所有规则都不满足时,采纳这个option。
legend: {...},
...
}
}
]
};
Dans l'exemple ci-dessus, baseOption et chaque option dans media sont des « options atomiques », c'est-à-dire des options ordinaires contenant les définitions des composants et des séries. L'option entière composée d'« options atomiques » est appelée une « option composite ». baseOption est toujours utilisé ; de plus, lorsqu'une condition de requête est satisfaite, l'option correspondante est fusionnée à l'aide de chart.mergeOption().
requête
Chaque requête ressemble à ceci :
{
minWidth: 200,
maxHeight: 300,
minAspectRatio: 1.3
}
Prend actuellement en charge trois propriétés : width, height, aspectRatio. Chaque propriété peut avoir un préfixe min ou max. Par exemple, minWidth: 200 signifie « largeur supérieure ou égale à 200px ». Écrire deux propriétés ensemble signifie « et », par exemple : {minWidth: 200, maxHeight: 300} signifie « largeur supérieure ou égale à 200px, et hauteur inférieure ou égale à 300px ».
option
Comme l'option dans media est une « option atomique », théoriquement n'importe quel élément de configuration d'option peut être écrit. Mais généralement, nous n'écrivons que ceux liés à la mise en page et au positionnement, par exemple, prenons une partie de l'option de requête de l'exemple ci-dessus :
media: [
...,
{
query: {
maxAspectRatio: 1 // 当长宽比小于1时。
},
option: {
legend: { // legend 放在底部中间。
right: 'center',
bottom: 0,
orient: 'horizontal' // legend 横向布局。
},
series: [ // 两个饼图左右布局。
{
radius: [20, '50%'],
center: ['50%', '30%']
},
{
radius: [30, '50%'],
center: ['50%', '70%']
}
]
}
},
{
query: {
maxWidth: 500 // 当容器宽度小于 500 时。
},
option: {
legend: {
right: 10, // legend 放置在右侧中间。
top: '15%',
orient: 'vertical' // 纵向布局。
},
series: [ // 两个饼图上下布局。
{
radius: [20, '50%'],
center: ['50%', '30%']
},
{
radius: [30, '50%'],
center: ['50%', '75%']
}
]
}
},
...
]
Priorité lorsque plusieurs requêtes sont satisfaites
Notez que plusieurs requêtes peuvent être satisfaites en même temps, et toutes seront fusionnées via mergeOption ; celles définies plus tard sont fusionnées plus tard (c'est-à-dire qu'elles ont une priorité plus élevée).
Requête par défaut
Si un élément dans media n'a pas de requête, il représente la « valeur par défaut », c'est-à-dire que cette option est adoptée lorsqu'aucune des règles n'est satisfaite.
Remarques lorsque la taille du conteneur change en temps réel
Dans de nombreux cas, le nœud DOM du conteneur n'a pas besoin de changer arbitrairement de taille avec le glissement, mais plutôt seulement quelques tailles typiques sont définies en fonction des différents appareils.
Cependant, si le nœud DOM du conteneur doit pouvoir changer arbitrairement de taille avec le glissement, alors actuellement vous devez faire attention à ceci : si un élément de configuration apparaît dans une option de requête, il doit également apparaître dans les autres options de requête, sinon il ne peut pas revenir à son état d'origine. (left/right/top/bottom/width/height ne sont pas soumis à cette restriction.)
Le media dans l'« option composée » ne prend pas en charge la fusion.
Autrement dit, lorsque, pour la deuxième (ou troisième, quatrième, cinquième ...) fois, chart.setOption(rawOption) est appelé, si rawOption est une option composée (c'est-à-dire qu'elle contient une liste media), alors la nouvelle liste rawOption.media ne sera pas fusionnée avec l'ancienne liste media, mais sera simplement remplacée. Cependant, rawOption.baseOption sera toujours normalement fusionné avec l'ancienne option. En réalité, il y a très peu de scénarios nécessitant d'utiliser « l'option composée » pour appeler setOption plusieurs fois, et la méthode que nous recommandons est la suivante : lors de l'utilisation de mediaQuery, ne pas utiliser « l'option composée » en un seul setOption ; lors des setOption suivants, n'utiliser que « l'option atomique », c'est-à-dire utiliser uniquement setOption pour modifier baseOption.Dans ce qui suit, nous avons utilisé jQuery pour charger des données externes. Lors de son utilisation, nous devons inclure la bibliothèque jQuery. Cet exemple est un exemple combiné avec une timeline :
Exemple
$.getScript('https://www.example.com/static/js/timelineGDP.js'),
$.getScript('https://www.example.com/static/js/draggable.js')
).done(function () {
draggable.init(
$('div[_echarts_instance_]')[0],
myChart,
{
width: 700,
height: 630,
lockY: true,
throttle: 70
}
);
myChart.hideLoading();
var categoryData = [
'Pékin','Tianjin','Hebei','Shanxi','Mongolie-Intérieure','Liaoning','Jilin','Heilongjiang',
'Shanghai','Jiangsu','Zhejiang','Anhui','Fujian','Jiangxi','Shandong','Henan',
'Hubei','Hunan','Guangdong','Guangxi','Hainan','Chongqing','Sichuan','Guizhou',
'Yunnan','Tibet','Shaanxi','Gansu','Qinghai','Ningxia','Xinjiang'
];
option = {
baseOption: {
timeline: {
axisType: 'category',
autoPlay: true,
playInterval: 1000,
data: [
'2002-01-01', '2003-01-01', '2004-01-01',
'2005-01-01', '2006-01-01', '2007-01-01',
'2008-01-01', '2009-01-01', '2010-01-01',
'2011-01-01'
],
label: {
formatter : function(s) {
return (new Date(s)).getFullYear();
}
}
},
title: {
subtext: 'Exemple de requête média'
},
tooltip: {
trigger:'axis',
axisPointer: {
type: 'shadow'
}
},
xAxis: {
type: 'value',
name: 'PIB (100 millions de yuans)',
max: 30000,
data: null
},
yAxis: {
type⟦⟧'category': 'category',
data: categoryData,
axisLabel: {interval: 0},
splitLine: {show: false}
},
legend: {
data: [Secteur primaire, Secteur secondaire, Secteur tertiaire, 'PIB', ', 'Réel'],
selected: {
'PIB': false, 'Finance': false, 'Immobilier': false
}
},
calculable : true,
series: [
{name: PIB, type: 'bar'},
{name: 'Finance, type: '},
{name: 'Immobilier', type: bar'},
{name: Secteur primaire, type: 'bar'},
{name: Industrie secondaire, type: 'bar'},
{name: Industrie tertiaire, type: 'bar'},
{name: 'Part du PIB', type: 'pie'}
]
},
media: [
{
option: {
legend: {
orient: 'horizontal',
left: 'right',
itemGap: 10
},
grid: {
left: '10%',
top: 80,
right: 90,
bottom: 100
},
xAxis: {
nameLocation: 'end',
nameGap: 10,
splitNumber: 5,
splitLine: {
show: true
}
},
timeline: {
orient: 'horizontal',
inverse: false,
left: '20%',
right: '20%',
bottom: 10,
height: 40
},
series: [
{name: 'Part du PIB', center: ['75%', '30%'], radius: '28%'}
]
}
},
{
query: {maxWidth: 670, minWidth: 550},
option: {
legend: {
orient: 'horizontal',
left: 200,
itemGap: 5
},
grid: {
left: '10%',
top: 80,
right: 90,
bottom: 100
},
xAxis: {
nameLocation: 'end',
nameGap: 10,
splitNumber: 5,
splitLine: {
show: true
}
},
timeline: {
orient: 'horizontal',
inverse: false,
left: '20%',
right: '20%',
bottom: 10,
height: 40
},
series: [
{name: 'Part du PIB', center: ['75%', '30%'], radius: '28%'}
]
}
},
{
query: {maxWidth: 550},
option: {
legend: {
orient: 'vertical',
left: 'right',
itemGap: 5
},
grid: {
left: 55,
top: '32%',
right: 100,
bottom: 50
},
xAxis: {
nameLocation: 'middle',
nameGap: 25,
splitNumber: 3
},
timeline: {
orient: 'vertical',
inverse: true,
right: 10,
top: 150,
bottom: 10,
width: 55
},
series: [
{name: 'Part du PIB', center: ['45%', '20%'], radius: '28%'}
]
}
}
],
options: [
{
title: {text: '2002 Indicateurs macroéconomiques nationaux'},
series: [
{data: dataMap.dataGDP['2002']},
{data: dataMap.dataFinancial['2002']},
{data: dataMap.dataEstate['2002']},
{data: dataMap.dataPI['2002']},
{data: dataMap.dataSI['2002']},
{data: dataMap.dataTI['2002']},
{data: [
{name: Secteur primaire, value: dataMap.dataPI['2002sum']},
{name: Secteur secondaire, value: dataMap.dataSI['2002sum']},
{name: Secteur tertiaire, value: dataMap.dataTI['2002sum']}
]}
]
},
{
title : {text: 'Indicateurs macroéconomiques nationaux de 2003'},
series : [
{data: dataMap.dataGDP['2003']},
{data: dataMap.dataFinancial['2003']},
{data: dataMap.dataEstate['2003']},
{data: dataMap.dataPI['2003']},
{data: dataMap.dataSI['2003']},
{data: dataMap.dataTI['2003']},
{data: [
{name: Secteur primaire, value: dataMap.dataPI['2003sum']},
{name: Secteur secondaire, value: dataMap.dataSI['2003sum']},
{name: Secteur tertiaire, value: dataMap.dataTI['2003sum']}
]}
]
},
{
title : {text: 'Indicateurs macroéconomiques nationaux de 2004'},
series : [
{data: dataMap.dataGDP['2004']},
{data: dataMap.dataFinancial['2004']},
{data: dataMap.dataEstate['2004']},
{data: dataMap.dataPI['2004']},
{data: dataMap.dataSI['2004']},
{data: dataMap.dataTI['2004']},
{data: [
{name: Secteur primaire, value: dataMap.dataPI['2004sum']},
{name: Secteur secondaire, value: dataMap.dataSI['2004sum']},
{name: Secteur tertiaire, value: dataMap.dataTI['2004sum']}
]}
]
},
{
title : {text: 'Indicateurs macroéconomiques nationaux de 2005'},
series : [
{data: dataMap.dataGDP['2005']},
{data: dataMap.dataFinancial['2005']},
{data: dataMap.dataEstate['2005']},
{data: dataMap.dataPI['2005']},
{data: dataMap.dataSI['2005']},
{data: dataMap.dataTI['2005']},
{data: [
{name: Secteur primaire, value: dataMap.dataPI['2005sum']},
{name: Industrie secondaire, value: dataMap.dataSI['2005sum']},
{name: Industrie tertiaire, value: dataMap.dataTI['2005sum']}
]}
]
},
{
title : {text: 'Indicateurs macroéconomiques nationaux 2006'},
series : [
{data: dataMap.dataGDP['2006']},
{data: dataMap.dataFinancial['2006']},
{data: dataMap.dataEstate['2006']},
{data: dataMap.dataPI['2006']},
{data: dataMap.dataSI['2006']},
{data: dataMap.dataTI['2006']},
{data: [
{name: Industrie primaire, value: dataMap.dataPI['2006sum']},
{name: Industrie secondaire, value: dataMap.dataSI['2006sum']},
{name: Industrie tertiaire, value: dataMap.dataTI['2006sum']}
]}
]
},
{
title : {text: 'Indicateurs macroéconomiques nationaux 2007'},
series : [
{data: dataMap.dataGDP['2007']},
{data: dataMap.dataFinancial['2007']},
{data: dataMap.dataEstate['2007']},
{data: dataMap.dataPI['2007']},
{data: dataMap.dataSI['2007']},
{data: dataMap.dataTI['2007']},
{data: [
{name: Industrie primaire, value: dataMap.dataPI['2007sum']},
{name: Industrie secondaire, value: dataMap.dataSI['2007sum']},
{name: Industrie tertiaire, value: dataMap.dataTI['2007sum']}
]}
]
},
{
title : {text: 'Indicateurs macroéconomiques nationaux 2008'},
series : [
{data: dataMap.dataGDP['2008']},
{data: dataMap.dataFinancial['2008']},
{data: dataMap.dataEstate['2008']},
{data: dataMap.dataPI['2008']},
{data: dataMap.dataSI['2008']},
{data: dataMap.dataTI['2008']},
{data: [
{name: Industrie primaire, value: dataMap.dataPI['2008sum']},
{name: Secteur secondaire, value: dataMap.dataSI['2008sum']},
{name: Secteur tertiaire, value: dataMap.dataTI['2008sum']}
]}
]
},
{
title : {text: 'Indicateurs macroéconomiques nationaux 2009'},
series : [
{data: dataMap.dataGDP['2009']},
{data: dataMap.dataFinancial['2009']},
{data: dataMap.dataEstate['2009']},
{data: dataMap.dataPI['2009']},
{data: dataMap.dataSI['2009']},
{data: dataMap.dataTI['2009']},
{data: [
{name: Secteur primaire, value: dataMap.dataPI['2009sum']},
{name: Secteur secondaire, value: dataMap.dataSI['2009sum']},
{name: Secteur tertiaire, value: dataMap.dataTI['2009sum']}
]}
]
},
{
title : {text: 'Indicateurs macroéconomiques nationaux 2010'},
series : [
{data: dataMap.dataGDP['2010']},
{data: dataMap.dataFinancial['2010']},
{data: dataMap.dataEstate['2010']},
{data: dataMap.dataPI['2010']},
{data: dataMap.dataSI['2010']},
{data: dataMap.dataTI['2010']},
{data: [
{name: Secteur primaire, value: dataMap.dataPI['2010sum']},
{name: Secteur secondaire, value: dataMap.dataSI['2010sum']},
{name: Secteur tertiaire, value: dataMap.dataTI['2010sum']}
]}
]
},
{
title : {text: 'Indicateurs macroéconomiques nationaux 2011'},
series : [
{data: dataMap.dataGDP['2011']},
{data: dataMap.dataFinancial['2011']},
{data: dataMap.dataEstate['2011']},
{data: dataMap.dataPI['2011']},
{data: dataMap.dataSI['2011']},
{data: dataMap.dataTI['2011']},
{data: [
{name: Secteur primaire, value: dataMap.dataPI['2011sum']},
{name: Industrie secondaire, value: dataMap.dataSI['2011sum']},
{name: Industrie tertiaire, value: dataMap.dataTI['2011sum']}
]}
]
}
]
};
myChart.setOption(option);
});
Essayez-le vous-même »