mirror of
https://gitee.com/vant-contrib/vant-weapp.git
synced 2025-04-06 03:58:05 +08:00
114 lines
2.6 KiB
Markdown
114 lines
2.6 KiB
Markdown
# SubmitBar 提交订单栏
|
|
|
|
### 介绍
|
|
|
|
用于展示订单金额与提交订单。
|
|
|
|
### 引入
|
|
|
|
在`app.json`或`index.json`中引入组件，详细介绍见[快速上手](#/quickstart#yin-ru-zu-jian)。
|
|
|
|
```json
|
|
"usingComponents": {
|
|
"van-submit-bar": "@vant/weapp/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="您的收货地址不支持同城送, 我们已为您推荐快递"
|
|
tip-icon="info-o"
|
|
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
|
|
|
|
### Props
|
|
|
|
| 参数 | 说明 | 类型 | 默认值 |
|
|
| --- | --- | --- | --- |
|
|
| price | 价格（单位分） | _number_ | - |
|
|
| label | 价格文案 | _string_ | `合计：` |
|
|
| suffix-label | 价格右侧文案 | _string_ | - |
|
|
| button-text | 按钮文字 | _string_ | - |
|
|
| button-type | 按钮类型 | _string_ | `danger` |
|
|
| tip | 提示文案 | _string \| boolean_ | - |
|
|
| tip-icon | 图标名称或图片链接，可选值见 [Icon 组件](#/icon) | _string_ | - |
|
|
| disabled | 是否禁用按钮 | _boolean_ | `false` |
|
|
| loading | 是否显示加载中的按钮 | _boolean_ | `false` |
|
|
| currency | 货币符号 | _string_ | `¥` |
|
|
| safe-area-inset-bottom | 是否为 iPhoneX 留出底部安全距离 | _boolean_ | `true` |
|
|
| decimal-length | 价格小数点后位数 | _number_ | `2` |
|
|
|
|
### Events
|
|
|
|
| 事件名 | 说明 | 参数 |
|
|
| ------ | ---------------- | ---- |
|
|
| bind:submit | 按钮点击事件回调 | - |
|
|
|
|
### Slot
|
|
|
|
| 名称 | 说明 |
|
|
| ---- | -------------------------- |
|
|
| - | 自定义订单栏左侧内容 |
|
|
| top | 自定义订单栏上方内容 |
|
|
| tip | 提示文案中的额外操作和说明 |
|
|
|
|
### 外部样式类
|
|
|
|
| 类名 | 说明 |
|
|
| ------------ | ------------ |
|
|
| custom-class | 根节点样式类 |
|
|
| price-class | 价格样式类 |
|
|
| button-class | 按钮样式类 |
|
|
| bar-class | 订单栏样式类 |
|