Chỉ báo tiến trình
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Chỉ báo tiến trình là những màn hình tròn thể hiện thời lượng của một quy trình hoặc thời gian chờ không xác định khác.
Sử dụng chỉ báo tiến trình để cho biết tỷ lệ của một nhiệm vụ đã hoàn thành. Để hiển thị tiến trình, một chỉ báo sẽ được tạo ảnh động dọc theo một vòng tròn theo chiều kim đồng hồ.
Bạn có thể áp dụng chỉ báo tiến trình cho các thành phần như nút phát.
Phân tích
Sử dụng chỉ báo tiến trình để cho biết tỷ lệ của một nhiệm vụ đã hoàn thành. Để hiển thị tiến trình, một chỉ báo sẽ được tạo ảnh động dọc theo một vòng tròn theo chiều kim đồng hồ.
Bạn có thể áp dụng chỉ báo tiến trình cho các thành phần như nút phát.
Đề xuất thiết kế
Chỉ báo tiến trình có khoảng trống
Tạo chỉ báo tiến trình bằng một khoảng trống để dành không gian cho những thông tin quan trọng, chẳng hạn như thời gian. Để tạo một khoảng trống, hãy thay đổi góc startAngle và endAngle của chỉ báo tiến trình.
Chỉ báo tiến trình nhỏ
Tạo chỉ báo tiến trình bằng một khoảng trống để dành không gian cho những thông tin quan trọng, chẳng hạn như thời gian. Tạo khoảng trống bằng cách thay đổi góc bắt đầu và góc kết thúc của chỉ báo tiến trình.
Chỉ báo tiến trình không xác định
Khi sử dụng chỉ báo tiến trình cho các tình huống không có thời gian cố định, hãy sử dụng chỉ báo tiến trình có giá trị dạng ảnh động. Đây cũng có thể được gọi là vòng quay. Sử dụng vòng quay một cách thận trọng vì chúng có thể giúp tăng thời gian chờ đợi.
Cách sử dụng
Bố cục thích ứng (Adaptive Layouts)
Hành vi thích ứng
Chu vi của chỉ báo tiến trình sẽ lấp đầy chiều rộng và chiều cao của màn hình/phần tử (đối với nút trên nút) theo tỷ lệ, trong khi chiều rộng nét vẫn giữ nguyên trên tất cả các điểm ngắt.
Độ chênh lệch đối với chế độ toàn màn hình luôn ở mức 51°, nhưng khoảng cách quét sẽ tăng lên theo dp dựa trên kích thước màn hình.
Chiều rộng vòng nhẫn, điểm xuất phát và điểm kết thúc có thể tuỳ chỉnh.
Nội dung và mã mẫu trên trang này phải tuân thủ các giấy phép như mô tả trong phần Giấy phép nội dung. Java và OpenJDK là nhãn hiệu hoặc nhãn hiệu đã đăng ký của Oracle và/hoặc đơn vị liên kết của Oracle.
Cập nhật lần gần đây nhất: 2025-07-27 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-27 UTC."],[],[],null,["# Progress indicator\n\n[Progress indicators](/reference/kotlin/androidx/wear/compose/material/package-summary#CircularProgressIndicator(kotlin.Float,androidx.compose.ui.Modifier,kotlin.Float,kotlin.Float,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.unit.Dp)) are circular displays of the length of a process or an otherwise unspecified wait time. \nUse progress indicators to show the proportion of a task that is complete. To show progress an indicator is animated along a circular track in a clockwise direction. \n\nYou can apply progress indicators to components such as a play button.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nAnatomy\n-------\n\nUse progress indicators to show the proportion of a task that is complete. To show progress an indicator is animated along a circular track in a clockwise direction. \n\nYou can apply progress indicators to components such as a play button.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n**Design recommendations**\n--------------------------\n\n**Progress indicator with gap**\n\n\u003cbr /\u003e\n\n\nCreate progress indicators with a gap to leave space for important information such as the time. To create a gap, change the progress indicator's startAngle and endAngle.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n**Small progress indicator**\n\n\u003cbr /\u003e\n\n\nCreate progress indicators with a gap to leave space for important information such as the time. Create a gap by changing the progress indicator's start and end angle.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n**Indeterminate progress indicator**\n\n\u003cbr /\u003e\n\n\nWhen using the progress indicator for situations where there is no set time, use a progress indicator with animated value. This can also be called a spinner. Use spinners sparingly as they can increase perceived wait time.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nUsage\n-----\n\nAdaptive layouts\n----------------\n\nResponsive behavior\n-------------------\n\nThe circumference of the progress indicator fills the screen/element (for on button) width and height, proportionally, while the stroke width remains the same across all breakpoints. \n\n\nThe gap degree for full screen stays at 51°, but the sweep will increase in dp based on the screen size. \n\nThe ring width and starting and end points are customisable."]]
