2018-09-19 17:20:16 +08:00

105 lines
2.2 KiB
Markdown

## SubmitBar 提交订单栏
### 使用指南
在 index.json 中引入组件
```json
"usingComponents": {
"van-submit-bar": "path/to/vant-weapp/dist/submit-bar/index"
}
```
### 代码演示
#### 基础用法
```html
<van-submit-bar
price="{{ 3050 }}"
button-text="提交订单"
bind:submit="onSubmit"
/>
```
#### 禁用状态
禁用状态下不会触发`submit`事件
```html
<van-submit-bar
disabled
price="{{ 3050 }}"
button-text="提交订单"
tip="您的收货地址不支持同城送, 我们已为您推荐快递"
bind:submit="onSubmit"
/>
```
#### 加载状态
加载状态下不会触发`submit`事件
```html
<van-submit-bar
loading
price="{{ 3050 }}"
button-text="提交订单"
bind:submit="onSubmit"
/>
```
#### 高级用法
通过插槽插入自定义内容
```html
<van-submit-bar
price="{{ 3050 }}"
button-text="提交订单"
bind:submit="onClickButton"
tip="{{ true }}"
>
<van-tag type="primary">标签</van-tag>
<view slot="tip">
您的收货地址不支持同城送, <text>修改地址</text>
</view>
</van-submit-bar>
```
### API
| 参数 | 说明 | 类型 | 默认值 |
|-----------|-----------|-----------|-------------|
| price | 价格(单位分) | `Number` | - |
| label | 价格文案 | `String` | `合计:` |
| button-text | 按钮文字 | `String` | - |
| button-type | 按钮类型 | `String` | `danger` |
| tip | 提示文案 | `String` / `Boolean` | - |
| disabled | 是否禁用按钮 | `Boolean` | `false` |
| loading | 是否显示加载中的按钮 | `Boolean` | `false` |
| currency | 货币符号 | `String` | `¥` |
### Event
| 事件名 | 说明 | 参数 |
|-----------|-----------|-----------|
| submit | 按钮点击事件回调 | - |
### Slot
| 名称 | 说明 |
|-----------|-----------|
| - | 自定义订单栏左侧内容 |
| top | 自定义订单栏上方内容 |
| tip | 提示文案中的额外操作和说明,`tip` 不为空时才显示 |
### 外部样式类
| 类名 | 说明 |
|-----------|-----------|
| custom-class | 根节点样式类 |
| price-class | 价格样式类 |
| button-class | 按钮样式类 |
### 更新日志
| 版本 | 类型 | 内容 |
|-----------|-----------|-----------|
| 0.3.3 | feature | 新增组件 |