Адаптивность ECharts

Диаграммы ECharts отображаются в узле DOM (контейнере), ширина и высота которого задаются пользователем.

Иногда мы хотим, чтобы содержимое диаграммы хорошо отображалось как на ПК, так и на мобильных устройствах, обеспечивая адаптивный дизайн. Чтобы решить эту проблему, ECharts улучшил настройки позиционирования компонентов и реализовал нечто похожее наCSS Media Queryадаптивная возможность.


Позиционирование и компоновка компонентов ECharts

Большинство «компонентов» и «серий» используют два метода позиционирования.

метод позиционирования left/right/top/bottom/width/height

Среди этих шести величин каждая может быть «абсолютным значением», «процентом» или «описанием позиции».

  • абсолютное значение

    Единица измерения — пиксель браузера (px), записывается вnumberформате (без единиц измерения). Например{left: 23, height: 400}。

  • percentage

    Указывает, какой процент от высоты и ширины DOM-контейнера он занимает, используяstringЗаписывается в формате. Например{right: '30%', bottom: '40%'}。

  • Описание позиции

    • Можно задатьleft: 'center', означает горизонтальное центрирование.
    • Можно задатьtop: 'middle', означает вертикальное центрирование.

Понятия этих шести величин аналогичны понятиям в CSS:

  • left: расстояние от левой границы DOM-контейнера.
  • right: расстояние от правой границы DOM-контейнера.
  • top: расстояние от верхней границы DOM-контейнера.
  • bottom: расстояние от нижней границы DOM-контейнера.
  • width: ширина.
  • height: высота.

По горизонтали из трёх величин left, right и width только две должны иметь значения, потому что любые две величины могут определить положение и размер компонента. Например, left и right, или right и width, могут определить положение и размер компонента. По вертикали три величины top, bottom и height аналогичны горизонтальному случаю, и повторяться не будут.

метод позиционирования center / radius

  • center

    является массивом, указывающим[x, y], где,x、yЭто может быть "абсолютное значение" или "процент", с тем же значением, как описано выше.

  • radius

    является массивом, указывающим[inner radius, outer radius]Внутренний и внешний радиусы могут быть «абсолютными значениями» или «процентами», с тем же смыслом, что описан выше.

    Настройки в процентах очень полезны при адаптации к размеру контейнера.

Горизонтальное и вертикальное

Компоненты ECharts с «вытянутым внешним видом» (такие как legend, visualMap, dataZoom, timeline и т. д.) обычно предоставляют выбор между «горизонтальной компоновкой» и «вертикальной компоновкой». Например, на высоком узком экране мобильного устройства может подойти «вертикальная компоновка»; на широкоэкранном мониторе ПК может подойти «горизонтальная компоновка».

Настройка горизонтальной/вертикальной компоновки обычно находится в элементе конфигурации orient или layout «компонента» или «серии» и задаётся как 'horizontal' или 'vertical'.


Пример

В следующем примере можно попробовать перетащить точку в правом нижнем углу; график будет изменяться вместе с размером экрана, а легенда и серии будут автоматически подстраивать свои позиции и способы компоновки.

В примере мы использовали jQuery для загрузки внешних данных. При использовании необходимо подключить библиотеку jQuery.

Пример

$.when(
    $.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: 'Роза Найтингейл',
                subtext: Чистый вымысел,
                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:Режим радиуса,
                    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:Режим области,
                    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);

});

Попробуйте сами »

Чтобы задать медиазапрос в option, нужно следовать следующему формату:

option = {
    baseOption: { // 这里是基本的『原子option』。
        title: {...},
        legend: {...},
        series: [{...}, {...}, ...],
        ...
    },
    media: [ // 这里定义了 media query 的逐条规则。
        {
            query: {...},   // 这里写规则。
            option: {       // 这里写此规则满足下的option。
                legend: {...},
                ...
            }
        },
        {
            query: {...},   // 第二个规则。
            option: {       // 第二个规则对应的option。
                legend: {...},
                ...
            }
        },
        {                   // 这条里没有写规则,表示『默认』,
            option: {       // 即所有规则都不满足时,采纳这个option。
                legend: {...},
                ...
            }
        }
    ]
};

