vant/src/action-bar/README.zh-CN.md

ActionBar 动作栏

引入

import { createApp } from 'vue';
import { ActionBar, ActionBarIcon, ActionBarButton } from 'vant';

const app = createApp();
app.use(ActionBar);
app.use(ActionBarIcon);
app.use(ActionBarButton);

代码演示

基础用法

<van-action-bar>
  <van-action-bar-icon icon="chat-o" text="客服" @click="onClickIcon" />
  <van-action-bar-icon icon="cart-o" text="购物车" @click="onClickIcon" />
  <van-action-bar-icon icon="shop-o" text="店铺" @click="onClickIcon" />
  <van-action-bar-button type="danger" text="立即购买" @click="onClickButton" />
</van-action-bar>

import { Toast } from 'vant';

export default {
  methods: {
    onClickIcon() {
      Toast('点击图标');
    },
    onClickButton() {
      Toast('点击按钮');
    },
  },
};

徽标提示

在 ActionBarIcon 组件上设置dot属性后，会在图标右上角展示一个小红点。设置badge属性后，会在图标右上角展示相应的徽标

<van-action-bar>
  <van-action-bar-icon icon="chat-o" text="客服" dot />
  <van-action-bar-icon icon="cart-o" text="购物车" badge="5" />
  <van-action-bar-icon icon="shop-o" text="店铺" badge="12" />
  <van-action-bar-button type="warning" text="加入购物车" />
  <van-action-bar-button type="danger" text="立即购买" />
</van-action-bar>

自定义图标颜色

通过 ActionBarIcon 的color属性可以自定义图标的颜色

<van-action-bar>
  <van-action-bar-icon icon="chat-o" text="客服" color="#07c160" />
  <van-action-bar-icon icon="cart-o" text="购物车" />
  <van-action-bar-icon icon="star" text="已收藏" color="#ff5000" />
  <van-action-bar-button type="warning" text="加入购物车" />
  <van-action-bar-button type="danger" text="立即购买" />
</van-action-bar>

自定义按钮颜色

通过 ActionBarButton 的color属性可以自定义按钮的颜色，支持传入linear-gradient渐变色

<van-action-bar>
  <van-action-bar-icon icon="chat-o" text="客服" />
  <van-action-bar-icon icon="shop-o" text="店铺" />
  <van-action-bar-button color="#be99ff" type="warning" text="加入购物车" />
  <van-action-bar-button color="#7232dd" type="danger" text="立即购买" />
</van-action-bar>

API

ActionBar Props

参数	说明	类型	默认值
safe-area-inset-bottom	是否开启底部安全区适配	boolean	true

ActionBarIcon Props

参数	说明	类型	默认值
text	按钮文字	string	-
icon	图标	string	-
color v2.4.2	图标颜色	string	#323233
icon-class	图标额外类名	any	-
dot 2.5.5	是否显示图标右上角小红点	boolean	false
badge v2.5.6	图标右上角徽标的内容	number | string	-
url	点击后跳转的链接地址	string	-
to	点击后跳转的目标路由对象，同 vue-router 的 to 属性	string | object	-
replace	是否在跳转时替换当前页面历史	boolean	false

ActionBarButton Props

参数	说明	类型	默认值
text	按钮文字	string	-
type	按钮类型，可选值为 primary info warning danger	string	default
color	按钮颜色，支持传入linear-gradient渐变色	string	-
icon v2.4.4	左侧图标名称或图片链接	string	-
disabled	是否禁用按钮	boolean	false
loading	是否显示为加载状态	boolean	false
url	点击后跳转的链接地址	string	-
to	点击后跳转的目标路由对象，同 vue-router 的 to 属性	string | object	-
replace	是否在跳转时替换当前页面历史	boolean	false

ActionBarIcon Slots

名称	说明
default	文本内容
icon	自定义图标

ActionBarButton Slots

名称	说明
default	按钮显示内容