ThingsBoard教程（十三）：部件的基本API解释_专栏

前言

各位读者好，截止目前，ThingsBoard系列文章已经做了十篇，分别是

上一篇TB教程我们讲解了如何在部件库中使用echarts。借助echarts丰富，美观的案例，可以使我们的物联网仪表盘变得更加美观，更具表现力。

本篇我们就从来系统地学习一下ThingsBoard的部件库基本API。

在ThingsBoard中，部件相关的业务逻辑都是在JavaScript面板里编写的。每一个部件对外都提供了一个self对象，改组件的所有属性都被挂载self之下，如部件的容器 $scontainer, 部件的高height。
包含部件所有的函数，也都是在self对象下定义。此外self还有很多部件上下文的属性，一些组件必要的API和数据访问接口，以下是部件内容的解释。

$container

类型： jQuery Object
描述：部件的容器节点，可使用jQuery API动态创建或修改内容。

$scope

类型： IDynamicWidgetComponent
描述：参考Angular 的 IDynamicWidgetComponent。当组件是用Angular可以修改组件的属性。

width

类型： Number
描述：当前部件容器的宽单位像素

height

类型： Number
描述：当前部件容器的高单位像素

isEdit

类型： Boolean
描述：表明dashboard是否能够在查看与编辑实体之间切换

isMobile

类型： Boolean
描述：表明dashboard能否在手机模式，低于996px宽的屏幕下显示

widgetConfig

类型：WidgetConfig
描述：公共的部件配置属性，如文本颜色，部件的背景颜色，等。

settings

类型： Object
描述：包含部件特殊配属属性的对象，由settings json schema定义
在这里插入图片描述

datasources

类型： Array
描述：部件的数据源，格式请看Subscription object

 datasources = [
        {  // datasource
           type: 'entity',// type of the datasource. Can be "function" or "entity"
           name: 'name', // name of the datasource (in case of "entity" usually Entity name)
           aliasName: 'aliasName', // name of the alias used to resolve this particular datasource Entity
           entityName: 'entityName', // name of the Entity used as datasource
           entityType: 'DEVICE', // datasource Entity type (for ex. "DEVICE", "ASSET", "TENANT", etc.)
           entityId: '943b8cd0-576a-11e7-824c-0b1cb331ec92', // entity identificator presented as string uuid. 
           dataKeys: [ //  array of keys (Array<DataKey>) (attributes or timeseries) of the entity used to fetch data 
               { // dataKey
                    name: 'name', // the name of the particular entity attribute/timeseries 
                    type: 'timeseries', // type of the dataKey. Can be "timeseries", "attribute" or "function" 
                    label: 'Sin', // label of the dataKey. Used as display value (for ex. in the widget legend section) 
                    color: '#ffffff', // color of the key. Can be used by widget to set color of the key data (for ex. lines in line chart or segments in the pie chart).  
                    funcBody: "", // only applicable for datasource with type "function" and "function" key type. Defines body of the function to generate simulated data.
                    settings: {} // dataKey specific settings with structure according to the defined Data key settings json schema. See "Settings schema section".
               },
               //...
           ]
        },
        //...
    ]

data

类型： Array
描述：部件最新的数据源，格式请看Subscription object

  data = [
        {
            datasource: {}, // datasource object of this data. See datasource structure above.
            dataKey: {}, // dataKey for which the data is held. See dataKey structure above.
            data: [ // array of data points
                [   // data point
                    1498150092317, // unix timestamp of datapoint in milliseconds
                    1, // value, can be either string, numeric or boolean  
                ],
                //...
            ]  
        },
        //...
    ]