Vant4 Progress 進度條

2023-02-16 17:56 更新

介紹

用于展示操作的當前進度。

引入

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

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

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

代碼演示

基礎(chǔ)用法

進度條默認為藍色,使用 ?percentage? 屬性來設(shè)置當前進度。

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

線條粗細

通過 ?stroke-width? 可以設(shè)置進度條的粗細。

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

置灰

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

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

樣式定制

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

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

類型定義

組件導出以下類型定義:

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

?ProgressInstance? 是組件實例的類型,用法如下:

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

const progressRef = ref<ProgressInstance>();

progressRef.value?.resize();

主題定制

樣式變量

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

名稱 默認值 描述
--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)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號