精易论坛

标题: 可视化组件开发标准1.0 [打印本页]

作者: 流云思水 时间: 2025-1-15 18:00
标题: 可视化组件开发标准1.0
本帖最后由流云思水于 2025-1-15 18:05 编辑

关于可视化组件开发标准规范：

1.新建项目仅允许一个类的存在。

2.内部事件命名规范：挂接事件xx 例如：挂接事件点击前面必须为挂接事件开头

3.设定图标：在项目根目录添加文件夹 lib

在lib文件夹中放入logo.png 图片即可。注：该图片大小为64*64最佳

4.引入第三方插件javascript库，则需要将库文件打包为 ChaJian.zip 里面主要引用文件必须明明为 chajian.js 该压缩包 ChaJian.zip 同样存放在lib目录中。
关于多文件，chajian.js内容可 lib是自己chajian.js 同目录下创建的lib并非自身原始lib而是 lib/lib

document.write('<link rel="stylesheet" href="lib/layui.css">');
document.write('<script src="lib/layui.js"><\/script>');

[color=rgb(51, 102, 153) !important]复制代码

5.使用文档与案例，需要在教程区描述仔细并附带案例组件规范一

关于私人库应用规则：

在IDE的根目录下 Temp/本地库/ 我们可以将自己的组件库编译后放入。
注：如果因为组件错误，放入后，会导致整个可视化项目异常，请删除后重新优化测试。

如上图，以下序号为上面红色圆圈序号
顶部规则
1.组件分类（根据自己定义的分类，会在可视化组件分类上自动归类）
2.组件备注（鼠标移动到可视化组件区域会提示的信息）
变量规则
3.默认的普通类中变量对象，可以看到左侧列表树中在 _矩形插件下有个框架的常量对象
4.可视化右侧属性设计类型，数值为6-10 其中6则为纹理事，其他则为普通属性修改事件
5.同上原理

关于类型详细表达如下

组件类型：
属性类：
6 资源按钮栏(允许输入点击按钮会弹出一个资源项目)
7 属性修改栏
8 颜色修改栏
9 选择框
10 组合框  （默认值必须是数组文本值例如 ["1","2"]) 英文的双引号

插件中必须公开的三个事件绑定属性栏

初始化包含 x，y，宽，高四个数值型参数，其中必须设置框架.LH=宽框架.LW=高  然后  容器设置大小(框架，宽，高)

纹理修改如果要修改纹理，必须设定  包含  类型，内容两个文本参数

属性修改如果要修改属性，必须设定 包含  类型，内容两个文本参数

创建组件()  这里是组件一切就绪后，最后会自动执行的方法，可以在这里自己添加需要的功能。

新增伪组件系统：（伪组件，指某些组件过于复杂，特殊组件，添加到设计器会导致设计器异常无法添加到容器的组件）

当前组件创建方法必须放在

创建组件() 事件中，且必须对外公开。

初始化地方，可以使用其他图片文字，容器，等组件做一个设计时候的外观以及纹理属性修改，创建时候只需要直接调用属性即可
注：创建组件是最后执行，且必须在属性栏勾选运行时候才有效。可以在组件备注中给与提示~

需要注意的是，如果当前对外公开的框架是容器的话，请务必设置容器宽高哦，否则设计器上无法点击到组件。框架.LW 与框架.LH 是设计器的宽高点击必须设计

重点提醒：在Json中配置时候，一定不要出错！其中键或文本值必须是双引号值如果是颜色值必须写十进制，不允许写16进制

新增规范：

2024年6月3日

1.增加设置大小方法，该方法可在可视化中拖动这个组件大小，组件大小设置方法逻辑必须无错误。（两个参数：宽，高）

记得必须同步宽高,LW,LH，否则会异常

注：设置大小这个函数，有有必要请在在组件的对象上面挂接事件比如框架.设置大小=设置大小这样属于可视化统一规则标准（可选行为）

网络组件规范申明：
关于颜色值：
在属性栏上传入的所有颜色均为0x系列颜色，如果是文字对象需要修改颜色，必须将0x或0X替换为#，但不要使用到文本，到整数命令。
矩形，游戏对象设置对象颜色，画图形颜色时候，直接使用，不要使用到整数等命令。均可。

//更新2024年10月18日
新增绑定事件功能
类型变量中，新增变量为：绑定事件对外设定命名为绑定事件，类型 10 里面的数组成员值为你对外公开的事件名例如：
绑定事件文本型 10 绑定事件 ["挂接事件左键","挂接事件右键"]
例如：

为了统一标准，建议将改事件统一放在事件类型变量的最顶部
注意，要添加一个同步的事件，前缀为 _绑定_挂接事件左键例如：
里面参数为你当前挂接事件要传出的。

//更新
新增环境变量检测 _SyBT__001_ 如果为真则是在可视化设计场景

_SyBT__001_ 用于检测是否为当前设计场景窗口宽 * 倍数, 窗口高 * 倍数

案例模板：

核心按钮三层2024年11月14日143413.zip (6.87 KB, 下载次数: 2)

231237x37k70bmjjsyn6zu.png (18.55 KB, 下载次数: 0)

作者: weihua2018 时间: 2025-1-15 18:50
为什么没有效果图

欢迎光临精易论坛 (https://125.confly.eu.org/)