介绍

第一、了解与下载

全课云UI,是由bootstrap3.0基础上搭建的前端应用项目框架,统一html布局规范和css基础样式,模块化js; 快速了解bootstrap3.0: 点这里了解bootstrap3.0 pc端UI框架初始文件项目下载; 直接下载:(因为做了项目之间的对接,可以做到一处迭代全体更换,所以取消了直接下载功能,下载请到github下载包吧!)
github clone/下载地址:https://github.com/zawet/QKYUI-dist.git 转到2.0演示地址 转到1.4演示地址 微校UI设计框架下载; 直接下载:微校UI框架下载

第二、文件结构

pc端UI框架初始化项目包2.0下载后,解压包后会得到如下文件系统:
QKYUI_dist2.0 (项目名,命名规则为QKYUI_+项目名拼音简写)
pc端UI框架初始化项目包1.4下载后,解压包后会得到如下文件系统:
QKYUI_dist1.4 (项目名,命名规则为QKYUI_+项目名拼音简写)
微校UI框架下载后,解压包后会得到如下文件系统:

第三、开始使用

1、设置头部导航条; 下载后打开模拟数据库qkydata.js,进行头部导航数据初始化的修改,修改成自己项目要呈现的内容,数据设置如下图,可点击放大 目前到2.0版本所有头部可设置的参数如下表: < 参数也可以在页面上进行覆盖更改,覆盖后再次执行下就ok了!
2、排布好整体布局;打开文件项目里的"index.html",在
里按照bootstrap3.0的栅格系统来编写所有模块的布局。 bs栅格系统传送门
3、逐个模块细节雕刻;在规划的布局里进行各模块的编写;
模块编写要求为色彩统一,基础ui统一,基础交互统一!比如几个模块间的所有按钮,风格同一,交互一致!
基础ui(按钮,表单元素,表格,列表,导航,弹窗,分页,进度条等)复制bootstrap3.0的组件来进行个性定义! bootstrap样式基础传送门

第四、CSS注意事项

1、基础的css由bs提供,需要覆盖bs的基础css在,qkybase.css里写并注明覆盖点。 2、自由css,或者特殊模块编写,另起一个css文件或者直接在qkybase.css下写并注明模块名,命名规范为:[模块功能点名英文_xxx],如,信息列表模块就infolist_xxx,每个模块的css前缀要保持一致。 3、类似的模块,写成一个模块css,不要在一个模块里用其他模块的css。

第五、示例查看

示例下载地址:https://github.com/zawet/qkyuibs
特别声明,示例代码只能拿那些特殊模块的html+css+js模块,公用的html+css+js模块,请依照上面提供的初始化文件项目为准,避免公用模块混乱!

第六、js引用和编写

1、原始普通引用,纯js或者jquery; 在没有引用seajs的情况下,头部导航的初始化,要先引用comjs里的nav_add_nosea.js和iconfont.js,并在加载完页面后运行$(id).qkynav(opt);如图: 在这情况下,引用js文件只要直接原始引用方式就可以了,但要注意js之间的冲突!使用原生javascript或者引用jquery来进行脚本编写,或者用其他的库或者js框架来写,只要你喜欢! 2、推荐使用seajs来进行js引用;
这里只是推荐使用seajs进行模块化js的引用和模块写法,不使用也是可以的!推荐使用是因为seajs能很好的整理整个项目,使项目看上去整洁有序!
了解js模块化 点这里了解什么是seajs 进阶seajs(后台开发引用其他js库或者模板必看) 1、要引用的js库或者插件,放置在dist文件夹里,命名按照插件的名字,里面要有版本区分。 2、引用js库或者插件,用seacofig的简化路径功能先简化路径,如下:
seajs.config({ // 别名配置 alias: { 'bs': 'bootstrap/3.3.0/js/bootstrap.min',//引用bootstrap前端框架 'nav': 'comjs/nav_add1.4',//引用整体头部 /****插件***/ 'cal_fp':'flatpickr/flatpickr',//日历插件fp 'ec':'echarts/3.0/echarts.common.min',//数据视图插件ec }, // 路径配置 paths: { /****数据路径***/ 'datas':'define',//默认数据存放路径 /****模块js路径***/ 'com':'./js/common_cadr',//公用模块js存放路径 'sc1': './js/special_cadr1_1',//版本1特殊模块js存放路径 'sc2': './js/special_cadr1_2',//版本2特殊模块js存放路径 }, // 变量配置 vars: { 'locale': 'zh-cn' } });
然后在html文档底下进行调用,调用方式为: seajs.use(["bs","nav"],function(){$("#qkynav").qkynav();}); 默认加载后执行导航条生成函数$("#qkynav").qkynav();qkynav函数可以进行josn数据opt进行数据更改。
3、js模块写法,按照seajs建议的AMD框架写,用define闭包封装起来,避免污染全局!具体看下图示例:
/**** 特殊模块功能点说明 ****/ define(function(require,exports) {//dedine闭包 exports.havevalue = function() { //exports是让函数暴露在全局里,全局可以调用此模板后进行调用此函数 //dosomething... }; exports.havevalue();//可以设置成自运行(加载模块时就执行模块执行体也就是构造函数) });