检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
{widget}.js 文件介绍 {widget}.js为组件逻辑文件,整个Widget的渲染核心JS,在组件编辑状态和页面最终的发布运行态都会被加载执行。一个推荐的组件架构,应包含表1中API。其中,init、render和beforeDestory为组件的通用生命周期函数,其余为推荐模板实现。
{widget}.editor.js 文件介绍及示例 eventConfig classfication propertiesConfig 父主题: 目录文件详解
在主菜单中,选择“我的资产”。 在左侧导航栏中,单击“我的库”。 将鼠标放在对应的库上,单击,获取锁。 将鼠标放在对应的库上,单击,进入更新库页面。 图7 进入更新库页面 在库更新页面,上传新的库、设置库参数,单击“更新”。 图8 设置库信息 将鼠标放在对应的库上,单击,可查看到新版本的库。 :单击该图标,可下载当前版本库。
图形-自定义 series 图表的系列数据配置。 legend 图例-自定义 legend 图表的图例显示/隐藏、样式控制配置。 tooltip 提示-自定义 tooltip 图表的悬浮提示配置。 coordinate 坐标轴-自定义 coordinate 图表的X、Y坐标轴配置。 referenceLine
{widget}.editor.js为组件属性定义文件,负责组件编辑状态时需要渲染的界面和逻辑。其中,“{widget}”为自定义组件的名称,如本示例中该文件名为“EchartsWidgetTemplate.editor.js”。{widget}.editor.js文件只在组件编辑状态被加
注册事件,只有通过此API注册后的事件才会在组件的事件列表中展现。 registerAction 用来注册动作,只有通过此API注册后的事件才会在组件的动作列表中展现。 inReader 判断当前页面状态是开发态或预览态。 registerWidget 必须在{widget}.editor.js中注册组件,使用方式参考如下:
eventConfig为组件事件配置项,用于定义组件事件暴露的变量结构,以及事件和对外透传变量的业务含义。eventConfig配置好后,在组件配置交互时可以将事件的itemVal传递给页面全局变量中,供其他组件使用。 典型示例 典型的eventConfig示例如下: // 组件事件配置
组件自定义事件实现 组件之间的交互,主要包括组件自定义事件和组件响应动作,本章节将为您介绍组件自定义事件的实现方式。自定义事件是指组件作为触发器,当用户操作组件(比如下拉框选中选项)时发出的事件。 注册自定义事件 自定义事件在{widget}.editor.js文件中的eventConfi
数据源名称:新建数据源的名称,用于标识该数据源。长度为1~32个字符,可包括中文、字母、数字及下划线,且不能以下划线开头或结尾。 域名:华为云Astro轻应用环境的域名,需要携带“https://”。 客户端ID:调用华为云Astro轻应用接口前,需要配置“客户端模式”OAuth鉴权的客户端ID,获取方法请参考客户端模式接入认证。
全局变量的值。 图9 全局变量 获取组件对象并操作组件 获取组件。 在“图层”页面,选中日期选择器组件。 图10 选中日期选择器组件 将鼠标悬浮在日期选择器上,组件名称即为组件ID。 图11 获取组件ID 操作组件。 获取到组件ID后,可以通过AstroCanvas提供的API来
自定义组件开发过程如下,也可以直接单击下载链接,获取自定义组件示例包“SelectWidget.zip”。 在组件的“global_SelectWidget.editor.js”文件中,新增eventConfig配置。 eventConfig其实是一个对象,里面包含组件触发的自定义事件、自定义事件的说明以及事件对外输出的变量名、变量含义。
包下载到本地。 解压已下载的组件模板包,认识组件结构。 表2 组件文件结构 文件名 文件说明 EchartsWidgetTemplate.js 组件逻辑文件,整个Widget的渲染核心JS,在组件编辑状态和页面最终的发布运行态都会被加载执行。主要包含的预置API说明请参见表3。
'只聚焦当前高亮的数据的图形', en_US: 'Self' }, value: 'self', }, { label: { zh_CN: '聚焦当前高亮的数据所在的系列的所有图形'
组件对接数据配置开关 组件的数据可来自于静态数据或通过数据集获取,以EchartsWidgetTemplate组件为例,在“{Widget}”.editor.js文件中,可配置组件接入的数据。当识别到组件propertiesConfig中存在dataSetting类型的配置项时,默认组件需要对接数据集。配置示例如下:
安全策略设置样例 其中,“frame-ancestors”为固定格式,“域名”为大屏待嵌入的第三方系统的域名。除了上述场景外,还有一种典型的场景是将大屏嵌入本地的file中,如图3。 图3 将大屏嵌入本地的file中 登录第三方系统,在Elements中,增加“<iframe src="URL"
组件除了可以作为事件的触发器,还可以处理事件的响应动作,在响应动作中选择组件响应,就可以选择对应的组件响应动作,数据刷新、获取当前输入框值等都是组件的自定义响应动作。本章节将向您介绍,如何实现组件响应动作。 注册动作 在响应动作中,单击“响应动作”,在下拉框中选择对应的响应动作。 图1
数据源名称:新建数据源的名称,用于标识该数据源。长度为1~32个字符,可包括中文、字母、数字及下划线,且不能以下划线开头或结尾。 数据库类型:数据库支持的类型,按需选择。 域名:数据库所在的域名。 端口:数据库端口,取值范围为0~65535。 架构名称:MS SQL Server数据库的架构名称。当“数据库类型”配置为“MS
对外部链接进行xss安全过滤,获取安全的绝对URL地址。 escapeHtml() 对HTML字符串进行转义,获取转义后的字符串供页面显示用,使用方式参考如下: /* * @param {*} text */ SafeUtils.escapeHtml(text) // 方法返回转义后的字符串 例如输入字符串如下:
'只聚焦当前高亮的数据的图形', en_US: 'Self' }, value: 'self', }, { label: { zh_CN: '聚焦当前高亮的数据所在的系列的所有图形'
手用户可以轻松获取转换器,提升转换器的易用性。 在盘古助手中,您可以通过直接提问来获取转换器,也可以通过快捷指令来获取对应的转换器。本章节以快捷指令中内容为例,向您介绍如何使用盘古助手。 代码优化 参考新建转换器中操作,新建一个转换器。 在“测试数据”中,选择所需的数据源。 在“function