В приведённом выше примере baseOption и каждый option в media — это "атомарные option", то есть обычные option, содержащие определения компонентов и series. Весь option, состоящий из "атомарных option", называется "составным option". baseOption используется всегда; кроме того, когда условие запроса выполняется, соответствующий option объединяется с помощью chart.mergeOption().

запрос

Каждый запрос выглядит так:

{
    minWidth: 200,
    maxHeight: 300,
    minAspectRatio: 1.3
}

Сейчас поддерживаются три свойства: width, height, aspectRatio. Каждое свойство может иметь префикс min или max. Например, minWidth: 200 означает "ширина больше или равна 200px". Запись двух свойств вместе означает "и", например: {minWidth: 200, maxHeight: 300} означает "ширина больше или равна 200px, и высота меньше или равна 300px".

option

Поскольку option в media — это "атомарный option", теоретически можно записать любой элемент конфигурации option. Но обычно мы записываем только те, что связаны с макетом и позиционированием, например, возьмём часть option запроса из примера выше:

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%']
                }
            ]
        }
    },
    ...
]

Приоритет при выполнении нескольких запросов

Обратите внимание, что несколько запросов могут выполняться одновременно, и все они будут объединены через mergeOption; те, что определены позже, объединяются позже (то есть имеют более высокий приоритет).

Запрос по умолчанию

Если элемент в media не имеет query, он представляет "значение по умолчанию", то есть этот option применяется, когда ни одно из правил не выполняется.

Замечания при изменении размера контейнера в реальном времени

Во многих случаях контейнерному DOM-узлу не нужно произвольно изменять размер при перетаскивании, а достаточно установить лишь несколько типичных размеров в зависимости от разных устройств.

Однако, если контейнерный DOM-узел должен иметь возможность произвольно изменять размер при перетаскивании, то сейчас нужно быть внимательным к следующему: если элемент конфигурации появляется в одной опции запроса, он также должен появляться в других опциях запроса, иначе он не сможет вернуться в исходное состояние. (left/right/top/bottom/width/height не подпадают под это ограничение.)

Media в «составном option» не поддерживает слияние.

Также обратите внимание, что когда второй (или третий, четвёртый, пятый ...) раз вызывается chart.setOption(rawOption), если rawOption является составным option (то есть содержит список media), то новый список rawOption.media не будет объединяться со старым списком media, а просто заменит его. Однако rawOption.baseOption всё ещё будет нормально объединяться со старым option. На самом деле, в редких сценариях требуется использовать «составной option» для многократного setOption, но мы рекомендуем следующий метод: при использовании mediaQuery не используйте setOption один раз с «составным option», а при последующих setOption используйте только «атомарный option», то есть только используйте setOption для изменения baseOption.

Ниже мы использовали jQuery для загрузки внешних данных. При использовании необходимо подключить библиотеку jQuery. Этот пример объединён с временной шкалой:

Пример

