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="#ee0a24" />
<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 变量,可用于自定义样式,使用方法请参考主题定制。
名称 | 默认值 | 描述 |
---|---|---|
@action-bar-background-color | @white | - |
@action-bar-height | 50px | - |
@action-bar-icon-width | 48px | - |
@action-bar-icon-height | 100% | - |
@action-bar-icon-color | @text-color | - |
@action-bar-icon-size | 18px | - |
@action-bar-icon-font-size | @font-size-xs | - |
@action-bar-icon-active-color | @active-color | - |
@action-bar-icon-text-color | @gray-7 | - |
@action-bar-button-height | 40px | - |
@action-bar-button-warning-color | @gradient-orange | - |
@action-bar-button-danger-color | @gradient-red | - |