检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
{widget}.css 文件介绍 {widget}.css为组件的样式文件，在该文件中编写组件的CSS样式。 华为云Astro大屏应用的组件未进行打包编译，CSS样式可能存在互相影响的风险。因为，CSS选择器务必要加上组件id，通过组件id减少互相影响的可能。 文件示例 #EchartsWidgetTemplate
{widget}.ftl 文件介绍 {widget}.html为组件DOM结构文件，相当于HTML文件，负责样式展示。 在华为云Astro大屏应用中自定义组件时，需要在服务端提前渲染的部分，可以写在此文件中。 文件示例 <div id="EchartsWidgetTemplate"
如何通过全局变量，实现组件数据的动态变化 在华为云Astro大屏应用中，支持通过全局变量，来控制组件数据的动态显示。本章节以全局变量，控制地图组件中数据的动态显示为例进行介绍。 通过全局变量实现组件数据动态变化 参考关系型数据库数据源中操作，新建关系型数据库数据源。 图1 新建关系型数据库数据源
slider 配置项说明 表1 slider配置项说明 参数 类型 是否必选 示例 说明 type String 是 type: "slider" 配置项类型。 value String 否 value: "defaultValue" 默认值。 name String 是 name:
{widget}.js 文件介绍 {widget}.js为组件逻辑文件，整个Widget的渲染核心JS，在组件编辑状态和页面最终的发布运行态都会被加载执行。一个推荐的组件架构，应包含表1中API。其中，init、render和beforeDestory为组件的通用生命周期函数，其余为推荐模板实现。
textarea 配置项说明 表1 textarea配置项说明 参数 类型 是否必选 示例 说明 type String 是 type: "textarea" 配置项类型。 value String 否 - 默认值。 name String 是 name: "commProps.myString"
colorpicker 配置项说明 表1 colorpicker配置项说明 参数 类型 是否必选 示例 说明 type String 是 type: "colorpicker" 配置项类型。 value String 否 value: "defaultValue" 默认值。 name
新建并开发自定义组件 操作场景 当系统预置的组件无法满足用户需求时，用户可自定义组件包进行上传，在页面中进行使用。在开发自定义组件前，请仔细阅读自定义组件开发规范章节内容，了解组件的开发规范。下面以开发网站中常用的柱状图（vue2+Echarts）组件为例，向您介绍如何开发自定义组件。
如何在数据集或跳转事件动作中设置变量 在组件的数据集或组件的跳转事件动作中，是支持设置变量的。 在数据集或事件动作中设置变量 在大屏编辑页面上方，单击，新建并设置页面级全局变量。 例如，新增全局变量“url”，设置变量说明为“数据详情页面URL”。 图1 新增全局变量 从“全部组件
内置API一览表 表1 内置API一览表 API API说明 init 组件渲染的入口函数，组件自己实现继承，使用推荐模板即可。 render 整个组件渲染的业务逻辑实现入口，组件自己实现继承。 getConnectorProperties 获取Connector对接的配置值，用于查看与Connector相关的信息。
关系型数据库数据集 基于关系型数据库，如MS SQL Server、MySQL、Oracle、GaussDB或PostgreSQL创建的数据集。 前提条件 连接的数据源已创建，如何创建请参见关系型数据库数据源。 约束与限制 “数据配置”选择“SQL模式”时，输入的SQL语句中如果
packageinfo.json 文件介绍 packageinfo.json是组件的元数据描述文件，用于配置组件的基本信息。 文件示例 { "widgetApi": [{ "name": "EchartsWidgetTemplate" }], "widgetDescription":
配置项总览 本章节介绍华为云Astro大屏应用支持的组件配置项，您可以通过{widget}.editor.js文件中定义的type字段，来定义组件的类型和配置。 表1 配置项总览 类别 类型 说明 输入框 input 单行文本输入框 textarea 多行文本输入框 数字类型 input-number
input-number 配置项说明 表1 input-number配置项说明 参数 类型 是否必选 示例 说明 type String 是 type: "input-number" 配置项类型。 value String 否 value: 1 默认值。 name String 是
关系型数据库数据源 使用MS SQL Server、MySQL、Oracle、GaussDB和PostgreSQL关系型数据库，作为数据源。 新建关系型数据库数据源 参考登录华为云Astro大屏应用界面中操作，登录华为云Astro大屏应用界面。 在主菜单中，选择“数据中心”。 在左侧导航栏中，选择“数据源”。
{widget}.editor.js 文件介绍及示例 eventConfig classfication propertiesConfig 父主题： 目录文件详解
i18n.json 文件介绍 i18n.json为组件的国际化资源文件，用于配置多语言，目前支持的多语言包含中英文两种，相应的key值分别为['zh-CN','en-US']。多语言文件支持配置在多个Json中，在packageinfo.json中的配置示例如下： "i18n":
Studio对象预置API一览表 表1 Studio对象预置API一览表 API API说明 registerWidget 定义组件。 registerConnector 定义桥接器。 registerEvents 注册事件，只有通过此API注册后的事件才会在组件的事件列表中展现。
magno对象预置API一览表 表1 magno对象预置API一览表 API API说明 savePropertiesForWidget() 用于在开发态中保存当前组件的高级设置属性信息。 savePropertiesForWidget() 该API用于在开发态中，保存当前组件的高级设置属性信息。
eventConfig 字段介绍 eventConfig为组件事件配置项，用于定义组件事件暴露的变量结构，以及事件和对外透传变量的业务含义。eventConfig配置好后，在组件配置交互时可以将事件的itemVal传递给页面全局变量中，供其他组件使用。 典型示例 典型的eventConfig示例如下：
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
