Kub NPM | npm.io

轻量级移动端组件库 Kub

设计

Kub 由多个组件构成，组件之间依赖较低；
组件尽量做到轻量且扩展性良好；
组件对外提供稳定的API，在使用时可通过参数配置或者继承实现定制化的组件；
组件采用commonjs规范，采用webpack编译，对外提供源文件与编译后的文件；
提供模板源文件与预编译后的文件；
Kub对外提供暴露全局的Kub变量，所有组件绑定在该变量中；
样式采用less编写，对外提供源文件与编译后的文件；
样式可统一在variables.less文件中配置；
对外提供不包含样式的kub.js以及包含样式的kub.style.js;

兼容性

ios7及以上版本；
Android4.0及以上版本；

版本

遵循语义化版本规范；
master分支为最新的稳定的发布版本；
tags中的分支对应每一个发布版本；
其余分支为开发分支，为不稳定版本；
1.* 版本将不再升级与维护，除非有重大bug；

安装

CDN

<link rel="stylesheet" type="text/css" href="//assets.geilicdn.com/v-components/kubjs/2.5.2/index.css">

<script type="text/javascript" src="//assets.geilicdn.com/v-components/kubjs/2.5.2/index.js"></script>

<script type="text/javascript" src="//assets.geilicdn.com/v-components/kubjs/2.5.2/index.style.js"></script>

git

git clone https://github.com/longjiarun/kubjs.git kub

npm

npm install kub --save

//指定版本
npm install kub@version --save

bower

bower install kub --save

//指定版本
bower install kub#version --save

使用

使用编译后的文件`kub.js`及`kub.style.js`。

1、如果组件名称首字母大小，则暴露的是类，需实例化；

//组件为类
var dialog = new Kub.Dialog({
    //配置参数
});

2、如果组件名称首字母小写，则暴露的是对象或函数，无需实例化；

//组件为实例化后的对象
Kub.dateHelper.format(new Date(),'yyyy-MM-dd')

//组件为函数
Kub.cookie('name','kub');

//组件为对象
Kub.os.ios

使用源文件。

1、bower

//引用kub.js
var Kub = require('../../bower_components/kub/src/js/kub')

new Kub.Dialog()

//引用单个组件
var Dialog = require('../../bower_components/kub/src/js/dialog')

new Dialog()

//使用less
require('../../bower_components/kub/src/less/dialog.less')

2、npm

//引用kub.js
var Kub = require('kub')

new Kub.Dialog()

//引用单个组件
var Dialog = require('kub/src/js/dialog')

new Dialog()

//使用less
require('kub/src/less/dialog.less')