如何用Blazor技術(shù)封裝G2Plot實(shí)現(xiàn)Charts組件

這期內(nèi)容當(dāng)中小編將會給大家?guī)碛嘘P(guān)如何用Blazor技術(shù)封裝G2Plot實(shí)現(xiàn)Charts組件，文章內(nèi)容豐富且以專業(yè)的角度為大家分析和敘述，閱讀完這篇文章希望大家可以有所收獲。

Blazor是一個使用 .NET 生成交互式客戶端 Web UI 的框架。目前社區(qū)剛起步，相關(guān)的組件并不多，有幸有一群愛好者正在努力建設(shè)社區(qū)，我作為社區(qū)一員也來貢獻(xiàn)一些內(nèi)容。這里我就分享分享我封裝G2Plot后的Blazor組件ant-design-charts-blazor。

ant-design-charts-blazor屬于Ant Design of Blazor的一個開源項(xiàng)目，我們的目標(biāo)是做Ant Design在Blazor生態(tài)圈最優(yōu)秀的實(shí)現(xiàn)，廢話不多說，先來看一下目前實(shí)現(xiàn)的圖表。

安裝與使用

項(xiàng)目地址：

ant-design-blazor/ant-design-charts-blazor  github.com

安裝 Nuget 包引用

$ dotnet add package AntDesign.Charts

在wwwroot/index.html(WebAssembly) 或Pages/_Host.razor(Server) 中引入靜態(tài)文件:

<script src="https://unpkg.com/@antv/g2plot@latest/dist/g2plot.js"></script>
<script src="_content/AntDesign.Charts/ant-design-charts-blazor.js"></script>

在_Imports.razor中加入命名空間

@using AntDesign.Charts

最后就可以在.razor組件中引用啦！

<Line Data="data" Config="config" />

@code{
    object[] data = new object[] {
        new  { year= "1991", value= 3 },
        new  { year= "1992", value= 4 },
        new  { year= "1993", value= 3.5 },
        new  { year= "1994", value= 5 },
        new  { year= "1995", value= 4.9 },
        new  { year= "1996", value= 6 },
        new  { year= "1997", value= 7 },
        new  { year= "1998", value= 9 },
        new  { year= "1999", value= 13 },
};

    LineConfig config = new LineConfig()
    {
        title = new Title()
        {
            visible = true,
            text = "曲線折線圖",
        },
        description = new Description()
        {
            visible = true,
            text = "用平滑的曲線代替折線。",
        },
        padding = "auto",
        forceFit = true,
        xField = "year",
        yField = "value",
        smooth = true,
    };
}

組件的使用相對于原先的G2Plot并沒有太多變化，主要針對C#語法的特點(diǎn)增加了強(qiáng)類型支持，屬性命名規(guī)則符合C#語法習(xí)慣等。

所以這篇文章不想多聊如何使用的問題，我想談?wù)勗趯2Plot封裝的過程中遇到的一些困難和實(shí)現(xiàn)方式，希望能為Blazor社區(qū)做出一些綿薄的貢獻(xiàn)，如大佬看了有更好的實(shí)現(xiàn)方式希望告知在下。

Config對象的封裝

G2Plot是通過傳入一個Config對象來配置圖表的呈現(xiàn)內(nèi)容，而且只需要給出必要的參數(shù)即可，這一切設(shè)計(jì)的都非常合理。

但是用C#實(shí)現(xiàn)的時候就遇上了問題，當(dāng)Config對象通過InvokeVoidAsync傳到JS后，對象會包含所有屬性，這對于G2Plot來說就畫蛇添足了，有些默認(rèn)屬性會被帶進(jìn)來的空屬性給覆蓋了，圖表顯示就出現(xiàn)了問題。

當(dāng)然最簡單的就是把值為Null的屬性從Config剔除，嘿嘿，我就是這么干的。通過一個遞歸遍歷對象中的所有屬性，移除沒有值的屬性。

function isEmptyObj(o) {
    for (let attr in o) return !1;
    return !0
}

function processArray(arr) {
    for (let i = arr.length - 1; i >= 0; i--) {
        if (arr[i] === null || arr[i] === undefined) arr.splice(i, 1);
        else if (typeof arr[i] == 'object') removeNullItem(arr[i], arr, i);
    }
    return arr.length == 0
}

function proccessObject(o) {
    for (let attr in o) {
        if (o[attr] === null || o[attr] === undefined) delete o[attr];
        else if (typeof o[attr] == 'object') {
            removeNullItem(o[attr]);
            if (isEmptyObj(o[attr])) delete o[attr];
        }
    }
}

