检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
目录文件详解 i18n.json packageinfo.json {widget}.css {widget}.editor.js {widget}.ftl {widget}.js 父主题： 代码结构介绍
文件介绍及示例 文件介绍 {widget}.editor.js为组件属性定义文件，负责组件编辑状态时需要渲染的界面和逻辑。其中，“{widget}”为自定义组件的名称，如本示例中该文件名为“EchartsWidgetTemplate.editor.js”。{widget}.editor
使用页面模板文件新建页面 使用页面模板文件，构建开发页面，减少重复开发，提高交付效率。创建移动端页面操作和大屏&PC端页面相同，本章节以创建大屏&PC端页面为例进行介绍。 前提条件 已获取对应的页面模板文件，详情请参见下载当前页面。 通过页面模板文件新建页面 参考登录AstroC
您可以通过“Excel模式”和“Json模式”两种模式设置静态数据。设置为“Excel模式”时，可执行如下操作： 单击“文件导入”，可将本地的数据导入到当前组件中使用。仅支持导入CSV和Excel格式的文件，且文件大小不能超过100KB。 执行导入操作前，请单击“？”，查看当前组件对静态数据字段的要求。例如
”，可对该列进行编辑、删除、复制、左侧插入列和右侧插入列。 图3 编辑该列 导入Excel或CSV 单击“新增静态数据”，将本地的Excel或CSV文件（文件大小不能超过100KB）拖入“上传文件”中，单击“保存”。 单击“保存”，完成数据集的创建。 在数据集管理列表中，可查看到已创建的数据集。 在组件中使用数据集
目进行设置。 新建文件夹 项目创建后，支持在项目中新建文件夹，用于集中管理页面。 在“大屏&PC端项目”页面，单击“所有页面”后的“...”，选择“新建文件夹”。 图3 新建文件夹 在创建文件夹页面，输入文件夹标题，单击“确定”，即可在项目中创建文件夹。 文件夹标题的长度不能超过
在组件“.js”文件逻辑代码中，使用“thisObj.triggerEvent()”方法触发该事件时，要将变量字段传入发送的data中。 fields[0].desc 变量的中英文描述，可选配置。 在组件的“global_SelectWidget.js”文件中，注册名称为“sendSelect”的事件。
l传递给页面全局变量中，供其他组件使用。 典型示例 典型的eventConfig示例如下： // 组件事件配置项，定义组件事件结构及说明，给全局变量映射使用 eventConfig: { clickSeries: { desc: { zh_CN: '点击系列'
{widget}.editor.js 文件介绍及示例 eventConfig classfication propertiesConfig 父主题： 目录文件详解
与belong字段映射。 iconSrc String iconSrc: "image/setting.png" 图标地址。组件文件下，image文件中的setting.png。 classfication示例 classfication配置示例如下，其对应效果如图1所示。 classfication:
通过移动页面，将页面移动到其他文件夹中，便于页面集中管理。 移动页面 参考登录AstroCanvas界面中操作，登录AstroCanvas界面。 在项目列表中，单击页面所在的项目，进入项目。 将鼠标放在对应的页面上，单击“...”，选择“移动”。 选择目标文件夹，单击“确定”。 图1 移动页面
对项目进行设置。 创建文件夹 项目创建后，支持在项目中创建文件夹，用于集中管理页面。 在“移动端项目”页面，单击“所有页面”后的“...”，选择“新建文件夹”。 图3 新建文件夹 在创建文件夹页面，输入文件夹标题，单击“确定”，即可在项目中创建文件夹。 文件夹标题的长度不能超过6
{widget}.js 文件介绍 {widget}.js为组件逻辑文件，整个Widget的渲染核心JS，在组件编辑状态和页面最终的发布运行态都会被加载执行。一个推荐的组件架构，应包含表1中API。其中，init、render和beforeDestory为组件的通用生命周期函数，其余为推荐模板实现。
{widget}.ftl 文件介绍 {widget}.html为组件DOM结构文件，相当于HTML文件，负责样式展示。 在AstroCanvas中自定义组件时，需要在服务端提前渲染的部分，可以写在此文件中。 文件示例 <div id="EchartsWidgetTemplate"
propertiesConfig 字段介绍 propertiesConfig是一个数组，用于保存组件配置项的相关字段，包括数据接入配置、组件配置项。 图1 propertiesConfig配置示例 数据接入配置 数据接入配置详细介绍，请参见组件数据接入。 组件配置项 配置示例如下
packageinfo.json 文件介绍 packageinfo.json是组件的元数据描述文件，用于配置组件的基本信息。 文件示例 { "widgetApi": [{ "name": "EchartsWidgetTemplate" }], "widgetDescription":
组件触发自定义事件时，可以给全局变量赋值，fields数组中每一个对象保存着暴露给全局变量的详细配置。 图2 给全局变量赋值 表2 fields数组中对象字段详细说明 字段 类型 说明 name String key值。 desc Object 字段描述，需要国际化。 暴露给全局变量的字段，一定要在触发事件参数中定义，如图3。
"messages-en" // 组件的多语言文件,相应文件为messages-en.json }, { "name": "messages-zh" // 组件的多语言文件,相应文件为messages-zh.json } ], 文件示例 messages-zh.json配置示例
{widget}.css 文件介绍 {widget}.css为组件的样式文件，在该文件中编写组件的CSS样式。 AstroCanvas的组件未进行打包编译，CSS样式可能存在互相影响的风险。因为，CSS选择器务必要加上组件id，通过组件id减少互相影响的可能。 文件示例 #EchartsWidgetTemplate
刷新周期：每隔多少秒从AstroZero中读取一次数据，默认配置为“0”，表示只获取一次。 共享数据：是否共享数据。勾选后，如果多个组件调用了相同的桥接器URL请求，不会各自只调用，而是共享结果数据。 选中基本柱图组件，单击组件上方的，设置标题内容为“各市1月降雨量(mm)”。 图7
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
