检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
使用页面模板文件新建页面 使用页面模板文件,构建开发页面,减少重复开发,提高交付效率。创建移动端页面操作和大屏&PC端页面相同,本章节以创建大屏&PC端页面为例进行介绍。 前提条件 已获取对应的页面模板文件,详情请参见下载当前页面。 通过页面模板文件新建页面 参考登录华为云Ast
数据会随着全局变量值变化而变化。 如图1所示,也可以不使用“下拉选择框”组件,直接在发布的页面URL末尾加上“?全局变量名=值”,给页面全局变量赋值,查看组件的数据变化。 图1 在URL参数中给全局变量赋值 父主题: 全局变量
目录文件详解 i18n.json packageinfo.json {widget}.css {widget}.editor.js {widget}.ftl {widget}.js 父主题: 代码结构介绍
文件介绍及示例 文件介绍 {widget}.editor.js为组件属性定义文件,负责组件编辑状态时需要渲染的界面和逻辑。其中,“{widget}”为自定义组件的名称,如本示例中该文件名为“EchartsWidgetTemplate.editor.js”。{widget}.editor
生成测试Key 其中,“服务器机器码”请配置为2中获取的内容,服务器名称请根据实际情况进行配置。 返回本地部署信息页面,单击服务器机器码后的,下载测试Key文件(runtime.key)。 图11 下载测试Key文件 将获取的测试Key,上传到本地服务器的“/home/canva
分类的key及系统预置的图标。name值为预置类型时,tip和iconSrc非必填。name字段值应与belong字段映射。 iconSrc String iconSrc: "image/setting.png" 图标地址。组件文件下,image文件中的setting.png。 classfication示例
您可以通过“Excel模式”和“Json模式”两种模式设置静态数据。设置为“Excel模式”时,可执行如下操作: 单击“文件导入”,可将本地的数据导入到当前组件中使用。仅支持导入CSV和Excel格式的文件,且文件大小不能超过100KB。 执行导入操作前,请单击“?”,查看当前组件对
在所有页面中,单击待下载的页面。 单击“编辑页面”,进入大屏开发页面。 在页面上方工具栏中,单击,即可将当前页面下载到本地。 下载到本地的页面模板文件命名为“当前页面的名称”.page。 图1 将大屏页面保存为页面模板文件 父主题: 页面管理
"messages-en" // 组件的多语言文件,相应文件为messages-en.json }, { "name": "messages-zh" // 组件的多语言文件,相应文件为messages-zh.json } ], 文件示例 messages-zh.json配置示例
packageinfo.json 文件介绍 packageinfo.json是组件的元数据描述文件,用于配置组件的基本信息。 文件示例 { "widgetApi": [{ "name": "EchartsWidgetTemplate" }], "widgetDescription":
migrateFrom: 'advancedSettings', headerTitle: { zh_CN: '数据映射', en_US: 'Data Mapping' }, belong: 'configuration', config:
{widget}.ftl 文件介绍 {widget}.html为组件DOM结构文件,相当于HTML文件,负责样式展示。 在华为云Astro大屏应用中自定义组件时,需要在服务端提前渲染的部分,可以写在此文件中。 文件示例 <div id="EchartsWidgetTemplate"
eventConfig 字段介绍 eventConfig为组件事件配置项,用于定义组件事件暴露的变量结构,以及事件和对外透传变量的业务含义。eventConfig配置好后,在组件配置交互时可以将事件的itemVal传递给页面全局变量中,供其他组件使用。 典型示例 典型的eventConfig示例如下:
{widget}.js 文件介绍 {widget}.js为组件逻辑文件,整个Widget的渲染核心JS,在组件编辑状态和页面最终的发布运行态都会被加载执行。一个推荐的组件架构,应包含表1中API。其中,init、render和beforeDestory为组件的通用生命周期函数,其余为推荐模板实现。
{widget}.css 文件介绍 {widget}.css为组件的样式文件,在该文件中编写组件的CSS样式。 华为云Astro大屏应用的组件未进行打包编译,CSS样式可能存在互相影响的风险。因为,CSS选择器务必要加上组件id,通过组件id减少互相影响的可能。 文件示例 #EchartsWidgetTemplate
{widget}.editor.js 文件介绍及示例 eventConfig classfication propertiesConfig 父主题: 目录文件详解
此时需要一层映射,例如将name映射到x上,将ranking映射到y上,将series映射到s上。但是每次这个映射都不固定,需要交给用户自行配置,所以提出了映射的概念,即mapping。 图2 映射 由用户自己决定将什么字段拖拽映射到什么字段。例如,将name字段映射到了“选项标
中选项)时发出的事件。 注册自定义事件 自定义事件在{widget}.editor.js文件中的eventConfig配置项中注册,以global_SelectWidget组件为例: 在文件global_SelectWidget.editor.js中定义事件 eventConfig:
gt; getSafeUrl() 对外部链接进行xss安全过滤 ,获取安全的绝对URL地址,使用方式参考如下: /* * @param {*} url */ SafeUtils.getSafeUrl(url); SafeUtils.getSafeUrl('/test.html')
其中,“frame-ancestors”为固定格式,“域名”为大屏待嵌入的第三方系统的域名。除了上述场景外,还有一种典型的场景是将大屏嵌入本地的file中,如图3。 图3 将大屏嵌入本地的file中 登录第三方系统,在Elements中,增加“<iframe src="URL" ></iframe>”。