diff --git a/docs/examples-docs/button.md b/docs/examples-docs/button.md index 992cc5ccc..91761fff0 100644 --- a/docs/examples-docs/button.md +++ b/docs/examples-docs/button.md @@ -7,6 +7,11 @@ &--bottom-action { margin-bottom: 15px; } + + &--small, + &--normal { + margin-right: 10px; + } } .zan-doc-demo-block { diff --git a/docs/examples-docs/express-way.md b/docs/examples-docs/express-way.md index 1aed0e45a..ee4d0ded4 100644 --- a/docs/examples-docs/express-way.md +++ b/docs/examples-docs/express-way.md @@ -67,19 +67,13 @@ export default { 'postage_desc': '由商家门店提供配送服务, 起送价 0.01 元', 'postage_title': '同城配送', 'express_type': 1 - }, { - 'postage': 0, - 'postage_desc': '由商家选择合作快递为您服务', - 'postage_title': '快递发货', - 'express_type': 2, - 'postage_warn_desc': '3天后发货' }] }; }, methods: { - onChange(item, index) { - Toast('配送方式更换为:' + item.postage_title); + onChange(item) { + Toast(`配送方式更换为:${item.postage_title}`); } } } @@ -93,7 +87,7 @@ export default { ```html + +const item1 = { + img_url: '//img.yzcdn.cn/upload_files/2017/07/02/af5b9f44deaeb68000d7e4a711160c53.jpg', + pay_price: 1050, + title: '商品 A', + num: '1' +}; + +const item2 = { + points_price: 200, + pay_price: 50, + img_url: '//img.yzcdn.cn/upload_files/2017/07/02/e89d56cd92ad8ce3b9d8e1babc3758b6.jpg', + title: '商品 B', + num: '15', + sku: [{ v: '商品SKU1' }, { v: '商品SKU2' }] +} + +const item3 = { + pay_price: 50, + img_url: '//img.yzcdn.cn/upload_files/2017/07/02/e89d56cd92ad8ce3b9d8e1babc3758b6.jpg', + title: '商品 C', + num: '15', + is_presale: true, + delivery_time: '三天后发货', + show_delivery_time: true, + is_presale: true, + is_present: true, + message: { + '留言1': '留言1内容', + '留言2': 'https://img.yzcdn.cn/upload_files/2017/07/02/e89d56cd92ad8ce3b9d8e1babc3758b6.jpg' + } +}; + +export default { + data() { + return { + itemList1: [item1], + itemList2: [item2], + itemList3: [item3], + itemListMulti: [item1, item2, item3], + emptyItemList: [], + message1: '', + message2: '', + message3: '', + message4: '' + } + } +} + + +### 使用指南 +``` javascript +import { OrderGoods } from 'vant'; + +Vue.component(OrderGoods.name, OrderGoods); +``` + +### 代码演示 + +#### 基础用法 + +:::demo 基础用法 +```html + + + +``` +::: + +#### 积分商品 + +:::demo 积分商品 +```html + + + +``` +::: + +#### 预售商品 + +:::demo 预售商品 +```html + + + +``` +::: + +#### 商品为空 + +:::demo 商品为空 +```html + +``` +::: + +#### 多个商品 + +:::demo 多个商品 +```html + +``` +::: + +### API + +| 参数 | 说明 | 类型 | 默认值 | +|-----------|-----------|-----------|-------------| +| shop-name | 店铺名称 | `String` | | +| shop-link | 店铺链接 | `String` | | +| header-icon | 店铺名称左侧的图标类型 | `String` | `shop` | +| header-badge | 店铺名称右侧的徽章链接 | `String` | | +| item-list | 商品列表 | `Array` | `[]` | +| empty-icon | 商品列表为空时的图标 | `String` | | +| empty-message | 商品列表为空时的提示文案 | `String` | `当前没有可购买的商品,请重新选择` | +| empty-button-text | 商品列表为空时的按钮文案 | `String` | `返回重新选择` | +| v-model | 买家留言 | `String` | `''` | +| show-total-price | 是否显示价格栏 | `Boolean` | `true` | +| show-message | 是否显示留言栏 | `Boolean` | `true` | +| message-editable | 留言是否可以编辑 | `Boolean` | `true` | +| price | 合计金额(单位分) | `Number` | | +| points | 合计积分 | `Number` | | + +### 数据格式 +#### itemList 中的配送方式字段说明 +| key | 说明 | 类型 | +|-----------|-----------|-----------| +| title | 商品名称 | `String` | +| img_url | 图片地址 | `String` | +| delivery_time | 发货时间 | `String` | +| num | 商品数量 | `Number` | +| points_price | 积分价格 | `Number` | +| pay_price(单位分) | 金额 | `Number` | +| sku | 商品 sku | `Array` | +| message | 商品留言 | `Array` | +| is_presale | 是否为预售 | `Boolean` | +| is_present | 是否为赠品 | `Boolean` | +| is_period_buy | 是否为周期购 | `Boolean` | +| show_delivery_time | 是否显示发货时间 | `Boolean` | + +### Slot +| name | 描述 | +|-----------|-----------| +| 默认 | 在商品列表和留言之间插入内容 | +| top | 在标题和商品列表之间插入内容 | +| bottom | 在合计价格下方插入内容 | diff --git a/docs/src/doc.config.js b/docs/src/doc.config.js index 64da013eb..792b893ce 100644 --- a/docs/src/doc.config.js +++ b/docs/src/doc.config.js @@ -189,6 +189,10 @@ module.exports = { "path": "/express-way", "title": "ExpressWay 配送方式" }, + { + "path": "/order-goods", + "title": "OrderGoods 下单页商品列表" + }, { "path": "/pay-order", "title": "PayOrder 提交订单栏" diff --git a/package.json b/package.json index 67c50bf01..0d3d08093 100644 --- a/package.json +++ b/package.json @@ -117,6 +117,6 @@ "webpack": "^3.5.5", "webpack-dev-server": "^2.7.1", "webpack-merge": "^4.1.0", - "zan-doc": "^0.2.6" + "zan-doc": "^0.2.9" } } diff --git a/packages/express-way/index.vue b/packages/express-way/index.vue index ac6743579..fcc72da4a 100644 --- a/packages/express-way/index.vue +++ b/packages/express-way/index.vue @@ -19,10 +19,10 @@ diff --git a/packages/order-goods/Empty.vue b/packages/order-goods/Empty.vue new file mode 100644 index 000000000..7e9779908 --- /dev/null +++ b/packages/order-goods/Empty.vue @@ -0,0 +1,31 @@ + + + diff --git a/packages/order-goods/Header.vue b/packages/order-goods/Header.vue new file mode 100644 index 000000000..956229556 --- /dev/null +++ b/packages/order-goods/Header.vue @@ -0,0 +1,26 @@ + + + diff --git a/packages/order-goods/Message.vue b/packages/order-goods/Message.vue new file mode 100644 index 000000000..36a9af8e2 --- /dev/null +++ b/packages/order-goods/Message.vue @@ -0,0 +1,50 @@ +