可视化组件开发标准1.0

文档创建者:admin
浏览次数:642
最后更新:2024-05-14
组件文档
AI001: 组件标准 » 开发手册
关于可视化组件开发标准规范:


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
  1. document.write('<link rel="stylesheet" href="lib/layui.css">');
  2. document.write('<script src="lib/layui.js"><\/script>');
复制代码

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

关于私人库应用规则:

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

005506iugbgjvhfljfzduc.png


如上图,以下序号为上面红色圆圈序号
顶部规则
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 绑定事件 ["挂接事件左键","挂接事件右键"]
为了统一标准,建议将改事件统一放在事件类型变量的最底部

未完待续。

案例模板:
组件自绘系列案例模板.zip (9.5 KB)





您需要登录后才可以回帖 登录 | 立即注册

本版积分规则