//清除沒有值的項(xiàng)
function removeNullItem(o, arr, i) {
    let s = ({}).toString.call(o);
    if (s == '[object Array]') {
        if (processArray(o) === true) {
            if (arr) arr.splice(i, 1);
        }
    } else if (s == '[object Object]') {
        proccessObject(o);
        if (arr && isEmptyObj(o)) arr.splice(i, 1);
    }
}

一個問題解決了，有一個問題來了，JS/TS是弱類型語言，他對象中的屬性可以在實(shí)例化時任意添加，C#可不行，他被定義約束的死死的，這就遇到下面兩個問題：

1. 有些配置屬性不可能窮舉所有的屬性定義。

2. 而且作為組件的封裝者不可能無時差的跟進(jìn)G2Plot對Config定義的變化。

針對這兩個問題，我們需要C#中有一個類似的弱類型的對象，這時候我看上了object，它可以定義成任何類型，如果用它做Config參數(shù)，可謂是一勞永逸，豈不美哉。

理想是美好的，現(xiàn)實(shí)是殘酷的。如果用object，那么C#的強(qiáng)類型就徹底喪失，編寫圖表配置時完全沒有提示，基本就是盲寫，太恐怖了，C#的優(yōu)雅蕩然無存。

這時突然腦子冒出個念頭，為啥不能使用兩個配置，一個是強(qiáng)類型的，一個是object，然后將他們合并成最終的配置給到G2Plot，完美。

基本原理就是通過一個遞歸將傳入JS的配置對象挨個對比，并將它們合并，JS實(shí)現(xiàn)代碼如下

function deepObjectMerge(source, target) {
    for (var key in target) {
        if (source[key] && source[key].toString() === "[object Object]") {
            deepObjectMerge(source[key], target[key])
        } else {
            source[key] = target[key]
        }
    }
    return source;
}

Blazor中使用方法如下（部分代碼）

<Tabs>
    <TabPane Key="1">
        <Tab>示例1</Tab>
        <ChildContent>
            <Line Data=data1 Config="config1" OtherConfig="otherConfig1" />
        </ChildContent>
    </TabPane>
</Tabs>

@code{
    LineConfig config1 = new LineConfig()
    {
        XField = "date",
        YField = "value",
    };

    object otherConfig1 = new
    {
        = new object[]
        {
            new{
                Visible = true,
                data =new object []{new { date = "2019-05-01", value = 4.9 },new  { date = "2019-10-01" } },
               Label = new
                {
                    Visible = true,
                    Field = "festival",
                },
            },
        },
    };
}

G2Plot對象方法調(diào)用

通過Config生成的圖表是靜態(tài)的，沒有生命的死物，我們需要通過調(diào)用它的一些函數(shù)給予他生命，比如更新配置，更新數(shù)據(jù)，設(shè)置高亮等等。

那么問題就來了，IJSRuntime提供的InvokeAsync方法只能返回可以序列化成json的對象，通過new G2Plot得到的對象不屬于此列，我們?nèi)绾卧贑#代碼中得到G2Plot對象就是個難題了。

好在Blazor提供了一個ElementReference對象給我們，它只能作為Html對象的引用，沒法作為JS對象引用，有點(diǎn)可惜，不過它給我們分配了唯一的Id，既然如此，我們就曲線救國。

第一步，得到div的ElementReference

<div @ref="Ref"></div>

@code{
    protected ElementReference Ref;
}

第二步，構(gòu)造的G2Plot對象，并放到一個叫“chartsContainer”的JS對象中，以Ref.Id作為索引

const plot = new G2Plot[type](domRef, config);
plot.render();
window.AntDesignCharts.chartsContainer[domId] = plot;

第三步，如果需要調(diào)用G2Plot對象的方法，那么直接拿著Ref.Id去“chartsContainer”中找到對象后調(diào)用，下面是“changeData”方法的實(shí)現(xiàn)

changeData(domId, data, all) {
    if (window.AntDesignCharts.chartsContainer[domId] == undefined) return;
    window.AntDesignCharts.chartsContainer[domId].changeData(data, all);
},

第四步，組件銷毀時及時清理“chartsContainer”中不用的對象

public async void Dispose()
    await JS.InvokeVoidAsync(InteropDestroy, Ref.Id);
}

到目前已經(jīng)完成絕大部分功能，還有一些功能需要進(jìn)一步技術(shù)攻關(guān)。

上述就是小編為大家分享的如何用Blazor技術(shù)封裝G2Plot實(shí)現(xiàn)Charts組件了，如果剛好有類似的疑惑，不妨參照上述分析進(jìn)行理解。如果想知道更多相關(guān)知識，歡迎關(guān)注億速云行業(yè)資訊頻道。