ECharts レスポンシブ

ECharts のグラフは、ユーザーが指定した高さと幅の DOM ノード(コンテナ)に表示されます。

PC とモバイルデバイスの両方でグラフの内容をうまく表示し、レスポンシブデザインを実現したい場合があります。この問題を解決するために、ECharts はコンポーネントの位置設定を整備し、さらに同様CSS Media Queryの適応能力を実現しました。


ECharts コンポーネントの位置指定とレイアウト

ほとんどの「コンポーネント」と「シリーズ」は、2つの位置指定方式に従います。

left/right/top/bottom/width/height の位置指定方式

この6つの量は、それぞれ「絶対値」「パーセンテージ」「位置の説明」のいずれかにすることができます。

  • 絶対値

    単位はブラウザのピクセル(px)で、number数値形式で記述します(単位は省略)。例:{left: 23, height: 400}。

  • パーセンテージ

    DOMコンテナの高さ・幅に対する割合を示し、string文字列形式で記述します。例:{right: '30%', bottom: '40%'}。

  • 位置の説明

    • 設定できます。left: 'center'水平方向の中央を表します。
    • 設定できます。top: 'middle'垂直方向の中央を表します。

この6つの量の概念は、CSSにおける6つの量の概念と似ています:

  • left:DOMコンテナの左端からの距離。
  • right:DOMコンテナの右端からの距離。
  • top:DOMコンテナの上端からの距離。
  • bottom:DOMコンテナの下端からの距離。
  • width:幅。
  • height:高さ。

横方向では、left、right、widthの3つの量のうち、2つだけ値があれば十分です。任意の2つの量でコンポーネントの位置とサイズを決定できるためです。例えば、leftとright、またはrightとwidthで、コンポーネントの位置とサイズを決定できます。縦方向では、top、bottom、heightの3つの量についても同様ですので、説明は省略します。

center / radius の位置指定方式

  • center

    center は配列で、[x, y][x, y] を表します。ここで、x、yx と y は「絶対値」または「パーセンテージ」にでき、意味は前述と同じです。

  • radius

    radius は配列で、[内半径、外半径][内半径, 外半径] を表します。ここで、内外半径は「絶対値」または「パーセンテージ」にでき、意味は前述と同じです。

    コンテナサイズを自動調整する場合、パーセンテージ設定は非常に便利です。

横方向(horizontal)と縦方向(vertical)

EChartsの「外観が細長い」タイプのコンポーネント(legend、visualMap、dataZoom、timelineなど)の多くは、「横方向レイアウト」「縦方向レイアウト」の選択肢を提供しています。例えば、細長いモバイル端末の画面では「縦方向レイアウト」が適している場合があり、PCのワイド画面では「横方向レイアウト」が適している場合があります。

横・縦レイアウトの設定は、一般に「コンポーネント」または「シリーズ」の orient または layout 設定項目で、'horizontal' または 'vertical' に設定します。


例

次の例では、右下隅のドットをドラッグしてみることができます。グラフは画面サイズに応じて変化し、legend とシリーズは自動的にレイアウト位置と方法を変更します。

例では、外部データを読み込むために 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 に Media Query を設定するには、次の形式に従う必要があります:

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

上記の例では、baseOption、および media の各 option はすべて「原子 option」です。つまり、各コンポーネントやシリーズの定義を含む通常の option です。そして、「原子 option」を組み合わせてできた全体の option を「複合 option」と呼びます。baseOption は必ず使用されます。さらに、ある query 条件が満たされた場合、対応する option が chart.mergeOption() によってマージされます。

query

各 query は次のような形式です:

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

現在サポートされているのは、width、height、aspectRatio(縦横比)の3つのプロパティです。各プロパティには min または max の接頭辞を付けることができます。例えば、minWidth: 200 は「幅が200px以上」を意味します。2つのプロパティを一緒に書くことは「かつ」を意味します。例:{minWidth: 200, maxHeight: 300} は「幅が200px以上、かつ高さが300px以下」を意味します。

option

media 内の option は「原子 option」なので、理論上は任意の option 設定を記述できます。ただし、通常はレイアウト位置に関連するものだけを記述します。例えば、上記の例から query 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%']
                }
            ]
        }
    },
    ...
]

複数の query が満たされたときの優先順位

複数の query が同時に満たされる場合があることに注意してください。その場合、それらはすべて mergeOption されます。定義が後にあるものほど後に merge されます(つまり優先度が高くなります)。

デフォルトの query

media 内のある項目に query を書かない場合、それは「デフォルト値」を意味します。つまり、すべてのルールが満たされない場合に、この option を採用します。

コンテナサイズがリアルタイムに変化する場合の注意事項

多くの場合、コンテナの DOM ノードをドラッグに応じて任意にサイズ変更する必要はなく、異なる端末に応じていくつかの代表的なサイズを設定するだけです。

しかし、コンテナの DOM ノードをドラッグに応じて任意にサイズ変更できる必要がある場合、現在使用する際には次の点に注意する必要があります:ある設定項目が、特定の query option に現れる場合、他の query option にも必ず現れなければなりません。そうしないと、元の状態に戻ることができません。(left/right/top/bottom/width/height はこの制限を受けません。)

「複合 option」内の media は merge をサポートしません

つまり、2回目(または3回目、4回目、5回目...)の chart.setOption(rawOption) の際に、rawOption が複合 option(つまり media リストを含む)である場合、新しい rawOption.media リストは古い media リストと merge されず、単純に置き換えられます。もちろん、rawOption.baseOption は依然として通常どおり古い option と merge されます。 実際には、「複合 option」を使用して複数回 setOption を行う必要がある場面はほとんどありません。推奨される方法は、mediaQuery を使用する場合、最初の setOption では「複合 option」を使用し、以降の setOption では「原子 option」のみを使用することです。つまり、setOption で baseOption のみを変更するということです。

以下では、外部データを読み込むために 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: 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: 'Media Query の例'
            },
            tooltip: {
                trigger:'axis',
                axisPointer: {
                    type: 'shadow'
                }
            },
            xAxis: {
                type: 'value',
                name: 'GDP(億元)',
                max: 30000,
                data: null
            },
            yAxis: {
                type: 'category',
                data: categoryData,
                axisLabel: {interval: 0},
                splitLine: {show: false}
            },
            legend: {
                data: [第一次産業, 第二次産業, 第三次産業, 'GDP', 金融, 不動産],
                selected: {
                    'GDP': false, 金融: false, 不動産: false
                }
            },
            calculable : true,
            series: [
                {name: 'GDP', type: 'bar'},
                {name: 金融, type: 'bar'},
                {name: 不動産, type: 'bar'},
                {name: 第一次産業, type: 'bar'},
                {name: 第二次産業, type: 'bar'},
                {name: 第三次産業, type: 'bar'},
                {name: GDP比率, 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: GDP比率, 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: GDP比率, 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: GDP比率, 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);

});

試してみる »
その他の拡張