跳至主要內容
版本:v8

ion-progress-bar

陰影

進度條會告知使用者正在進行中的流程狀態,例如載入應用程式、提交表單或儲存更新。進度條有兩種:確定不確定

確定

確定是預設類型。當已知操作的百分比時,應使用此類型。進度透過設定 value 屬性來表示。這可用於顯示從軌跡的 0% 增加到 100% 的進度。

緩衝區

如果設定了 buffer 屬性,則會顯示具有動畫圓圈的緩衝區流,以指示活動。 buffer 屬性的值也將由可見軌跡的量來表示。如果 buffer 的值小於 value 屬性,則不會有可見的軌跡。如果 buffer 等於 1,則會隱藏緩衝區流。

不確定

當不知道流程需要多長時間時,應使用不確定類型。進度條不與 value 繫結,而是不斷地沿著軌跡滑動,直到流程完成。

工具列中的進度條

佈景主題

顏色

CSS 自訂屬性

CSS 陰影部分

屬性

buffer

描述如果緩衝區和值小於 1,則會顯示緩衝區圓圈。緩衝區應介於 [0, 1] 之間。
屬性buffer
類型number
預設1

color

描述要從應用程式的調色盤中使用的顏色。預設選項為:"primary""secondary""tertiary""success""warning""danger""light""medium""dark"。有關顏色的詳細資訊,請參閱佈景主題
屬性color
類型"danger" | "dark" | "light" | "medium" | "primary" | "secondary" | "success" | "tertiary" | "warning" | string | undefined
預設undefined

mode

描述模式決定要使用的平台樣式。
屬性mode
類型"ios" | "md"
預設undefined

reversed

描述如果為 true,則反轉進度條方向。
屬性reversed
類型boolean
預設false

type

描述進度條的狀態,基於是否已知流程所花費的時間。預設選項為:"determinate"(無動畫)、"indeterminate"(從左向右動畫)。
屬性type
類型"determinate" | "indeterminate"
預設'determinate'

value

描述type"determinate" 時,該值決定應顯示多少活動條。該值應介於 [0, 1] 之間。
屬性value
類型number
預設0

事件

此元件沒有可用的事件。

方法

此元件沒有可用的公用方法。

CSS 陰影部分

名稱描述
progresstype"determinate" 時,顯示目前值的進度條,當 type"indeterminate" 時,進度條會來回滑動。
stream在緩衝時出現的動畫圓圈。這只會在設定了 buffertype"determinate" 時顯示。
track進度條後面的軌跡條。如果設定了 buffer 屬性且 type"determinate",則軌跡將會是 buffer 值的寬度。

CSS 自訂屬性

名稱描述
--background進度軌跡的背景,或如果設定了 buffer,則為緩衝區條
--progress-background代表目前值的進度條的背景

插槽

此元件沒有可用的插槽。