W3Cschool
恭喜您成為首批注冊用戶
獲得88經驗值獎勵
進度條組件,用于顯示內容加載或操作處理等進度。
該組件從API version7開始支持。后續(xù)版本如有新增內容,則采用上角標單獨標記該內容的起始版本。
Progress(options: {value: number, total?: number, type?: ProgressType})
創(chuàng)建進度組件,用于顯示內容加載或操作處理進度。
從API version 9開始,該接口支持在ArkTS卡片中使用。
參數:
參數名 | 參數類型 | 必填 | 參數描述 |
---|---|---|---|
value | number | 是 | 指定當前進度值。設置小于0的數值時置為0,設置大于total的數值時置為total。 從API version 9開始,該接口支持在ArkTS卡片中使用。 |
total | number | 否 | 指定進度總長。 默認值:100 從API version 9開始,該接口支持在ArkTS卡片中使用。 |
type8+ | 否 | 指定進度條類型。 默認值:ProgressType.Linear 從API version 9開始,該接口支持在ArkTS卡片中使用。 | |
styledeprecated | 否 | 指定進度條樣式。 該參數從API version8開始廢棄,建議使用type替代。 默認值:ProgressStyle.Linear |
從API version 9開始,該接口支持在ArkTS卡片中使用。
名稱 | 描述 |
---|---|
Linear | 線性樣式。從API version9開始,高度大于寬度的時候自適應垂直顯示。 |
Ring8+ | 環(huán)形無刻度樣式,環(huán)形圓環(huán)逐漸顯示至完全填充效果。 |
Eclipse8+ | 圓形樣式,顯示類似月圓月缺的進度展示效果,從月牙逐漸變化至滿月。 |
ScaleRing8+ | 環(huán)形有刻度樣式,顯示類似時鐘刻度形式的進度展示效果。從API version9開始,刻度外圈出現(xiàn)重疊的時候自動轉換為環(huán)形無刻度進度條。 |
Capsule8+ | 膠囊樣式,頭尾兩端圓弧處的進度展示效果與Eclipse相同;中段處的進度展示效果與Linear相同。高度大于寬度的時候自適應垂直顯示。 |
從API version 9開始,該接口支持在ArkTS卡片中使用。
名稱 | 描述 |
---|---|
Linear | 線性樣式。 |
Ring | 環(huán)形無刻度樣式,環(huán)形圓環(huán)逐漸顯示至完全填充效果。 |
Eclipse | 圓形樣式,顯示類似月圓月缺的進度展示效果,從月牙逐漸變化至滿月。 |
ScaleRing | 環(huán)形有刻度樣式,顯示類似時鐘刻度形式的進度展示效果。 |
Capsule | 膠囊樣式,頭尾兩端圓弧處的進度展示效果與Eclipse相同;中段處的進度展示效果與Linear相同。高度大于寬度的時候自適應垂直顯示。 |
名稱 | 參數類型 | 描述 |
---|---|---|
value | number | 設置當前進度值。設置小于0的數值時置為0,設置大于total的數值時置為total。非法數值不生效。 從API version 9開始,該接口支持在ArkTS卡片中使用。 |
color | 設置進度條前景色。 默認值:'#ff007dff' 從API version 9開始,該接口支持在ArkTS卡片中使用。 | |
backgroundColor | 設置進度條底色。 默認值:'#19182431' 從API version 9開始,該接口支持在ArkTS卡片中使用。 | |
style8+ | { strokeWidth?: Length, scaleCount?: number, scaleWidth?: Length } | 定義組件的樣式。 - strokeWidth: 設置進度條寬度(不支持百分比設置)。從API version9開始,環(huán)形進度條設置寬度大于等于半徑時,默認修改寬度至半徑值的二分之一。 默認值:4.0Vp - scaleCount: 設置環(huán)形進度條總刻度數。 默認值:120 - scaleWidth: 設置環(huán)形進度條刻度粗細(不支持百分比設置),刻度粗細大于進度條寬度時,為系統(tǒng)默認粗細。 默認值:2.0Vp 從API version 9開始,該接口支持在ArkTS卡片中使用。 |
- // xxx.ets
- @Entry
- @Component
- struct ProgressExample {
- build() {
- Column({ space: 15 }) {
- Text('Linear Progress').fontSize(9).fontColor(0xCCCCCC).width('90%')
- Progress({ value: 10, type: ProgressType.Linear }).width(200)
- Progress({ value: 20, total: 150, type: ProgressType.Linear }).color(Color.Grey).value(50).width(200)
- Text('Eclipse Progress').fontSize(9).fontColor(0xCCCCCC).width('90%')
- Row({ space: 40 }) {
- Progress({ value: 10, type: ProgressType.Eclipse }).width(100)
- Progress({ value: 20, total: 150, type: ProgressType.Eclipse }).color(Color.Grey).value(50).width(100)
- }
- Text('ScaleRing Progress').fontSize(9).fontColor(0xCCCCCC).width('90%')
- Row({ space: 40 }) {
- Progress({ value: 10, type: ProgressType.ScaleRing }).width(100)
- Progress({ value: 20, total: 150, type: ProgressType.ScaleRing })
- .color(Color.Grey).value(50).width(100)
- .style({ strokeWidth: 15, scaleCount: 15, scaleWidth: 5 })
- }
- // scaleCount和scaleWidth效果對比
- Row({ space: 40 }) {
- Progress({ value: 20, total: 150, type: ProgressType.ScaleRing })
- .color(Color.Grey).value(50).width(100)
- .style({ strokeWidth: 20, scaleCount: 20, scaleWidth: 5 })
- Progress({ value: 20, total: 150, type: ProgressType.ScaleRing })
- .color(Color.Grey).value(50).width(100)
- .style({ strokeWidth: 20, scaleCount: 30, scaleWidth: 3 })
- }
- Text('Ring Progress').fontSize(9).fontColor(0xCCCCCC).width('90%')
- Row({ space: 40 }) {
- Progress({ value: 10, type: ProgressType.Ring }).width(100)
- Progress({ value: 20, total: 150, type: ProgressType.Ring })
- .color(Color.Grey).value(50).width(100)
- .style({ strokeWidth: 20, scaleCount: 30, scaleWidth: 20 })
- }
- Text('Capsule Progress').fontSize(9).fontColor(0xCCCCCC).width('90%')
- Row({ space: 40 }) {
- Progress({ value: 10, type: ProgressType.Capsule }).width(100).height(50)
- Progress({ value: 20, total: 150, type: ProgressType.Capsule })
- .color(Color.Grey)
- .value(50)
- .width(100)
- .height(50)
- }
- }.width('100%').margin({ top: 30 })
- }
- }
Copyright©2021 w3cschool編程獅|閩ICP備15016281號-3|閩公網安備35020302033924號
違法和不良信息舉報電話:173-0602-2364|舉報郵箱:jubao@eeedong.com
掃描二維碼
下載編程獅App
編程獅公眾號
聯(lián)系方式:
更多建議: