載入指示器:指引
載入指示器會顯示處理作業在短暫等待期間的進度
用法
載入指示器透過動畫吸引注意力、降低使用者對延遲的感受,並表示作業正在進行。
當無法偵測進度,或無需說明作業所需時間時,應使用載入指示器。
雖然功能與環形進度指示器類似,但對於 200ms 至 5s 的短暫處理作業,載入指示器是較佳選擇。
請依預期等待時間與處理作業類型,選擇載入指示器或進度指示器。
若等待時間很長,請考慮讓使用者在處理作業完成前先前往其他頁面。
| 預期等待時間 | 建議 |
|---|---|
| 即時(低於 200ms) | 不顯示指示器 |
| 短暫(200ms 至 5s 之間) | 載入指示器 |
| 長時間(超過 5s) | 進度指示器 |
當處理作業可從不確定進度(進度未知)轉為確定進度(剩餘進度已知)時,請在對應的進度指示器之間切換。
請勿將載入指示器轉換為進度指示器。
結構

- 作用中指示器
- 容器(選用)

容器(選用)
當容器顯示時,作用中指示器的色彩應從 primary 改為 on-primary-container。
當載入指示器置於其他內容上方時,應顯示容器,以更強烈的對比提高醒目程度;若載入指示器直接置於表面上,則不需要容器。
容器應搭配下拉重新整理行為使用。

位置
載入頁面或容器時,載入指示器應置於該元素正中央。
在已有內容的頁面上載入更多項目時,請將載入指示器置於新內容即將出現的空白處,並避免與現有內容重疊。
載入指示器可置於其他元件中(例如 按鈕),以表示操作正在進行,例如驗證表單或檢查更新。
回應式版面配置
載入指示器預設大小為 48dp,但可彈性調整。依位置與中斷點而定,大小應介於 24dp 至 240dp 之間,請勿小於最小尺寸或大於最大尺寸。
調整載入指示器大小時,容器與作用中指示器之間的比例應維持不變。
非常大的進度指示器應保留給大型與超大型視窗,例如桌面環境。

較大的視窗
當窗格或視窗大小增加時,請考慮一併縮放載入指示器,使其大小與周圍空白處保持比例;載入指示器不應超過 240dp。
行為
下拉重新整理
載入指示器僅用於 Jetpack Compose 的下拉重新整理功能。
下拉重新整理是 Android 系統功能,可透過操作或手勢手動重新整理畫面內容;它用於清單、網格清單與卡片集合的開頭,也就是最新內容出現的位置。
下拉重新整理最適合用於可能頻繁更新的動態內容,讓使用者在重新整理後很可能看到新內容。
門檻值要求
為確保下拉重新整理手勢是使用者刻意觸發的,載入指示器必須超過門檻值,應用程式才會執行重新整理。
載入指示器會保持可見,直到重新整理作業完成且新內容可見,或使用者已離開正在重新整理的頁面。