diff --git a/README.md b/README.md
index f92c6582..27122c65 100644
--- a/README.md
+++ b/README.md
@@ -2,33 +2,147 @@
+
高颜值、好用、易扩展的小程序 UI 库,Powered by 有赞
====
## 概述
-[ZanUI-WeApp](https://github.com/youzan/zanui-weapp) 是有赞移动 Web UI 规范 `ZanUI` 的小程序现实版本,
-结合了微信的视觉规范,为用户提供更加统一的使用感知。
-包含 badge、btn、card、cell、color、dialog、form、helper、icon、label、loadmore、panel、quantity、
-steps、tab、toast、toptip 共计 17 类组件或元素。
+[ZanUI-WeApp]是有赞移动 Web UI 规范 `ZanUI` 的小程序现实版本,结合了微信的视觉规范,为用户提供更加统一的使用感知。
+
+包含 badge、btn、card、cell、color、dialog、form、helper、icon、label、loadmore、panel、quantity、steps、tab、toast、toptip 共计 17 类组件或元素。
更多背景介绍,可以移步到 [我们专门写的的介绍文章](http://tech.youzan.com/zanui-weapp/)。
-## Demo
-1. 下载源码
+## 下载
``` bash
git clone https://github.com/youzan/zanui-weapp.git
```
-2. 打开 `微信Web开发者工具`,'本地小程序项目 - 添加项目',把 zanui-weapp 添加进去就可以查看组件源码、预览示例demo了。
+## 预览
+打开[微信web开发者工具](https://mp.weixin.qq.com/debug/wxadoc/dev/devtools/download.html),'本地小程序项目 - 添加项目',把 zanui-weapp 添加进去就可以查看组件源码、预览示例demo了。
+
+
## 使用
-1. 使用 [ZanUI-WeApp](https://github.com/youzan/zanui-weapp) 前
-请确保已经学习过微信官方的 [小程序简易教程](https://mp.weixin.qq.com/debug/wxadoc/dev/)
-和 [小程序框架介绍](https://mp.weixin.qq.com/debug/wxadoc/dev/framework/MINA.html)
-1. 然后用 [Bower](https://bower.io/) 将 [ZanUI-WeApp](https://github.com/youzan/zanui-weapp) 添加到你的项目中使用。
+1. 使用 [ZanUI-WeApp] 前请确保已经学习过微信官方的 [小程序简易教程] 和 [小程序框架介绍]。
+2. 然后用 [Bower] 将 [ZanUI-WeApp] 添加到你的项目中使用。
+3. 你也可以 fork 出一份你自己的 [ZanUI-WeApp],这样更利于代码稳定和个性定制。
-1. 你也可以 fork 出一份你自己的 [ZanUI-WeApp](https://github.com/youzan/zanui-weapp),这样更利于代码稳定和个性定制。
+我们推荐在你的`app.wxss`直接引入`zanui-weapp/dist/index.wxss`。
+
+根据功能的不同,可以将组件大致的分为4类:
+
+### 一、简单组件
+
+如按钮组件,只要按照wxml结构写就好了
+
+~~~html
+
+
+按钮
+~~~
+
+
+
+### 二、复杂组件
+
+如加载更多组件,需要先引入定义好的模版,然后给模版传递数据
+
+~~~html
+
+
+
+
+
+
+
+
+
+
+
+
+
+~~~
+
+
+
+### 三、带事件回掉的组件
+
+如数量选择组件,需要先引入模版,然后给模版传递数据
+
+~~~html
+
+
+
+
+
+~~~
+
+然后通过`Zan.Quantity`把相关回掉注入到页面中
+
+~~~js
+// example/quantity/index.js
+
+var Zan = require('path/to/zanui-weapp/dist/index');
+
+Page(Object.assign({}, Zan.Quantity, {
+ data: {
+ quantity: {
+ quantity: 10,
+ min: 1,
+ max: 20
+ },
+ },
+
+ handleZanQuantityChange(e) {
+ // 如果页面有多个Quantity组件,则通过componentId来表示唯一
+ var compoenntId = e.componentId;
+ var quantity = e.quantity;
+
+ this.setData({
+ 'quantity.quantity': quantity
+ });
+ }
+}));
+~~~
+
+
+
+### 四、API类组件
+
+如Toast组件,需要先引入模版,并在页面上使用。
+
+> 注意`zanToast`这个数据也是通过`Zan.Toast`注入到页面的
+
+~~~html
+
+
+
+
+显示toast
+
+
+~~~
+
+将API注入到页面后,就可以通过`this`来直接调用相应的API了
+
+~~~js
+
+
+var Zan = require('path/to/zanui-weapp/dist/index');
+
+Page(Object.assign({}, Zan.Toast, {
+ showToast() {
+ this.showZanToast('toast的内容');
+ }
+}));
+
+~~~
+
+
+
+更多示例可以在项目的`example`目录中查看
## 协议
本项目采用 [MIT](https://zh.wikipedia.org/wiki/MIT%E8%A8%B1%E5%8F%AF%E8%AD%89),请自由地享受和参与开源。
@@ -39,5 +153,8 @@ git clone https://github.com/youzan/zanui-weapp.git
[issue]: https://github.com/youzan/zanui-weapp/issues/new
[PR]: https://github.com/youzan/zanui-weapp/compare
-[ZanUI Weapp]: https://github.com/youzan/zanui-weapp
+[ZanUI WeApp]: https://github.com/youzan/zanui-weapp
[MIT]: http://opensource.org/licenses/MIT
+[Bower]: https://bower.io/
+[小程序简易教程]: https://mp.weixin.qq.com/debug/wxadoc/dev
+[小程序框架介绍]: https://mp.weixin.qq.com/debug/wxadoc/dev/framework/MINA.html