Vant3 ActionBar 動作欄

2021-09-14 11:10 更新

介紹

用于為頁面相關(guān)操作提供便捷交互。

實例演示

引入

通過以下方式來全局注冊組件,更多注冊方式請參考組件注冊。

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

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

代碼演示

基礎(chǔ)用法

<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 {
  setup() {
    const onClickIcon = () => Toast('點擊圖標');
    const onClickButton = () => Toast('點擊按鈕');
    return {
      onClickIcon,
      onClickButton,
    };
  },
};

徽標提示

在 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

參數(shù) 說明 類型 默認值
safe-area-inset-bottom 是否開啟底部安全區(qū)適配 boolean true

ActionBarIcon Props

參數(shù) 說明 類型 默認值
text 按鈕文字 string -
icon 圖標 string -
color 圖標顏色 string #323233
icon-class 圖標額外類名 string | Array | object -
icon-prefix v3.0.17 圖標類名前綴,等同于 Icon 組件的 class-prefix 屬性 string van-icon
dot 是否顯示圖標右上角小紅點 boolean false
badge 圖標右上角徽標的內(nèi)容 number | string -
url 點擊后跳轉(zhuǎn)的鏈接地址 string -
to 點擊后跳轉(zhuǎn)的目標路由對象,等同于 vue-router 的 to 屬性 string | object -
replace 是否在跳轉(zhuǎn)時替換當前頁面歷史 boolean false

ActionBarButton Props

參數(shù) 說明 類型 默認值
text 按鈕文字 string -
type 按鈕類型,可選值為 primary info warning danger string default
color 按鈕顏色,支持傳入 linear-gradient 漸變色 string -
icon 左側(cè)圖標名稱或圖片鏈接 string -
disabled 是否禁用按鈕 boolean false
loading 是否顯示為加載狀態(tài) boolean false
url 點擊后跳轉(zhuǎn)的鏈接地址 string -
to 點擊后跳轉(zhuǎn)的目標路由對象,等同于 vue-router 的 to 屬性 string | object -
replace 是否在跳轉(zhuǎn)時替換當前頁面歷史 boolean false

ActionBarIcon Slots

名稱 說明
default 文本內(nèi)容
icon 自定義圖標

ActionBarButton Slots

名稱 說明
default 按鈕顯示內(nèi)容

樣式變量

組件提供了下列 CSS 變量,可用于自定義樣式,使用方法請參考 ConfigProvider 組件

名稱 默認值 描述
--van-action-bar-background-color var(--van-white) -
--van-action-bar-height 50px -
--van-action-bar-icon-width 48px -
--van-action-bar-icon-height 100% -
--van-action-bar-icon-color var(--van-text-color) -
--van-action-bar-icon-size 18px -
--van-action-bar-icon-font-size var(--van-font-size-xs) -
--van-action-bar-icon-active-color var(--van-active-color) -
--van-action-bar-icon-text-color var(--van-gray-7) -
--van-action-bar-icon-background-color var(--van-white) -
--van-action-bar-button-height 40px -
--van-action-bar-button-warning-color var(--van-gradient-orange) -
--van-action-bar-button-danger-color var(--van-gradient-red) -


以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號