Vant4 Progress 進(jìn)度條

2023-02-16 17:56 更新

介紹

用于展示操作的當(dāng)前進(jìn)度。

引入

通過(guò)以下方式來(lái)全局注冊(cè)組件,更多注冊(cè)方式請(qǐng)參考組件注冊(cè)。

import { createApp } from 'vue';
import { Progress } from 'vant';

const app = createApp();
app.use(Progress);

代碼演示

基礎(chǔ)用法

進(jìn)度條默認(rèn)為藍(lán)色,使用 ?percentage? 屬性來(lái)設(shè)置當(dāng)前進(jìn)度。

<van-progress :percentage="50" />

線條粗細(xì)

通過(guò) ?stroke-width? 可以設(shè)置進(jìn)度條的粗細(xì)。

<van-progress :percentage="50" stroke-width="8" />

置灰

設(shè)置 ?inactive? 屬性后進(jìn)度條將置灰。

<van-progress inactive :percentage="50" />

樣式定制

可以使用 ?pivot-text? 屬性自定義文字,?color? 屬性自定義進(jìn)度條顏色。

<van-progress pivot-text="橙色" color="#f2826a" :percentage="25" />
<van-progress pivot-text="紅色" color="#ee0a24" :percentage="50" />
<van-progress
  :percentage="75"
  pivot-text="紫色"
  pivot-color="#7232dd"
  color="linear-gradient(to right, #be99ff, #7232dd)"
/>

API

Props

參數(shù) 說(shuō)明 類(lèi)型 默認(rèn)值
percentage 進(jìn)度百分比 number | string 0
stroke-width 進(jìn)度條粗細(xì),默認(rèn)單位為px number | string 4px
color 進(jìn)度條顏色 string #1989fa
track-color 軌道顏色 string #e5e5e5
pivot-text 進(jìn)度文字內(nèi)容 string 百分比
pivot-color 進(jìn)度文字背景色 string 同進(jìn)度條顏色
text-color 進(jìn)度文字顏色 string white
inactive 是否置灰 boolean false
show-pivot 是否顯示進(jìn)度文字 boolean true

類(lèi)型定義

組件導(dǎo)出以下類(lèi)型定義:

import type { ProgressProps, ProgressInstance } from 'vant';

?ProgressInstance? 是組件實(shí)例的類(lèi)型,用法如下:

import { ref } from 'vue';
import type { ProgressInstance } from 'vant';

const progressRef = ref<ProgressInstance>();

progressRef.value?.resize();

主題定制

樣式變量

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

名稱(chēng) 默認(rèn)值 描述
--van-progress-height 4px -
--van-progress-color var(--van-primary-color) -
--van-progress-inactive-color var(--van-gray-5) -
--van-progress-background var(--van-gray-3) -
--van-progress-pivot-padding 0 5px -
--van-progress-pivot-text-color var(--van-white) -
--van-progress-pivot-font-size var(--van-font-size-xs) -
--van-progress-pivot-line-height 1.6 -
--van-progress-pivot-background var(--van-primary-color) -


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

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)