检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
{widget}.editor.js 文件介绍及示例 eventConfig classfication propertiesConfig 父主题： 目录文件详解
如何将AstroZero中的大屏项目迁移到AstroCanvas 场景说明 华为云Astro大屏应用（Astro Canvas，简称AstroCanvas） 产品已正式商业化上线。Astro轻应用（Astro Zero，简称AstroZero）免费版中的“业务大屏”入口计划于2023
如何通过全局变量，实现组件数据的动态变化 在AstroCanvas中，支持通过全局变量，来控制组件数据的动态显示。本章节以全局变量，控制地图组件中数据的动态显示为例进行介绍。 通过全局变量实现组件数据动态变化 参考关系型数据库数据源中操作，新建关系型数据库数据源。 图1 新建关系型数据库数据源
i18n.json 文件介绍 i18n.json为组件的国际化资源文件，用于配置多语言，目前支持的多语言包含中英文两种，相应的key值分别为['zh-CN','en-US']。多语言文件支持配置在多个Json中，在packageinfo.json中的配置示例如下： "i18n":
上传自定义组件 将自定义组件上传到AstroCanvas中，并在页面中使用。 上传自定义组件 参考登录AstroCanvas界面中操作，登录AstroCanvas界面。 在主菜单中，选择“我的资产”，进入我的资产页面。 在左侧导航栏中，选择“我的组件”，单击“添加组件”，进入添加组件页面
关系型数据库数据集 基于关系型数据库，如MS SQL Server、MySQL、Oracle、GaussDB或PostgreSQL创建的数据集。 前提条件 连接的数据源已创建，如何创建请参见关系型数据库数据源。 约束与限制 “数据配置”选择“SQL模式”时，输入的SQL语句中如果含有和数据库中字段名称相同的关键字
tab 配置项说明 表1 tab配置项说明 参数 类型 是否必选 示例 说明 type String 是 type: "tab" 配置项类型。 value String 否 value: "defaultValue" 默认值。 name String 是 name: "commProps.myString
Studio对象预置API一览表 表1 Studio对象预置API一览表 API API说明 registerWidget 定义组件。 registerConnector 定义桥接器。 registerEvents 注册事件，只有通过此API注册后的事件才会在组件的事件列表中展现。
slider 配置项说明 表1 slider配置项说明 参数 类型 是否必选 示例 说明 type String 是 type: "slider" 配置项类型。 value String 否 value: "defaultValue" 默认值。 name String 是 name
组件自定义事件实现 组件之间的交互，主要包括组件自定义事件和组件响应动作，本章节将为您介绍组件自定义事件的实现方式。自定义事件是指组件作为触发器，当用户操作组件（比如下拉框选中选项）时发出的事件。 注册自定义事件 自定义事件在{widget}.editor.js文件中的eventConfig
eventConfig 字段介绍 eventConfig为组件事件配置项，用于定义组件事件暴露的变量结构，以及事件和对外透传变量的业务含义。eventConfig配置好后，在组件配置交互时可以将事件的itemVal传递给页面全局变量中，供其他组件使用。 典型示例 典型的eventConfig
classfication 字段介绍 classfication字段代表的是当前组件需要展示哪些大的配置项分类。AstroCanvas在设计前期对分类也进行了分组，因此这个字段被扩展为双数组形式。一般默认情况下，直接在数组对象的第一个数组中配置即可。如果无配置，则所有属性展示在一个大的分类下
HttpUtils工具类预置API一览表 表1 HttpUtils工具类预置API一览表 API API说明 getCookie 用于获取某个cookie的值。 setCookie 用于设置cookie的值。 getI18n 返回一个Vue18n的实例。 getCsrfToken
packageinfo.json 文件介绍 packageinfo.json是组件的元数据描述文件，用于配置组件的基本信息。 文件示例 { "widgetApi": [{ "name": "EchartsWidgetTemplate" }], "widgetDescription
配置项总览 本章节介绍AstroCanvas支持的组件配置项，您可以通过{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 是
内置API一览表 表1 内置API一览表 API API说明 init 组件渲染的入口函数，组件自己实现继承，使用推荐模板即可。 render 整个组件渲染的业务逻辑实现入口，组件自己实现继承。 getConnectorProperties 获取Connector对接的配置值，用于查看与
文件介绍及示例 文件介绍 {widget}.editor.js为组件属性定义文件，负责组件编辑状态时需要渲染的界面和逻辑。其中，“{widget}”为自定义组件的名称，如本示例中该文件名为“EchartsWidgetTemplate.editor.js”。{widget}.editor.js
SafeUtils安全工具类预置API一览表 表1 SafeUtils安全工具类预置API一览表 API API说明 escapeHtml() 将HTML字符串进行转义。 getSafeUrl() 对外部链接进行xss安全过滤，获取安全的绝对URL地址。 escapeHtml()
magno对象预置API一览表 表1 magno对象预置API一览表 API API说明 savePropertiesForWidget() 用于在开发态中保存当前组件的高级设置属性信息。 savePropertiesForWidget() 该API用于在开发态中，保存当前组件的高级设置属性信息
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