$.когда(
    $.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 = [
        'Пекин','Тяньцзинь','Хэбэй','Шаньси','Внутренняя Монголия','Ляонин','Цзилинь','Хэйлунцзян',
        'Шанхай','Цзянсу','Чжэцзян','Аньхой','Фуцзянь','Цзянси','Шаньдун','Хэнань',
        'Хубэй','Хунань','Гуандун','Гуанси','Хайнань','Чунцин','Сычуань','Гуйчжоу',
        'Юньнань','Тибет','Шэньси','Ганьсу','Цинхай','Нинся','Синьцзян'
    ];


    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: 'Пример медиазапроса'
            },
            tooltip: {
                trigger:'axis',
                axisPointer: {
                    type: 'shadow'
                }
            },
            xAxis: {
                type: 'value',
                name: 'ВВП (100 млн юаней)',
                max: 30000,
                data: null
            },
            yAxis: {
                type: 'category',
                data: categoryData,
                axisLabel: {interval: 0},
                splitLine: {show: false}
            },
            legend: {
                data: [Первичный сектор, Вторичный сектор, Третичный сектор, 'ВВП', 'Финансы', 'Недвижимость'],
                selected: {
                    'ВВП': false, 'Финансы': false, 'Недвижимость': false
                }
            },
            calculable : true,
            series: [
                {name: 'ВВП', type: 'bar'},
                {name: 'Финансы', type: 'bar'},
                {name: 'Недвижимость', type: 'bar'},
                {name: Первичный сектор, type: 'bar'},
                {name: Вторичный сектор, type: 'bar'},
                {name: Третичный сектор, type: 'bar'},
                {name: 'Доля ВВП', 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: 'Доля ВВП', 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: 'Доля ВВП', 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: 'Доля ВВП', center: ['45%', '20%'], radius: '28%'}
                    ]
                }
            }
        ],
        options: [
            {
                title: {text: 'Национальные макроэкономические показатели 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: Первичный сектор, value: dataMap.dataPI['2002sum']},
                        {name: Вторичный сектор, value: dataMap.dataSI['2002sum']},
                        {name: Третичный сектор, value: dataMap.dataTI['2002sum']}
                    ]}
                ]
            },
            {
                title : {text: 'Национальные макроэкономические показатели за 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: Первичный сектор, value: dataMap.dataPI['2003sum']},
                        {name: Вторичный сектор, value: dataMap.dataSI['2003sum']},
                        {name: Третичный сектор, value: dataMap.dataTI['2003sum']}
                    ]}
                ]
            },
            {
                title : {text: 'Национальные макроэкономические показатели за 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: Первичный сектор, value: dataMap.dataPI['2004sum']},
                        {name: Вторичный сектор, value: dataMap.dataSI['2004sum']},
                        {name: Третичный сектор, value: dataMap.dataTI['2004sum']}
                    ]}
                ]
            },
            {
                title : {text: 'Национальные макроэкономические показатели за 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: Первичный сектор, value: dataMap.dataPI['2005sum']},
                        {name: Вторичный сектор, value: dataMap.dataSI['2005sum']},
                        {name: Третичный сектор, value: dataMap.dataTI['2005sum']}
                    ]}
                ]
            },
            {
                title : {text: 'Национальные макроэкономические показатели 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: Первичный сектор, value: dataMap.dataPI['2006sum']},
                        {name: Вторичный сектор, value: dataMap.dataSI['2006sum']},
                        {name: Третичный сектор, value: dataMap.dataTI['2006sum']}
                    ]}
                ]
            },
            {
                title : {text: 'Национальные макроэкономические показатели 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: Первичный сектор, value: dataMap.dataPI['2007sum']},
                        {name: Вторичный сектор, value: dataMap.dataSI['2007sum']},
                        {name: Третичный сектор, value: dataMap.dataTI['2007sum']}
                    ]}
                ]
            },
            {
                title : {text: 'Национальные макроэкономические показатели 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: Первичный сектор, value: dataMap.dataPI['2008sum']},
                        {name: Вторичный сектор, value: dataMap.dataSI['2008sum']},
                        {name: Третичный сектор, value: dataMap.dataTI['2008sum']}
                    ]}
                ]
            },
            {
                title : {text: 'Национальные макроэкономические показатели 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: Первичный сектор, value: dataMap.dataPI['2009sum']},
                        {name: Вторичный сектор, value: dataMap.dataSI['2009sum']},
                        {name: Третичный сектор, value: dataMap.dataTI['2009sum']}
                    ]}
                ]
            },
            {
                title : {text: 'Национальные макроэкономические показатели 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: Первичный сектор, value: dataMap.dataPI['2010sum']},
                        {name: Вторичный сектор, value: dataMap.dataSI['2010sum']},
                        {name: Третичный сектор, value: dataMap.dataTI['2010sum']}
                    ]}
                ]
            },
            {
                title : {text: 'Национальные макроэкономические показатели 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: Первичный сектор, value: dataMap.dataPI['2011sum']},
                        {name: Вторичный сектор, value: dataMap.dataSI['2011sum']},
                        {name: Третичный сектор, value: dataMap.dataTI['2011sum']}
                    ]}
                ]
            }
        ]
    };

    myChart.setOption(option);

});

Попробуйте сами »
Другие расширения