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 = () => Toast('点击按钮');
  5. return {
  6. onSubmit,
  7. };
  8. },
  9. };

禁用状态

禁用状态下不会触发 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 = () => Toast('点击按钮');
  5. const onClickLink = () => Toast('修改地址');
  6. return {
  7. onSubmit,
  8. onClickLink,
  9. };
  10. },
  11. };

API

Props

参数说明类型默认值
price金额(单位分)number-
decimal-length金额小数点位数number | string2
label金额左侧文案string合计:
suffix-label金额右侧文案string-
text-align金额文案对齐方向,可选值为 leftstringright
button-text按钮文字string-
button-type按钮类型stringdanger
button-color自定义按钮颜色string-
tip在订单栏上方的提示文案string-
tip-icon提示文案左侧的图标名称或图片链接,等同于 Icon 组件的 name 属性string-
currency货币符号string¥
disabled是否禁用按钮booleanfalse
loading是否显示将按钮显示为加载中状态booleanfalse
safe-area-inset-bottom是否开启底部安全区适配booleantrue
placeholder v3.5.1是否在标签位置生成一个等高的占位元素booleanfalse

Events

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

Slots

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

类型定义

组件导出以下类型定义:

  1. import type { SubmitBarProps, SubmitBarTextAlign } from 'vant';

主题定制

样式变量

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

名称默认值描述
—van-submit-bar-height50px-
—van-submit-bar-z-index100-
—van-submit-bar-background-colorvar(—van-background-color-light)-
—van-submit-bar-button-width110px-
—van-submit-bar-price-colorvar(—van-danger-color)-
—van-submit-bar-price-font-sizevar(—van-font-size-sm)-
—van-submit-bar-price-integer-font-size20px-
—van-submit-bar-price-font-familyvar(—van-price-integer-font-family)-
—van-submit-bar-text-colorvar(—van-text-color)-
—van-submit-bar-text-font-sizevar(—van-font-size-md)-
—van-submit-bar-tip-paddingvar(—van-padding-xs) var(—van-padding-sm)-
—van-submit-bar-tip-font-sizevar(—van-font-size-sm)-
—van-submit-bar-tip-line-height1.5-
—van-submit-bar-tip-colorvar(—van-orange-dark)-
—van-submit-bar-tip-background-colorvar(—van-orange-light)-
—van-submit-bar-tip-icon-size12px-
—van-submit-bar-button-height40px-
—van-submit-bar-padding0 var(—van-padding-md)-

SubmitBar 提交订单栏 - 图1