用于為頁面相關(guān)操作提供便捷交互。
通過以下方式來全局注冊(cè)組件,更多注冊(cè)方式請(qǐng)參考組件注冊(cè)。
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 { showToast } from 'vant';
export default {
setup() {
const onClickIcon = () => showToast('點(diǎn)擊圖標(biāo)');
const onClickButton = () => showToast('點(diǎn)擊按鈕');
return {
onClickIcon,
onClickButton,
};
},
};
在 ActionBarIcon 組件上設(shè)置 ?dot
? 屬性后,會(huì)在圖標(biāo)右上角展示一個(gè)小紅點(diǎn);設(shè)置 ?badge
? 屬性后,會(huì)在圖標(biāo)右上角展示相應(yīng)的徽標(biāo)。
<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
? 屬性可以自定義圖標(biāo)的顏色。
<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>
參數(shù) | 說明 | 類型 | 默認(rèn)值 |
---|---|---|---|
safe-area-inset-bottom | 是否開啟底部安全區(qū)適配 | boolean | true
|
placeholder v3.5.1
|
是否在標(biāo)簽位置生成一個(gè)等高的占位元素 | boolean | false
|
參數(shù) | 說明 | 類型 | 默認(rèn)值 |
---|---|---|---|
text | 按鈕文字 | string | - |
icon | 圖標(biāo) | string | - |
color | 圖標(biāo)顏色 | string | #323233
|
icon-class | 圖標(biāo)額外類名 | string | Array | object | - |
icon-prefix v3.0.17
|
圖標(biāo)類名前綴,等同于 Icon 組件的 class-prefix 屬性 | string | van-icon
|
dot | 是否顯示圖標(biāo)右上角小紅點(diǎn) | boolean | false
|
badge | 圖標(biāo)右上角徽標(biāo)的內(nèi)容 | number | string | - |
badge-props v3.2.8
|
自定義徽標(biāo)的屬性,傳入的對(duì)象會(huì)被透?jìng)鹘o Badge 組件的 props | BadgeProps | - |
url | 點(diǎn)擊后跳轉(zhuǎn)的鏈接地址 | string | - |
to | 點(diǎn)擊后跳轉(zhuǎn)的目標(biāo)路由對(duì)象,等同于 vue-router 的 to 屬性 | string | object | - |
replace | 是否在跳轉(zhuǎn)時(shí)替換當(dāng)前頁面歷史 | boolean | false
|
參數(shù) | 說明 | 類型 | 默認(rèn)值 |
---|---|---|---|
text | 按鈕文字 | string | - |
type | 按鈕類型,可選值為 primary info warning danger
|
string | default
|
color | 按鈕顏色,支持傳入 linear-gradient 漸變色 |
string | - |
icon | 左側(cè)圖標(biāo)名稱或圖片鏈接,等同于 Icon 組件的 name 屬性 | string | - |
disabled | 是否禁用按鈕 | boolean | false
|
loading | 是否顯示為加載狀態(tài) | boolean | false
|
url | 點(diǎn)擊后跳轉(zhuǎn)的鏈接地址 | string | - |
to | 點(diǎn)擊后跳轉(zhuǎn)的目標(biāo)路由對(duì)象,等同于 vue-router 的 to 屬性 | string | object | - |
replace | 是否在跳轉(zhuǎn)時(shí)替換當(dāng)前頁面歷史 | boolean | false
|
名稱 | 說明 |
---|---|
default | 文本內(nèi)容 |
icon | 自定義圖標(biāo) |
名稱 | 說明 |
---|---|
default | 按鈕顯示內(nèi)容 |
組件導(dǎo)出以下類型定義:
import type {
ActionBarProps,
ActionBarIconProps,
ActionBarButtonProps,
} from 'vant';
組件提供了下列 CSS 變量,可用于自定義樣式,使用方法請(qǐng)參考 ConfigProvider 組件。
名稱 | 默認(rèn)值 | 描述 |
---|---|---|
--van-action-bar-background | var(--van-background-2) | - |
--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-text-color) | - |
--van-action-bar-icon-background | var(--van-background-2) | - |
--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) | - |
更多建議: