ECharts Adaptativo
El gráfico de ECharts se muestra en un nodo DOM (contenedor) cuyo alto y ancho especifica el usuario.
A veces queremos poder mostrar bien el contenido del gráfico tanto en PC como en dispositivos móviles, para lograr un diseño responsive. Para resolver este problema, ECharts ha mejorado la configuración de posicionamiento de los componentes y ha implementado una capacidad adaptativa similar aCSS Media Query.
Posicionamiento y diseño de componentes de ECharts
La mayoría de los 'componentes' y 'series' siguen dos métodos de posicionamiento.
Método de posicionamiento left/right/top/bottom/width/height
De estas seis cantidades, cada una puede ser un 'valor absoluto', un 'porcentaje' o una 'descripción de posición'.
Valor absoluto
La unidad es el píxel del navegador (px), usando
numberforma de escritura (sin escribir la unidad). Por ejemplo{left: 23, height: 400}。Porcentaje
Indica qué porcentaje del alto y ancho del contenedor DOM, usando
stringforma de escritura. Por ejemplo{right: '30%', bottom: '40%'}。Descripción de posición
- Se puede configurar
left: 'center', que indica centrado horizontal. - Se puede configurar
top: 'middle', que indica centrado vertical.
- Se puede configurar
El concepto de estas seis cantidades es similar al de las seis cantidades en CSS:
- left: distancia al borde izquierdo del contenedor DOM.
- right: distancia al borde derecho del contenedor DOM.
- top: distancia al borde superior del contenedor DOM.
- bottom: distancia al borde inferior del contenedor DOM.
- width: ancho.
- height: alto.
En horizontal, de las tres cantidades left, right, width, solo se necesitan dos con valor, porque cualquiera de las dos puede determinar la posición y el tamaño del componente; por ejemplo, left y right, o right y width, pueden determinar la posición y el tamaño del componente. En vertical, las tres cantidades top, bottom, height son similares a las horizontales, no se entrará en detalles.
Método de posicionamiento center / radius
centerEs un array que representa
[x, y], donde,x、ypuede ser un 'valor absoluto' o un 'porcentaje', con el mismo significado mencionado anteriormente.radiusEs un array que representa
[radio interior, radio exterior], donde, los radios interior y exterior pueden ser un 'valor absoluto' o un 'porcentaje', con el mismo significado mencionado anteriormente.Al adaptar el tamaño del contenedor, la configuración de porcentajes es muy útil.
Horizontal y vertical
Los componentes de ECharts de tipo 'apariencia alargada y estrecha' (como legend, visualMap, dataZoom, timeline, etc.) ofrecen en su mayoría la opción de 'diseño horizontal' y 'diseño vertical'. Por ejemplo, en pantallas móviles alargadas y estrechas, puede ser adecuado usar el 'diseño vertical'; en pantallas anchas de PC, puede ser adecuado usar el 'diseño horizontal'.
La configuración del diseño horizontal o vertical generalmente se establece en la opción orient o layout del 'componente' o 'serie', estableciéndola como 'horizontal' o 'vertical'.
Ejemplo
En el siguiente ejemplo podemos intentar arrastrar el punto en la esquina inferior derecha; el gráfico cambiará con el tamaño de la pantalla, y legend y las series cambiarán automáticamente su posición y forma de diseño.
En el ejemplo usamos jQuery para cargar datos externos; al usarlo, necesitamos introducir la librería jQuery.
Ejemplo
$.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: 'Gráfico de rosa de Nightingale',
subtext: 'Puramente ficticio',
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:'Modo radio',
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:'Modo área',
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);
});
Pruébalo »
Para configurar Media Query en option, se debe seguir el siguiente formato:
option = {
baseOption: { // 这里是基本的『原子option』。
title: {...},
legend: {...},
series: [{...}, {...}, ...],
...
},
media: [ // 这里定义了 media query 的逐条规则。
{
query: {...}, // 这里写规则。
option: { // 这里写此规则满足下的option。
legend: {...},
...
}
},
{
query: {...}, // 第二个规则。
option: { // 第二个规则对应的option。
legend: {...},
...
}
},
{ // 这条里没有写规则,表示『默认』,
option: { // 即所有规则都不满足时,采纳这个option。
legend: {...},
...
}
}
]
};
En el ejemplo anterior, baseOption y cada option en media son un 'option atómico', es decir, un option ordinario que contiene las definiciones de los componentes y series. Al option completo compuesto por 'option atómico' lo llamamos 'option compuesto'. baseOption siempre se usa; además, cuando se cumple alguna condición de query, el option correspondiente se fusiona usando chart.mergeOption().
query
Cada query es similar a esto:
{
minWidth: 200,
maxHeight: 300,
minAspectRatio: 1.3
}
Ahora se admiten tres propiedades: width, height, aspectRatio (relación de aspecto). Cada propiedad puede llevar el prefijo min o max. Por ejemplo, minWidth: 200 significa 'ancho mayor o igual que 200px'. Escribir dos propiedades juntas significa 'y', por ejemplo: {minWidth: 200, maxHeight: 300} significa 'ancho mayor o igual que 200px, y alto menor o igual que 300px'.
option
Dado que el option en media es un 'option atómico', en teoría se puede escribir cualquier opción de configuración de option. Pero generalmente solo escribimos las relacionadas con el posicionamiento del diseño, por ejemplo, extraer una parte del query option del ejemplo anterior:
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%']
}
]
}
},
...
]
Prioridad cuando se cumplen múltiples query
Nota: puede haber múltiples query que se cumplan al mismo tiempo, y todas se fusionarán con mergeOption; las definidas después se fusionan más tarde (es decir, tienen mayor prioridad).
query predeterminada
Si algún elemento en media no escribe query, significa 'valor predeterminado', es decir, cuando no se cumple ninguna regla, se adopta este option.
Precauciones cuando el tamaño del contenedor cambia en tiempo real
En muchos casos, no es necesario que el nodo DOM del contenedor cambie de tamaño arbitrariamente al arrastrar, sino que solo se establecen algunos tamaños típicos según los diferentes dispositivos.
Pero si el nodo DOM del contenedor necesita poder cambiar de tamaño arbitrariamente al arrastrar, entonces actualmente al usarlo hay que tener en cuenta esto: si una determinada opción de configuración aparece en un query option, también debe aparecer en los demás query option; de lo contrario, no se puede volver al estado original. (left/right/top/bottom/width/height no están sujetos a esta limitación).
media en un 'option compuesto' no admite merge
Es decir, cuando se llama chart.setOption(rawOption) por segunda (o tercera, cuarta, quinta ...) vez, si rawOption es un option compuesto (es decir, contiene una lista media), entonces la nueva lista rawOption.media no se fusionará con la lista media anterior, sino que simplemente la reemplazará. Por supuesto, rawOption.baseOption todavía se fusionará normalmente con el option anterior. En realidad, hay muy pocos escenarios en los que se necesite usar un 'option compuesto' para llamar a setOption varias veces, y la práctica que recomendamos es que al usar mediaQuery, la primera llamada a setOption use un 'option compuesto', y las llamadas posteriores a setOption usen solo un 'option atómico', es decir, usar setOption únicamente para cambiar baseOption.En lo siguiente usamos jQuery para cargar datos externos; al usarlo, necesitamos introducir la librería jQuery. Este ejemplo es un caso combinado con la línea de tiempo:
Ejemplo
$.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 = [
'Beijing','Tianjin','Hebei','Shanxi','Mongolia Interior','Liaoning','Jilin','Heilongjiang',
'Shanghái','Jiangsu','Zhejiang','Anhui','Fujian','Jiangxi','Shandong','Henan',
'Hubei','Hunan','Guangdong','Guangxi','Hainan','Chongqing','Sichuan','Guizhou',
'Yunnan','Tíbet','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: 'Ejemplo de Media Query'
},
tooltip: {
trigger:'axis',
axisPointer: {
type: 'shadow'
}
},
xAxis: {
type: 'value',
name: 'PIB (100 millones de yuanes)',
max: 30000,
data: null
},
yAxis: {
type: 'category',
data: categoryData,
axisLabel: {interval: 0},
splitLine: {show: false}
},
legend: {
data: [Sector primario, Sector secundario, Sector terciario, 'GDP', Finanzas, Sector inmobiliario],
selected: {
'GDP': false, Finanzas: false, Sector inmobiliario: false
}
},
calculable : true,
series: [
{name: 'GDP', type: 'bar'},
{name: Finanzas, type: 'bar'},
{name: Sector inmobiliario, type: 'bar'},
{name: Sector primario, type: 'bar'},
{name: Sector secundario, type: 'bar'},
{name: Sector terciario, type: 'bar'},
{name: Porcentaje del 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: Porcentaje del 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: Porcentaje del 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: Porcentaje del PIB, center: ['45%', '20%'], radius: '28%'}
]
}
}
],
options: [
{
title: {text: Indicadores macroeconómicos nacionales de 2002},
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: Sector primario, value: dataMap.dataPI['2002sum']},
{name: Sector secundario, value: dataMap.dataSI['2002sum']},
{name: Sector terciario, value: dataMap.dataTI['2002sum']}
]}
]
},
{
title : {text: Indicadores macroeconómicos nacionales 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: Sector primario, value: dataMap.dataPI['2003sum']},
{name: Sector secundario, value: dataMap.dataSI['2003sum']},
{name: Sector terciario, value: dataMap.dataTI['2003sum']}
]}
]
},
{
title : {text: Indicadores macroeconómicos nacionales 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: Sector primario, value: dataMap.dataPI['2004sum']},
{name: Sector secundario, value: dataMap.dataSI['2004sum']},
{name: Sector terciario, value: dataMap.dataTI['2004sum']}
]}
]
},
{
title : {text: Indicadores macroeconómicos nacionales 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: Sector primario, value: dataMap.dataPI['2005sum']},
{name: Sector secundario, value: dataMap.dataSI['2005sum']},
{name: Sector terciario, value: dataMap.dataTI['2005sum']}
]}
]
},
{
title : {text: Indicadores macroeconómicos nacionales de 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: Sector primario, value: dataMap.dataPI['2006sum']},
{name: Sector secundario, value: dataMap.dataSI['2006sum']},
{name: Sector terciario, value: dataMap.dataTI['2006sum']}
]}
]
},
{
title : {text: Indicadores macroeconómicos nacionales de 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: Sector primario, value: dataMap.dataPI['2007sum']},
{name: Sector secundario, value: dataMap.dataSI['2007sum']},
{name: Sector terciario, value: dataMap.dataTI['2007sum']}
]}
]
},
{
title : {text: Indicadores macroeconómicos nacionales de 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: Sector primario, value: dataMap.dataPI['2008sum']},
{name: Sector secundario, value: dataMap.dataSI['2008sum']},
{name: Sector terciario, value: dataMap.dataTI['2008sum']}
]}
]
},
{
title : {text: Indicadores macroeconómicos nacionales de 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: Sector primario, value: dataMap.dataPI['2009sum']},
{name: Sector secundario, value: dataMap.dataSI['2009sum']},
{name: Sector terciario, value: dataMap.dataTI['2009sum']}
]}
]
},
{
title : {text: Indicadores macroeconómicos nacionales de 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: Sector primario, value: dataMap.dataPI['2010sum']},
{name: Sector secundario, value: dataMap.dataSI['2010sum']},
{name: Sector terciario, value: dataMap.dataTI['2010sum']}
]}
]
},
{
title : {text: Indicadores macroeconómicos nacionales de 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: Sector primario, value: dataMap.dataPI['2011sum']},
{name: Sector secundario, value: dataMap.dataSI['2011sum']},
{name: Sector terciario, value: dataMap.dataTI['2011sum']}
]}
]
}
]
};
myChart.setOption(option);
});
Pruébalo »