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	按钮显示内容

样式变量

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

名称	默认值	描述
@goods-action-background-color	`@white`	-
@goods-action-height	`50px`	-
@goods-action-icon-width	`48px`	-
@goods-action-icon-height	`100%`	-
@goods-action-icon-color	`@text-color`	-
@goods-action-icon-size	`18px`	-
@goods-action-icon-font-size	`@font-size-xs`	-
@goods-action-icon-active-color	`@active-color`	-
@goods-action-icon-text-color	`@gray-7`	-
@goods-action-button-height	`40px`	-
@goods-action-button-warning-color	`@gradient-orange`	-
@goods-action-button-danger-color	`@gradient-red`	-

5.3 KiB Raw Blame History