docs: prettier all markdown files

This commit is contained in:
chenjiahan
2020-04-11 09:17:33 +08:00
committed by neverland
parent 48067f79db
commit 7f84f8a487
140 changed files with 4441 additions and 4723 deletions
+63 -66
View File
@@ -41,10 +41,10 @@ export default {
},
messageConfig: {
// 数据结构见下方文档
}
},
};
}
}
},
};
```
### 自定义步进器
@@ -85,19 +85,15 @@ export default {
<!-- 自定义 sku-header-price -->
<template #sku-header-price="props">
<div class="van-sku__goods-price">
<span class="van-sku__price-symbol"></span><span class="van-sku__price-num">{{ props.price }}</span>
<span class="van-sku__price-symbol"></span
><span class="van-sku__price-num">{{ props.price }}</span>
</div>
</template>
<!-- 自定义 sku actions -->
<template #sku-actions="props">
<div class="van-sku-actions">
<van-button
square
size="large"
type="warning"
@click="onPointClicked"
>
<van-button square size="large" type="warning" @click="onPointClicked">
积分兑换
</van-button>
<!-- 直接触发 sku 内部事件,通过内部事件执行 onBuyClicked 回调 -->
@@ -119,40 +115,40 @@ export default {
### Props
| 参数 | 说明 | 类型 | 默认值 |
|------|------|------|------|
| v-model | 是否显示sku | *boolean* | `false` |
| sku | 商品sku数据 | *object* | - |
| goods | 商品信息 | *object* | - |
| goods-id | 商品 id | *number \| string* | - |
| price-tag | 显示在价格后面的标签 | *string* | - |
| hide-stock | 是否显示商品剩余库存 | *boolean* | `false` |
| hide-quota-text | 是否显示限购提示 | *boolean* | `false` |
| hide-selected-text | 是否隐藏已选提示 | *boolean* | `false` |
| stock-threshold | 库存阈值。低于这个值会把库存数高亮显示 | *boolean* | `50` |
| show-add-cart-btn | 是否显示加入购物车按钮 | *boolean* | `true` |
| buy-text | 购买按钮文字 | *string* | `立即购买` |
| add-cart-text | 加入购物车按钮文字 | *string* | `加入购物车` |
| quota | 限购数,0 表示不限购 | *number* | `0` |
| quota-used | 已经购买过的数量 | *number* | `0` |
| reset-stepper-on-hide | 隐藏时重置选择的商品数量 | *boolean* | `false` |
| reset-selected-sku-on-hide | 隐藏时重置已选择的 sku | *boolean* | `false` |
| disable-stepper-input | 是否禁用步进器输入 | *boolean* | `false` |
| close-on-click-overlay | 是否在点击遮罩层后关闭 | *boolean* | `false` |
| stepper-title | 数量选择组件左侧文案 | *string* | `购买数量` |
| custom-stepper-config | 步进器相关自定义配置 | *object* | `{}` |
| message-config | 留言相关配置 | *object* | `{}` |
| get-container | 指定挂载的节点,[用法示例](#/zh-CN/popup#zhi-ding-gua-zai-wei-zhi) | *string \| () => Element* | - |
| initial-sku | 默认选中的 sku,具体参考高级用法 | *object* | `{}` |
| show-soldout-sku | 是否展示售罄的 sku,默认展示并置灰 | *boolean* | `true` |
| safe-area-inset-bottom `v2.2.1` | 是否开启[底部安全区适配](#/zh-CN/quickstart#di-bu-an-quan-qu-gua-pei) | *boolean* | `true` |
| start-sale-num `v2.3.0` | 起售数量 | *number* | `1` |
| properties `v2.4.2` | 商品属性 | *array* | - |
| preview-on-click-image `v2.5.2` | 是否在点击商品图片时自动预览 | *boolean* | `true` |
| --- | --- | --- | --- |
| v-model | 是否显示 sku | _boolean_ | `false` |
| sku | 商品 sku 数据 | _object_ | - |
| goods | 商品信息 | _object_ | - |
| goods-id | 商品 id | _number \| string_ | - |
| price-tag | 显示在价格后面的标签 | _string_ | - |
| hide-stock | 是否显示商品剩余库存 | _boolean_ | `false` |
| hide-quota-text | 是否显示限购提示 | _boolean_ | `false` |
| hide-selected-text | 是否隐藏已选提示 | _boolean_ | `false` |
| stock-threshold | 库存阈值。低于这个值会把库存数高亮显示 | _boolean_ | `50` |
| show-add-cart-btn | 是否显示加入购物车按钮 | _boolean_ | `true` |
| buy-text | 购买按钮文字 | _string_ | `立即购买` |
| add-cart-text | 加入购物车按钮文字 | _string_ | `加入购物车` |
| quota | 限购数,0 表示不限购 | _number_ | `0` |
| quota-used | 已经购买过的数量 | _number_ | `0` |
| reset-stepper-on-hide | 隐藏时重置选择的商品数量 | _boolean_ | `false` |
| reset-selected-sku-on-hide | 隐藏时重置已选择的 sku | _boolean_ | `false` |
| disable-stepper-input | 是否禁用步进器输入 | _boolean_ | `false` |
| close-on-click-overlay | 是否在点击遮罩层后关闭 | _boolean_ | `false` |
| stepper-title | 数量选择组件左侧文案 | _string_ | `购买数量` |
| custom-stepper-config | 步进器相关自定义配置 | _object_ | `{}` |
| message-config | 留言相关配置 | _object_ | `{}` |
| get-container | 指定挂载的节点,[用法示例](#/zh-CN/popup#zhi-ding-gua-zai-wei-zhi) | _string \| () => Element_ | - |
| initial-sku | 默认选中的 sku,具体参考高级用法 | _object_ | `{}` |
| show-soldout-sku | 是否展示售罄的 sku,默认展示并置灰 | _boolean_ | `true` |
| safe-area-inset-bottom `v2.2.1` | 是否开启[底部安全区适配](#/zh-CN/quickstart#di-bu-an-quan-qu-gua-pei) | _boolean_ | `true` |
| start-sale-num `v2.3.0` | 起售数量 | _number_ | `1` |
| properties `v2.4.2` | 商品属性 | _array_ | - |
| preview-on-click-image `v2.5.2` | 是否在点击商品图片时自动预览 | _boolean_ | `true` |
### Events
| 事件名 | 说明 | 回调参数 |
|------|------|------|
| --- | --- | --- |
| add-cart | 点击添加购物车回调 | skuData: object |
| buy-clicked | 点击购买回调 | skuData: object |
| stepper-change | 购买数量变化时触发 | value: number |
@@ -165,23 +161,23 @@ export default {
通过 ref 可以获取到 Sku 实例并调用实例方法,详见[组件实例方法](#/zh-CN/quickstart#zu-jian-shi-li-fang-fa)
| 方法名 | 说明 | 参数 | 返回值 |
|------|------|------|------|
| getSkuData | 获取当前 skuData | - | skuData |
| resetSelectedSku `v2.3.0` | 重置选中规格到初始状态 | - | - |
| 方法名 | 说明 | 参数 | 返回值 |
| ------------------------- | ---------------------- | ---- | ------- |
| getSkuData | 获取当前 skuData | - | skuData |
| resetSelectedSku `v2.3.0` | 重置选中规格到初始状态 | - | - |
### Slots
Sku 组件默认划分好了若干区块,这些区块都定义成了插槽,可以按需进行替换。区块顺序见下表:
| 名称 | 说明 |
|------|------|
| --- | --- |
| sku-header | 商品信息展示区,包含商品图片、名称、价格等信息 |
| sku-header-price | 自定义 sku 头部价格展示 |
| sku-header-origin-price | 自定义 sku 头部原价展示 |
| sku-header-extra | 额外 sku 头部区域 |
| sku-header-image-extra `v2.5.2` | 自定义 sku 头部图片额外的展示 |
| sku-body-top | sku 展示区上方的内容,无默认展示内容,按需使用 |
| sku-body-top | sku 展示区上方的内容,无默认展示内容,按需使用 |
| sku-group | 商品 sku 展示区 |
| extra-sku-group | 额外商品 sku 展示区,一般用不到 |
| sku-stepper | 商品数量选择区 |
@@ -248,25 +244,26 @@ sku: {
### properties 对象结构
```js
[ // 商品属性
{
k_id: 123, // 属性id
k: '加料', // 属性
is_multiple: true, // 是否可多选
v: [
{
id: 1222, // 属性值id
name: '珍珠', // 属性值
price: 1, // 属性值加价
},
{
id: 1223,
name: '椰果',
price: 1,
}
],
}
]
[
// 商品属性
{
k_id: 123, // 属性id
k: '加料', // 属性名
is_multiple: true, // 是否可多选
v: [
{
id: 1222, // 属性值id
name: '珍珠', // 属性值
price: 1, // 属性值加价
},
{
id: 1223,
name: '椰果',
price: 1,
},
],
},
];
```
### initialSku 对象结构
@@ -293,7 +290,7 @@ sku: {
```js
goods: {
// 默认商品 sku 缩略图
picture: 'https://img.yzcdn.cn/1.jpg'
picture: 'https://img.yzcdn.cn/1.jpg';
}
```