亿信ABI
当前版本:5.6.1

新建酷屏组件

1.新建入口

在【系统管理】-【组件库管理】-【组件库】-【酷屏组件】-【自定义组件】中,可以新建分组,在分组中点击【新建组件】,就打开到了酷屏组件设计器,也可以克隆内置组件进行修改和编辑。

以下是酷屏组件设计器:

2.设计器功能介绍

2.1代码区说明

1)HTML文件

本部分用来写HTML静态代码,组件中,只要是静态的、不变的、不需要交互(动态传值)的部分,都可以写在这里面。建议只要能写静态的,就绝不要写动态,因为这样浏览器执行效率会高很多。

2)js文件

本部分写动态的js脚本,根据该文件里和wiki中提供的模板,来完成你所需要的功能吧。第一次写注意一下各个参数的意义,以及参数的值的形式。

3)CSS文件

本部分写css样式文件。注意:js文件和css文件会以从左到右的顺序依次被编译,因此如果js存在父子关系的对象,父对象要放在子对象左边,这些js和css只会在该组件中被调用,作用于本组件中。

2.2取数定义说明

取数定义里定义的数据,即为组件在运行时需要的参数,一般是可以通过sql数据源获得的数据,在定义时,可以设定一个默认值。

点击【取数】后,在弹出的对话框中,点击 "+"  号,就可以实现变量的创建,变量设定完毕后,点击 "确认" 保存。

所有的取数,在js代码中,都会以字符串的形式存放在 "vardata" 参数中,例如上图中,想使用 txts 参数,就要写成 vardata.txts。

2.3组件属性配置说明

点击【属性】按钮,弹出组件属性定义对话框。

点击【高级配置】,切换到json配置界面,点击【默认配置】,回到上图的可视化配置界面。业务人员和研发人员都可以根据自己的需求来选择不同的界面,提高工作效率。

下图为一个自定义组件的属性,前面8个属性(即从name到isdelay)为组件的默认属性,从第9个(maxY属性)开始是新增的属性,点击 “+” 号可新增属性,行末的”-”号删除属性。

定义一个属性,需正确进行下面设置:

1) 属性名称,可以理解为该属性的唯一标识,一个组件中的属性名称不能重复;也就是你在写js代码时,在 “setProperty” 方法中传入的 “key” 值。

2) 属性标题,是属性的中文名称,显示在酷屏编辑页面的右侧属性面板中。比如上图中 “width” 属性,其属性标题为“宽”,在酷屏组件的属性面板中显示为“宽”。

3) 类型,分为很多种,组件编辑者根据该属性的需要,选择相应的类型。

4) 编辑,指是否能在酷屏编辑页面的右侧属性面板,对该属性进行写操作。不勾选,该属性就是不可写状态。

5) 显示,如果勾选了,该属性就会显示在属性面板上,不勾选,则该属性不显示在属性面板。

 

再来看“事件”选项,“事件”是该组件提供的对外接口,主要用于与其他组件进行联动。具体这个接口中做什么事,是由使用该组件的人来填写。

2.4插入图片功能说明

插入图片,就是将所需的图片文件,从本地上传到酷屏服务器中。

点击上传图片,选择所需要上传的图片就行了,单击所需要的图片,点击“确定”就可以将图片插入了。

这里值得一说的是,“图片管理”的默认界面,显示的都是“用户图标”,如上图。“系统图标”按钮点击后,所显示的图片就是系统自带的,一般用户并不能往系统图标里上传图片。

2.5预览功能说明

“预览”按钮点击后,会显示你的组件当前的实际效果。

2.6另存为“HTML”组件

这个按钮可以为你的组件创建一个新的副本并保存。

3.新建酷屏组件流程

1) 点击新建酷屏组件,打开组件编辑窗口

2) 添加组件取数定义

3) 添加组件属性、组件事件

4) 插入图片素材

5) 通过你掌握的html、js、css知识,依次写好对应的三个文件

6) 点击预览,看你的组件效果

7) 检查并debug调试你的组件,直至符合要求,最后“保存”

至此,一个酷屏组件就编写完毕了。


附件列表

0

文档内容仅供参考
如果您需要解决具体问题,还可以登录亿信社区
在提问求助板块提问,30分钟内帮您解决问题

如果您认为本词条还有待完善,请编辑

上一篇制作酷屏报表

下一篇如何使用全局资源

请先登录