检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
在组件模板列表中,单击所需的模板模板,进入模板详情页。 图1 预置组件模板 在模板详情页,单击“下载”,将模板下载到本地。 认识Widget包目录结构 解压下载到本地的组件Widget包,认识组件结构。如解压EchartsWidgetTemplate组件包,其目录结构如图2所示。 图2 Widget包目录结构
代码结构介绍 了解代码目录结构 目录文件详解 父主题: 自定义组件开发规范
json {widget}.css {widget}.editor.js {widget}.ftl {widget}.js 父主题: 代码结构介绍
'只聚焦当前高亮的数据的图形', en_US: 'Self' }, value: 'self', }, { label: { zh_CN: '聚焦当前高亮的数据所在的系列的所有图形'
定义组件事件暴露的变量结构,以及事件和对外透传变量的业务含义。eventConfig配置好后,在组件配置交互时可以将事件的itemVal传递给页面全局变量中,供其他组件使用。 典型示例 典型的eventConfig示例如下: // 组件事件配置项,定义组件事件结构及说明,给全局变量映射使用
classfication字段代表的是当前组件需要展示哪些大的配置项分类。华为云Astro大屏应用在设计前期对分类也进行了分组,因此这个字段被扩展为双数组形式。一般默认情况下,直接在数组对象的第一个数组中配置即可。如果无配置,则所有属性展示在一个大的分类下。 classfication中的配置包含预置分类和自定义分类两种。
助您更加合理有效的排列大屏上的组件。 位置层次越靠前,表示组件在画布中的显示越靠前。 位置层次越靠后,表示组件在画布中的显示越靠后。 当两个组件重叠时,位置靠前的组件会覆盖位置靠后的。 在画布中移动 参考创建页面中操作,创建所需的页面。 在设计页面,选中待移动的组件。 单击右键,
widegtApi > name:组件的名称,如“EchartsWidgetTemplate”。 widgetDescription:组件的描述信息。 authorName: :组件的作者信息。 width:在绝对布局高级页面中,添加该组件时的默认宽度,单位为“px”,不填写默认为“200px”。
json 文件介绍 i18n.json为组件的国际化资源文件,用于配置多语言,目前支持的多语言包含中英文两种,相应的key值分别为['zh-CN','en-US']。多语言文件支持配置在多个Json中,在packageinfo.json中的配置示例如下: "i18n": [{ "name":
css 文件介绍 {widget}.css为组件的样式文件,在该文件中编写组件的CSS样式。 华为云Astro大屏应用的组件未进行打包编译,CSS样式可能存在互相影响的风险。因为,CSS选择器务必要加上组件id,通过组件id减少互相影响的可能。 文件示例 #EchartsWidgetTemplate
'只聚焦当前高亮的数据的图形', en_US: 'Self' }, value: 'self', }, { label: { zh_CN: '聚焦当前高亮的数据所在的系列的所有图形'
自定义组件开发规范 代码结构介绍 组件配置项(Config配置) 组件内置API 组件数据接入 组件交互
最大高度:设置下拉弹出框的最大高度。 背景颜色:设置下拉弹出框的背景色。 字体颜色:设置下拉弹出框中字体的颜色。 选中态背景颜色:设置选中某项内容时,背景的颜色。 选中态字体颜色:设置选中某项内容时,字体的颜色。 鼠标悬浮时背景颜色:设置鼠标悬浮在某项内容上时,背景的颜色。 鼠标悬浮时
组件核心渲染API,负责组件的实例化、数据调用及事件、动作的实际实现。 是 beforeDestroy(生命周期函数) 组件销毁回调事件,负责组件在销毁期间的内存释放逻辑实现,需要把组件绑定的一些dom事件及全局的引用销毁。 是 initContainer render中抽取的独立逻辑,初始化
样例报文:对应API接口的响应样例报文数据格式,数据集的元数据结构由该样例报文经转换器处理后的数据结构确定。 转换器:选择新建转换器中创建的转换器或华为云Astro大屏应用预置的转换器,用于对数据进行转换处理。本示例新建一个转换器,用于返回符合条件的数据。 图3 新增一个转换器
{widget}.ftl 文件介绍 {widget}.html为组件DOM结构文件,相当于HTML文件,负责样式展示。 在华为云Astro大屏应用中自定义组件时,需要在服务端提前渲染的部分,可以写在此文件中。 文件示例 <div id="EchartsWidgetTemplate"
{widget}.editor.js 文件介绍及示例 eventConfig classfication propertiesConfig 父主题: 目录文件详解
目录”,新建一个目录。 责任人:数据集的创建人。 描述:新建数据集的描述信息,通常设置为数据集的功能。 配置数据集参数。 图3 设置数据集 应用:选择调用自定义接口所属的应用。 API接口:选择待调用的API接口,下拉框中的选项取值为接口的标签,如果接口标签取值为中文,则这里“A
根据业务需求,设置自定义桥接器中的数据连接逻辑,并将该目录中的所有文件和文件夹打成zip包。 将开发好的自定义桥接器zip包上传到华为云Astro大屏应用中。 在我的资产中,单击左侧导航栏的“我的桥接器”。 单击“添加新桥接器”,在“上传源文件”中,选择本地打包好的自定义桥接器包。 设置发行说明后,单击“提交”。
桥接器为连接前台页面和后台数据的连接器。在进行前台页面开发时,经常要调用后台数据,例如购物车中用户的ID,订单编号,商品信息等,这时需要通过桥接器动态调用后台接口获取后台数据。通过华为云Astro大屏应用预置的桥接器模板,您可以自定义桥接器。自定义桥接器时,需要先下载桥接器模板,根据组件的数据结构,对桥