SubmitBar 提交订单栏

引入

  1. import { createApp } from 'vue';
  2. import { SubmitBar } from 'vant';
  3. const app = createApp();
  4. app.use(SubmitBar);

代码演示

基础用法

  1. <van-submit-bar :price="3050" button-text="提交订单" @submit="onSubmit" />
  1. import { Toast } from 'vant';
  2. export default {
  3. setup() {
  4. const onSubmit = () => {
  5. Toast('点击按钮');
  6. };
  7. return {
  8. onSubmit,
  9. };
  10. },
  11. };

禁用状态

禁用状态下不会触发 submit 事件。

  1. <van-submit-bar
  2. disabled
  3. :price="3050"
  4. button-text="提交订单"
  5. tip="你的收货地址不支持同城送, 我们已为你推荐快递"
  6. tip-icon="info-o"
  7. @submit="onSubmit"
  8. />

加载状态

加载状态下不会触发 submit 事件。

  1. <van-submit-bar
  2. loading
  3. :price="3050"
  4. button-text="提交订单"
  5. @submit="onSubmit"
  6. />

高级用法

通过插槽插入自定义内容。

  1. <van-submit-bar :price="3050" button-text="提交订单" @submit="onSubmit">
  2. <van-checkbox v-model="checked">全选</van-checkbox>
  3. <template #tip>
  4. 你的收货地址不支持同城送, <span @click="onClickLink">修改地址</span>
  5. </template>
  6. </van-submit-bar>
  1. import { Toast } from 'vant';
  2. export default {
  3. setup() {
  4. const onSubmit = () => {
  5. Toast('点击按钮');
  6. };
  7. const onClickLink = () => {
  8. Toast('修改地址');
  9. };
  10. return {
  11. onSubmit,
  12. onClickLink,
  13. };
  14. },
  15. };

API

Props

参数说明类型默认值
price价格(单位分)number-
decimal-length价格小数点位数number | string2
label价格左侧文案string合计:
suffix-label价格右侧文案string-
text-align v2.3.0价格文案对齐方向,可选值为 leftstringright
button-text按钮文字string-
button-type按钮类型stringdanger
button-color v2.9.1自定义按钮颜色string-
tip在订单栏上方的提示文案string-
tip-icon提示文案左侧的图标名称或图片链接string-
currency货币符号string¥
disabled是否禁用按钮booleanfalse
loading是否显示将按钮显示为加载中状态booleanfalse
safe-area-inset-bottom是否开启底部安全区适配booleantrue

Events

事件名说明回调参数
submit按钮点击事件回调-

Slots

名称说明
default自定义订单栏左侧内容
button v2.10.12自定义按钮
top自定义订单栏上方内容
tip提示文案中的额外内容

样式变量

组件提供了下列 Less 变量,可用于自定义样式,使用方法请参考主题定制

名称默认值描述
@submit-bar-height50px-
@submit-bar-z-index100-
@submit-bar-background-color@white-
@submit-bar-button-width110px-
@submit-bar-price-color@red-
@submit-bar-price-font-size@font-size-md-
@submit-bar-currency-font-size@font-size-md-
@submit-bar-text-color@text-color-
@submit-bar-text-font-size@font-size-md-
@submit-bar-tip-padding@padding-xs @padding-sm-
@submit-bar-tip-font-size@font-size-sm-
@submit-bar-tip-line-height1.5-
@submit-bar-tip-color#f56723-
@submit-bar-tip-background-color#fff7cc-
@submit-bar-tip-icon-size12px-
@submit-bar-button-height40px-
@submit-bar-padding0 @padding-md-
@submit-bar-price-integer-font-size20px-
@submit-bar-price-font-family@price-integer-font-family-

SubmitBar 提交订单栏 - 图1