Blazor 向 ECharts 传递 option

目标

  将ECharts封装为Blazor组件，然后通过jsRuntime向ECharts传递参数，即设置option。

封装ECharts

步骤：

1. 在index.html中引入echarts.min.js；

2. 创建blazor组件，将ref传递给js用于初始化echarts；

<div style="@Style" @ref="elementReference"></div>

3. 在js中写初始化代码

window.EChart ={ 
   charts: {},
    init: function (element, id, option) {
        if (element == null)
            return;

        var chart = echarts.init(element);

        c.charts[id] = chart;

        this.setOption(id,option);
    },

    setOption: function (id, option) {
        if (!c.charts[id])
            return;

        if (!option) {
            option = {
                xAxis: {
                    type: 'category',
                    data: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun']
                },
                yAxis: {
                    type: 'value'
                },
                series: [
                    {
                        data: [150, 230, 224, 218, 135, 147, 260],
                        type: 'line'
                    }
                ]
            };
        }
        c.charts[id].setOption(option);
    },
}

4. C#调用js的EChart.init函数

public static async Task EChartInit(this IJSRuntime jsRuntime, ElementReference element, Dictionary<string, object> option)
{
    await jsRuntime.InvokeVoidAsync("EChart.init", element, element.Id, option);
}

5. 在Blazor组件渲染完成后调用EChartInit 

        protected override async Task OnAfterRenderAsync(bool firstRender)
        {
            await base.OnAfterRenderAsync(firstRender);

            if (firstRender)
            {
                await JSRuntime.EChartInit(elementReference, Option);
            }
        }

用Dictionary<string,object>传递option

   ECharts里 option配置项是坐标轴、系列、图例、数据集等灵活组合的复杂对象，用C#强类型定义代码量会很大，用弱类型的Dictionary<string,object>来做更灵活，你可以把Dictionary<string,object>视为C#里的JSON。

  我把ECharts官网示例里的data最后数字从260修改为60来测试是否可行：

   调用后画出的曲线：

总结

  C#的jsRuntime序列化机制和ECharts的option对象之间，刚好可以用Dictionary<string,object>做媒，再复杂的对象都可以用Dictionary<string,object>来解构，学问在于里面的object可以是基本类型、对象(还是Dictionary<string,object>)、集合(List<object>)，为此我专门做了个工具来定义任意解构的对象，这个万能的弱类型似乎有大用处。