From cfa0f649b6629ad58270e228caa5f0e726492cf5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=99=88=E5=98=89=E6=B6=B5?= Date: Tue, 29 Aug 2017 17:52:50 +0800 Subject: [PATCH 1/4] ExpressWay: adjust doc --- docs/examples-docs/express-way.md | 12 +++--------- packages/express-way/index.vue | 4 ++-- test/unit/specs/picker.spec.js | 1 - 3 files changed, 5 insertions(+), 12 deletions(-) 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 + +### 使用指南 +``` 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/packages/index.js b/packages/index.js index c262f1834..86ed944e2 100644 --- a/packages/index.js +++ b/packages/index.js @@ -18,6 +18,7 @@ import ImagePreview from './image-preview'; import Lazyload from './lazyload'; import Loading from './loading'; import NoticeBar from './notice-bar'; +import OrderGoods from './order-goods'; import Panel from './panel'; import PayOrder from './pay-order'; import Picker from './picker'; @@ -60,6 +61,7 @@ const components = [ Icon, Loading, NoticeBar, + OrderGoods, Panel, PayOrder, Picker, @@ -118,6 +120,7 @@ export { Lazyload, Loading, NoticeBar, + OrderGoods, Panel, PayOrder, Picker, diff --git a/packages/order-goods/Card.vue b/packages/order-goods/Card.vue new file mode 100644 index 000000000..edfa63b90 --- /dev/null +++ b/packages/order-goods/Card.vue @@ -0,0 +1,102 @@ + + + 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 @@ +