Merge pull request #108 from chenjiahan/dev

add OrderCoupon component

docs/examples-docs/order-coupon.md

@@ -0,0 +1,173 @@
+## OrderCoupon 下单页优惠券
+
+<script>
+import { Toast } from 'packages';
+
+const coupon = {
+  available: 1,
+  discount: 0,
+  denominations: 150,
+  origin_condition: 0,
+  reason: '',
+  value: 150,
+  condition: '下单立减 1.50 元',
+  name: '新手专用优惠券',
+  start_at: 1489104000,
+  end_at: 1514592000
+};
+
+const discountCoupon = {
+  ...coupon,
+  discount: 88,
+  denominations: 0,
+  origin_condition: 50,
+  value: 12,
+  condition: '下单即享 8.8 折',
+};
+
+const disabledCoupon = {
+  ...coupon,
+  avaliable: 0,
+  reason: '未满足使用门槛'
+};
+
+const disabledDiscountCoupon = {
+  ...discountCoupon,
+  avaliable: 0,
+  reason: '未满足使用门槛'
+};
+
+export default {
+  data() {
+    return {
+      showList: false,
+      chosenCoupon: -1,
+      coupons: [coupon, discountCoupon],
+      disabledCoupons: [disabledCoupon, disabledDiscountCoupon]
+    }
+  },
+
+  methods: {
+    onChange(index) {
+      this.chosenCoupon = index;
+    },
+    onExchange(code) {
+      Toast('兑换成功');
+      this.coupons.push(coupon);
+    }
+  }
+}
+</script>
+
+### 使用指南
+``` javascript
+import { OrderCoupon, OrderCouponList } from 'vant';
+
+Vue.component(OrderCoupon.name, OrderCoupon);
+Vue.component(OrderCouponList.name, OrderCouponList);
+```
+
+### 代码演示
+
+#### 基础用法
+
+:::demo 基础用法
+```html
+<!-- 优惠券单元格 -->
+<van-order-coupon
+  :coupons="coupons"
+  :chosen-coupon="chosenCoupon"
+  @click="showList = true"
+></van-order-coupon>
+
+<!-- 优惠券列表 -->
+<van-order-coupon-list
+  v-model="showList"
+  :coupons="coupons"
+  :chosen-coupon="chosenCoupon"
+  :disabled-coupons="disabledCoupons"
+  @change="onChange"
+  @exchange="onExchange"
+></van-order-coupon-list>
+```
+
+```javascript
+const mockCoupon = {
+  available: 1,
+  discount: 0,
+  denominations: 150,
+  origin_condition: 0,
+  reason: '',
+  value: 150,
+  condition: '下单立减 1.50 元',
+  name: '新手专用优惠券',
+  start_at: 1489104000,
+  end_at: 1514592000
+};
+
+export default {
+  data() {
+    return {
+      chosenCoupon: -1,
+      coupons: [mockCoupon],
+      disabledCoupons: [mockCoupon]
+    }
+  },
+
+  methods: {
+    onChange(index) {
+      this.chosenCoupon = index;
+    },
+    onExchange(code) {
+      this.coupons.push(mockCoupon);
+    }
+  }
+}
+```
+:::
+
+### OrderCoupon API
+
+| 参数       | 说明      | 类型       | 默认值       | 必须      |
+|-----------|-----------|-----------|-------------|-------------|
+| chosenCoupon | 当前选中优惠券的索引 | `Number` | `-1` | - |
+| coupons | 可用优惠券列表 | `Array` | `[]` | - |
+| editable | 能否切换优惠券 | `Boolean` | `true` | - |
+
+### OrderCouponList API
+
+| 参数       | 说明      | 类型       | 默认值       | 必须      |
+|-----------|-----------|-----------|-------------|-------------|
+| v-model | 是否展示优惠券列表 | `Boolean` | `false` | - |
+| chosenCoupon | 当前选中优惠券的索引 | `Number` | `-1` | - |
+| coupons | 可用优惠券列表 | `Array` | `[]` | - |
+| disabledCoupons | 不可用优惠券列表 | `Array` | `[]` | - |
+| exchangeButtonText | 兑换按钮文字 | `String` | `兑换` | - |
+| exchangeButtonDisabled | 是否禁用兑换按钮 | `Boolean` | `false` | - |
+| displayedCouponIndex | 滚动至特定优惠券位置 | `Number` | - | - |
+| closeButtonText | 列表底部按钮文字 | `String` | 不使用优惠 | - |
+| disabledListTitle | 不可用券列表标题 | `String` | 不可用优惠 | - |
+| inputPlaceholder | 输入框文字提示 | `String` | 请输入优惠码 | - |
+
+### OrderCouponList Event
+
+| 事件名       | 说明      | 参数       |
+|-----------|-----------|-----------|
+| change | 优惠券切换回调 | index, 选中优惠券的索引 |
+| exchange | 兑换优惠券回调 | code, 兑换码 |
+
+### 数据格式
+#### 优惠券字段说明
+| key       | 说明      | 类型       |
+|-----------|-----------|-----------|
+| id | 优惠券 id | `String` |
+| name | 优惠券名称 | `String` |
+| available | 是否可用, 1:可用,0:不可用 | `Number` |
+| discount | 折扣（0为满减券）88=>8.8折 | `Number` |
+| denominations | 面值（0为折扣券）单位分 | `Number` |
+| origin_condition | 满减条件（0为无门槛，满XX元可用）单位分 | `Number` |
+| start_at | 	卡有效开始时间 | `Number` |
+| end_at | 卡失效日期 | `Number` |
+| reason | 不可用原因 | `String` |
+| value | 订单优惠金额，单位分 | `Number` |
+| condition | 格式化输出 value | `String` |