zanui是一套视觉UI包，与weui类似但又不等于weui，约等于weui+weui.js。没有weui成熟、全面。但在微商城这一细分领域，比weui更全面。两者使用了不同的css前缀，可以并用于项目中。
ZanUI-WeApp是有赞推出的，结合了微信的视觉规范，为用户提供更加统一的使用感受。
包含 badge、btn、card、cell、color、dialog、form、helper、icon、label、loadmore、panel、quantity、steps、tab、toast、toptip 共计 17 类组件或元素。
使用
下载：git clone https://github.com/youzan/zanui-weapp.git
打开微信web开发者工具，'本地小程序项目 - 添加项目'，把 zanui-weapp 添加进去就可以预览demo了。
使用
组件大致的分为4类：
1. 简单组件
如按钮组件，只要按照wxml结构写就好了按钮
这是最简单的一类，直接使用的是zan-开头的css样式，与weui-样式类似。
2. 复杂组件
如加载更多组件，需要先引入定义好的模版，然后给模版传递数据
这一类组件是次简单，使用了模板。
这一句是使用模板组件的语句，is=""指明模板名称，该名称定义于../loadmore/index.wxml文件中：
{{ nodata_str || '暂无数据' }}
加载中...
这是最简单的模板组件，有三个逻辑判断分支，分别是nomore、nodata、loading。每个if分支对应一种UI。
第二种nodata中，{{ nodata_str || '暂无数据' }}，这一句用于定义显示的默认文本。
自定义的情况示例：
运行效果：
3. 带事件回调的组件
如数量选择组件，需要先引入模版，然后给模版传递数据
然后通过Zan.Quantity把相关回调注入到页面中varZan=require('path/to/zanui-weapp/dist/index');Page(Object.assign({},Zan.Quantity, {
data:{
quantity:{
quantity:10,
min:1,
max:20},
},handleZanQuantityChange(e) {// 如果页面有多个Quantity组件，则通过唯一componentId进行索引varcompoenntId=e.componentId;varquantity=e.quantity;this.setData({'quantity.quantity':quantity
});
}
}));
上面代码中这个Object.assign语法，是es6的：
Object.assign方法用来将源对象（source）的所有可枚举属性，复制到目标对象（target）。它至少需要两个对象作为参数，第一个参数是目标对象，后面的参数都是源对象。
它是将Zan.Quantity这个对象，还有它后面的定义的“Page”对象，拷贝到前面的{}空对象中，从而组成一个新的Page对象。
这样做的结果是，Zan.Quantity中定义的组件方法，例如_handleZanQuantityBlur、_handleZanQuantityMinus、_handleZanQuantityPlus都跑到了当前页面中，就像在当前页面中定义一样，只是少了编写的麻烦。
与此同时，在Zan.Quantity中，使用的this对象，当指当前重组后的页面对象。
在Zan.Quantity有一段这样的代码：
function callback(componentId, quantity) {
quantity = +quantity;
var e = { componentId, quantity };
console.info('[zan:quantity:change]', e);
if (this.handleZanQuantityChange) {
this.handleZanQuantityChange(e);
} else {
console.warn('页面缺少 handleZanQuantityChange 回调函数');
}
}
handleZanQuantityChange是客户代码定义的。在示例中是这样的：
handleZanQuantityChange(e) {
var componentId = e.componentId;
var quantity = e.quantity;
this.setData({
[`${componentId}.quantity`]: quantity
});
}
关于Object.assign的说明，在小程序API文档、组件文档中都没有，在工具文档页中，描述ES6 API 支持情况时，有列举该es6语法api。
4. API类组件
如Toast组件，需要先引入模版，并在页面上使用。
注意zanToast这个数据也是通过Zan.Toast注入到页面的
显示toast
将API注入到页面后，就可以通过this来直接调用相应的API了
varZan=require('path/to/zanui-weapp/dist/index');Page(Object.assign({},Zan.Toast, {showToast() {this.showZanToast('toast的内容');
}
}));
toast与quantity组件的实现类似，只是需要显式调用，与程序原生的api 组件类似。
有赞商城团队的这种定义模板组件的方法，很值得学习推广。每一个模板组件，单独一个目录。在dist/index主js文件中，export各组件。
在使用时，统一引用/dist/index，并实例化统一的Zan变量，使用Object.assign混合Page页面对象，保持了代码的简洁优雅。
大家已经造了不少轮子了，我们要不要也开发一个小程序微商城？
如果产品特色，索性就不做。但如果只是做为一个示例，供开发者方便学习，可以考虑。
在微信公众号哲学李论，回复“小程序入门集锦”可以看到这个系列的所有文章。
本文同时在多个平台、社群转发，回复“社群”可与其它艺友热情连接。
如果觉得本文还行，请转发到朋友圈让更多朋友看到。
如果您看到有料的文章，欢迎与10W艺友分享，荐文热线：liyi@rixingyike.com。
网友评论