检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
在模板详情页，单击“下载”，将模板下载到本地。 认识Widget包目录结构 解压下载到本地的组件Widget包，认识组件结构。如解压EchartsWidgetTemplate组件包，其目录结构如图2所示。 图2 Widget包目录结构 为了便于描述，对于名称不固定的手册，统一采用“{widget}”来命名。
名称相同的关键字，关键字格式需遵循如下规则： MySQL数据库加反引号“``” MySQL数据库中，常用的关键字有value、data、desc、day、all和add，更多关键字请参见MySQL5.7官方保留字与关键字、MySQL8.0官方保留字与关键字。 PostgreSQL或GaussDB数据库加双引号
树状下拉框 树状下拉框是一种带有树形结构的下拉框，通常用于选择有限选项数据的级联场景。 在大屏设计页面，从“全部组件 > 文本”中，拖拽“树状下拉框”组件至画布空白区域，如图1。 图1 树状下拉框 图2 边距样式说明 卡片 卡片是指包裹图表组件的外层架构，可以理解为组件由卡片中基
关系型数据库数据源 使用MS SQL Server、MySQL、Oracle、GaussDB和PostgreSQL关系型数据库，作为数据源。 新建关系型数据库数据源 参考登录华为云Astro大屏应用界面中操作，登录华为云Astro大屏应用界面。 在主菜单中，选择“数据中心”。 在左侧导航栏中，选择“数据源”。
代码结构介绍 了解代码目录结构 目录文件详解 父主题： 自定义组件开发规范
json {widget}.css {widget}.editor.js {widget}.ftl {widget}.js 父主题： 代码结构介绍
classfication 字段介绍 classfication字段代表的是当前组件需要展示哪些大的配置项分类。华为云Astro大屏应用在设计前期对分类也进行了分组，因此这个字段被扩展为双数组形式。一般默认情况下，直接在数组对象的第一个数组中配置即可。如果无配置，则所有属性展示在一个大的分类下。
i18n.json 文件介绍 i18n.json为组件的国际化资源文件，用于配置多语言，目前支持的多语言包含中英文两种，相应的key值分别为['zh-CN','en-US']。多语言文件支持配置在多个Json中，在packageinfo.json中的配置示例如下： "i18n":
{widget}.css 文件介绍 {widget}.css为组件的样式文件，在该文件中编写组件的CSS样式。 华为云Astro大屏应用的组件未进行打包编译，CSS样式可能存在互相影响的风险。因为，CSS选择器务必要加上组件id，通过组件id减少互相影响的可能。 文件示例 #EchartsWidgetTemplate
EchartsWidgetTemplate = EchartsWidgetTemplate.extend({ // 组件事件配置项，定义组件事件结构及说明，给全局变量映射使用 eventConfig: { clickSeries: { desc: { zh_CN:
按需实现，组件定义事件和动作时使用。 getMockData 组件在没有对接外部数据源时，使用的获取桩数据的API自定义实现。考虑数据集天然支持二维数组对象，桩数据结构统一为二维数组对象[{id:3,name:'zhangsan'}]。某些场景假如只需要一个简单值val，可以设置组件桩数据设置为简单二维对象数组[{val:123}]。
{widget}.editor.js 文件介绍及示例 eventConfig classfication propertiesConfig 父主题： 目录文件详解
DWS数据源 数据仓库服务（Data Warehouse Service，简称DWS）是完全托管的企业级云上数据仓库服务，具备免运维、在线扩展、高效的多源数据加载能力，兼容PostgreSQL生态。助力企业经济高效地对海量数据进行在线分析，实现数据快速变现。更多关于DWS的介绍，请参见DWS产品文档。
组件事件暴露的变量结构，以及事件和对外透传变量的业务含义。eventConfig配置好后，在组件配置交互时可以将事件的itemVal传递给页面全局变量中，供其他组件使用。 典型示例 典型的eventConfig示例如下： // 组件事件配置项，定义组件事件结构及说明，给全局变量映射使用
packageinfo.json 文件介绍 packageinfo.json是组件的元数据描述文件，用于配置组件的基本信息。 文件示例 { "widgetApi": [{ "name": "EchartsWidgetTemplate" }], "widgetDescription":
{widget}.ftl 文件介绍 {widget}.html为组件DOM结构文件，相当于HTML文件，负责样式展示。 在华为云Astro大屏应用中自定义组件时，需要在服务端提前渲染的部分，可以写在此文件中。 文件示例 <div id="EchartsWidgetTemplate"
DLI数据源 数据湖探索（Data Lake Insight，简称DLI）是完全兼容Apache Spark、Apache Flink、openLooKeng（基于Apache Presto）生态，提供一站式的流处理、批处理、交互式分析的Serverless融合处理分析服务。用户
测试API接口：用于测试该接口，单击“测试API接口”，“样例报文”中会显示输出结果。 样例报文：对应API接口的响应样例报文数据格式，数据集的元数据结构由该样例报文经转换器处理后的数据结构确定。 单击“格式化”，可对样例报文进行格式化处理。 转换器：建议使用系统预置的“PromAPI预置连接器”，用于对数据进行转换处理。
propertiesConfig 字段介绍 propertiesConfig是一个数组，用于保存组件配置项的相关字段，包括数据接入配置、组件配置项。 图1 propertiesConfig配置示例 数据接入配置 数据接入配置详细介绍，请参见组件数据接入。 组件配置项 配置示例如下
国际化内容。 hideWidget：隐藏该组件的dom结构。在预览态调用该方法可以隐藏Widget。 例如，执行thisObj.hideWidget()方法隐藏该组件的dom结构。 showWidget：显示该组件的dom结构。在预览态调用该方法可以展示Widget。 例如，执行thisObj
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
