检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 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 父主题： 代码结构介绍
组件图层位置移动 操作场景 在AstroCanvas大屏开发页面，支持将组件图层向上、向下移动一层或移动至底层等，帮助您更加合理有效的排列大屏上的组件。 位置层次越靠前，表示组件在画布中的显示越靠前。 位置层次越靠后，表示组件在画布中的显示越靠后。 当两个组件重叠时，位置靠前的组件会覆盖位置靠后的。
文件介绍及示例 文件介绍 {widget}.editor.js为组件属性定义文件，负责组件编辑状态时需要渲染的界面和逻辑。其中，“{widget}”为自定义组件的名称，如本示例中该文件名为“EchartsWidgetTemplate.editor.js”。{widget}.editor
{widget}.ftl 文件介绍 {widget}.html为组件DOM结构文件，相当于HTML文件，负责样式展示。 在AstroCanvas中自定义组件时，需要在服务端提前渲染的部分，可以写在此文件中。 文件示例 <div id="EchartsWidgetTemplate"
在项目列表中，单击已创建项目的名称，进入对应的项目页面。 在项目中，单击，选择本地的页面模板文件，单击“打开”。 图1 添加本地页面模板文件 在创建页面对话框中，输入页面标题，单击“新建”。 系统自动进入业务大屏开发页面，您可以直接使用该大屏应用，也可以根据自身业务的需求进行二次开发。 单击页面上方的，保存页面。
{widget}.js 文件介绍 {widget}.js为组件逻辑文件，整个Widget的渲染核心JS，在组件编辑状态和页面最终的发布运行态都会被加载执行。一个推荐的组件架构，应包含表1中API。其中，init、render和beforeDestory为组件的通用生命周期函数，其余为推荐模板实现。
{widget}.css 文件介绍 {widget}.css为组件的样式文件，在该文件中编写组件的CSS样式。 AstroCanvas的组件未进行打包编译，CSS样式可能存在互相影响的风险。因为，CSS选择器务必要加上组件id，通过组件id减少互相影响的可能。 文件示例 #EchartsWidgetTemplate
{widget}.editor.js 文件介绍及示例 eventConfig classfication propertiesConfig 父主题： 目录文件详解
行设置。 新建文件夹 项目创建后，支持在项目中新建文件夹，用于集中管理页面。 在“大屏&PC端项目”页面，单击“所有页面”后的“...”，选择“新建文件夹”。 图3 新建文件夹 在创建文件夹页面，输入文件夹标题，单击“确定”，即可在项目中创建文件夹。 文件夹标题的长度不能超过64
如何进行设置页面 在大屏页面中，可以对页面进行一些基础的配置，例如屏幕大小、背景颜色及背景图片等效果的设置。 屏幕大小 页面的屏幕大小，可以使用默认的屏幕大小，也可以自定义页面的大小，以适配大屏尺寸，推荐常用尺寸1920*1080、1600*900及3840*2080等。 图1 屏幕大小
根据业务需求自定义静态数据，也可直接使用系统预置的数据，单击“保存”。 您可以通过“Excel模式”和“Json模式”两种模式设置静态数据。设置为“Excel模式”时，可执行如下操作： 单击“文件导入”，可将本地的数据导入到当前组件中使用。仅支持导入CSV和Excel格式的文件，且文件大小不能超过100KB。
classfication字段代表的是当前组件需要展示哪些大的配置项分类。AstroCanvas在设计前期对分类也进行了分组，因此这个字段被扩展为双数组形式。一般默认情况下，直接在数组对象的第一个数组中配置即可。如果无配置，则所有属性展示在一个大的分类下。 classfication中的配置包含预置分类和自定义分类两种。
i18n.json 文件介绍 i18n.json为组件的国际化资源文件，用于配置多语言，目前支持的多语言包含中英文两种，相应的key值分别为['zh-CN','en-US']。多语言文件支持配置在多个Json中，在packageinfo.json中的配置示例如下： "i18n":
通过移动页面，将页面移动到其他文件夹中，便于页面集中管理。 移动页面 参考登录AstroCanvas界面中操作，登录AstroCanvas界面。 在项目列表中，单击页面所在的项目，进入项目。 将鼠标放在对应的页面上，单击“...”，选择“移动”。 选择目标文件夹，单击“确定”。 图1 移动页面
视图切换 操作场景 通过视图切换功能，可将页面中的组件切换为列表或卡片样式。 列表：展示了所有组件的icon和标题，方便组件的快速查找。 卡片：展示了组件的初始化样式和标题，方便组件的预览和图层位置的调整。 切换图层 参考创建页面中操作，创建所需的页面。 选择“图层”，进入图层页面。 当
packageinfo.json 文件介绍 packageinfo.json是组件的元数据描述文件，用于配置组件的基本信息。 文件示例 { "widgetApi": [{ "name": "EchartsWidgetTemplate" }], "widgetDescription":
'只聚焦当前高亮的数据的图形', en_US: 'Self' }, value: 'self', }, { label: { zh_CN: '聚焦当前高亮的数据所在的系列的所有图形'
eventConfig为组件事件配置项，用于定义组件事件暴露的变量结构，以及事件和对外透传变量的业务含义。eventConfig配置好后，在组件配置交互时可以将事件的itemVal传递给页面全局变量中，供其他组件使用。 典型示例 典型的eventConfig示例如下： // 组件事件配置
sendSelect String 自定义事件的key值。 desc Object 自定义事件的中英文描述。 fields Array 自定义事件中，暴露给全局变量的内容。 触发自定义事件 在文件global_SelectWidget.ftl文件中，监听el-select的change事件 <el-select
目进行设置。 创建文件夹 项目创建后，支持在项目中创建文件夹，用于集中管理页面。 在“移动端项目”页面，单击“所有页面”后的“...”，选择“新建文件夹”。 图3 新建文件夹 在创建文件夹页面，输入文件夹标题，单击“确定”，即可在项目中创建文件夹。 文件夹标题的长度不能超过64个
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
