检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
label" } 配置项的标签,需要国际化。 tip Object 否 tip: { zh_CN: "中文提示", en_US: "English tip"} 提示图标,当配置项比较复杂,可以添加一些提示内容。 noToolTip Boolean 否 noToolTip: false
packageinfo.json 文件介绍 packageinfo.json是组件的元数据描述文件,用于配置组件的基本信息。 文件示例 { "widgetApi": [{ "name": "EchartsWidgetTemplate" }], "widgetDescription": "Echarts组件模板"
配置项总览 本章节介绍华为云Astro大屏应用支持的组件配置项,您可以通过{widget}.editor.js文件中定义的type字段,来定义组件的类型和配置。 表1 配置项总览 类别 类型 说明 输入框 input 单行文本输入框 textarea 多行文本输入框 数字类型 input-number
目录文件详解 i18n.json packageinfo.json {widget}.css {widget}.editor.js {widget}.ftl {widget}.js 父主题: 代码结构介绍
{}); eventConfig:组件事件描述配置项,用来扩展给全局变量使用。 classfication:组件的配置项分类。 propertiesConfig:负责组件配置页面中,右侧的属性配置逻辑。 create(必须配置):组件内置的扩展,仅在组件首次被创建时调用一次。
i18n.json 文件介绍 i18n.json为组件的国际化资源文件,用于配置多语言,目前支持的多语言包含中英文两种,相应的key值分别为['zh-CN','en-US']。多语言文件支持配置在多个Json中,在packageinfo.json中的配置示例如下: "i18n":
使用页面模板文件新建页面 使用页面模板文件,构建开发页面,减少重复开发,提高交付效率。创建移动端页面操作和大屏&PC端页面相同,本章节以创建大屏&PC端页面为例进行介绍。 前提条件 已获取对应的页面模板文件,详情请参见下载当前页面。 通过页面模板文件新建页面 参考登录华为云Ast
在页面右上角,单击“账号名”,选择“本地部署”。 图3 选择本地部署 在本地部署信息中,单击“下载运行环境”,下载华为云Astro大屏应用运行环境部署包。 运行环境部署包用于在服务器上部署华为云Astro大屏应用服务,包名为“AstroCanvas_Runtime.zip”。如果需要下载历史版本的部署包,可以单
configuration 配置-自定义 configuration 组件级的配置项建议放到该分类中,如背景、标题等。 series 图形-自定义 series 图表的系列数据配置。 legend 图例-自定义 legend 图表的图例显示/隐藏、样式控制配置。 tooltip 提示-自定义 tooltip
propertiesConfig是一个数组,用于保存组件配置项的相关字段,包括数据接入配置、组件配置项。 图1 propertiesConfig配置示例 数据接入配置 数据接入配置详细介绍,请参见组件数据接入。 组件配置项 配置示例如下,配置后效果如图2所示,组件配置项详细介绍请参见表1。 {
eventConfig为组件事件配置项,用于定义组件事件暴露的变量结构,以及事件和对外透传变量的业务含义。eventConfig配置好后,在组件配置交互时可以将事件的itemVal传递给页面全局变量中,供其他组件使用。 典型示例 典型的eventConfig示例如下: // 组件事件配置项,定义组件事件结构及说明,给全局变量映射使用
选择“关系型数据库”,配置数据源参数。 图1 新建关系型数据库数据源 数据源名称:新建数据源的名称,用于标识该数据源。长度为1~32个字符,可包括中文、字母、数字及下划线,且不能以下划线开头或结尾。 数据库类型:数据库支持的类型,按需选择。 域名:数据库所在的域名。 端口:数据库端口,取值范围为0~65535。
{widget}.js 文件介绍 {widget}.js为组件逻辑文件,整个Widget的渲染核心JS,在组件编辑状态和页面最终的发布运行态都会被加载执行。一个推荐的组件架构,应包含表1中API。其中,init、render和beforeDestory为组件的通用生命周期函数,其余为推荐模板实现。
在数据源管理页面,单击“新建数据源”。 选择“AstroZero”,配置数据源参数。 图1 数据源 数据源名称:新建数据源的名称,用于标识该数据源。长度为1~32个字符,可包括中文、字母、数字及下划线,且不能以下划线开头或结尾。 域名:华为云Astro轻应用环境的域名,需要携带“https://”。 客户端
{widget}.css 文件介绍 {widget}.css为组件的样式文件,在该文件中编写组件的CSS样式。 华为云Astro大屏应用的组件未进行打包编译,CSS样式可能存在互相影响的风险。因为,CSS选择器务必要加上组件id,通过组件id减少互相影响的可能。 文件示例 #EchartsWidgetTemplate
label" } 配置项的标签,需要国际化。 tip Object 否 tip: { zh_CN: "中文提示", en_US: "English tip"} 提示图标,当配置项比较复杂,可以添加一些提示内容。 noToolTip Boolean 否 noToolTip: false
labelWidth: 20, }] list中每一项含有的基础配置项。 基础配置项中可以通过加入width调整一行中的占比,例如3个options的width是20,30,30,三个配置项就会出现在一行。如果width是20,30,70,前两个会在一行,第三个占第二行的70%。 如果不加入wi
{widget}.ftl 文件介绍 {widget}.html为组件DOM结构文件,相当于HTML文件,负责样式展示。 在华为云Astro大屏应用中自定义组件时,需要在服务端提前渲染的部分,可以写在此文件中。 文件示例 <div id="EchartsWidgetTemplate"
新建全局变量。 后台分页需要搭配全局变量使用,请创建pageSize、offset两个变量(变量名称可自定义),并为变量添加默认值。因为在触发分页或改变每页数量时需要使用上述两个变量,所以需要一个初始值,否则无法执行到数据配置。 图2 新建分页全局变量 交互设置。 选中高级表格组件,单击,进行组件交互设置。
页面数据集 操作场景 通过页面数据集,实现多个组件对接同一个数据输入,减少重复的请求和配置。同时,在新建页面数据集时,还支持配置多数据输入(最多10个),来实现组件同时对接多个数据流。 本章节以将两个静态数据集(多数据流1、多数据流2)中的数据汇合后,作为组件的数据来源为例,向您介绍如何创建并使用页面数据集。