介紹

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

實(shí)例演示

引入

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

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

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

代碼演示

基礎(chǔ)用法

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

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

線條粗細(xì)

通過 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

方法

通過 ref 可以獲取到 Progress 實(shí)例并調(diào)用實(shí)例方法，詳見組件實(shí)例方法。

樣式變量

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

常見問題

組件從隱藏狀態(tài)切換到顯示狀態(tài)時，渲染不正確？

Progress 組件在掛載時，會獲取自身的寬度，并計算出進(jìn)度條的樣式。如果組件一開始處于隱藏狀態(tài)，則獲取到的寬度永遠(yuǎn)為 0，因此無法展示正確的進(jìn)度。

解決方法

方法一，如果是使用 v-show 來控制組件展示的，則替換為 v-if 即可解決此問題：

<!-- Before -->
<van-progress v-show="show" />
<!-- After -->
<van-progress v-if="show" />

方法二，調(diào)用組件的 resize 方法來主動觸發(fā)重繪：

<van-progress v-show="show" ref="progress" />

this.$refs.progress.resize();