ตัวบอกสถานะความคืบหน้า
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
สัญญาณบอกสถานะความคืบหน้าคือการแสดงแบบวงกลมของระยะเวลาของกระบวนการหรือเวลารอที่ไม่ระบุ
ใช้ตัวบ่งชี้ความคืบหน้าเพื่อแสดงสัดส่วนงานที่เสร็จสมบูรณ์ สัญญาณบอกสถานะจะเคลื่อนไหวไปตามแทร็กวงกลมตามเข็มนาฬิกาเพื่อแสดงความคืบหน้า
คุณใช้ตัวบ่งชี้ความคืบหน้ากับคอมโพเนนต์ต่างๆ ได้ เช่น ปุ่มเล่น
กายวิภาคศาสตร์
ใช้ตัวบ่งชี้ความคืบหน้าเพื่อแสดงสัดส่วนงานที่เสร็จสมบูรณ์ สัญญาณบอกสถานะจะเคลื่อนไหวไปตามแทร็กวงกลมตามเข็มนาฬิกาเพื่อแสดงความคืบหน้า
คุณใช้ตัวบ่งชี้ความคืบหน้ากับคอมโพเนนต์ต่างๆ ได้ เช่น ปุ่มเล่น
คําแนะนําเกี่ยวกับการออกแบบ
สัญญาณบอกสถานะความคืบหน้าที่มีช่องว่าง
สร้างตัวบ่งชี้ความคืบหน้าโดยเว้นระยะห่างไว้สำหรับข้อมูลสำคัญ เช่น เวลา หากต้องการสร้างช่องว่าง ให้เปลี่ยน startAngle และ endAngle ของสัญญาณบอกสถานะความคืบหน้า
สัญญาณบอกสถานะความคืบหน้าขนาดเล็ก
สร้างตัวบ่งชี้ความคืบหน้าโดยเว้นระยะห่างไว้สำหรับข้อมูลสำคัญ เช่น เวลา สร้างช่องว่างโดยเปลี่ยนมุมเริ่มต้นและมุมสิ้นสุดของตัวบ่งชี้ความคืบหน้า
ตัวบอกสถานะความคืบหน้าแบบไม่ระบุเวลา
เมื่อใช้ตัวบ่งชี้ความคืบหน้าสำหรับกรณีที่ไม่มีการตั้งเวลา ให้ใช้ตัวบ่งชี้ความคืบหน้าที่มีค่าแบบเคลื่อนไหว หรือเรียกอีกอย่างว่าสปินเนอร์ ใช้ตัวหมุนอย่างประหยัดเนื่องจากอาจทำให้ผู้ใช้รู้สึกว่าต้องรอนานขึ้น
การใช้งาน
เลย์เอาต์ที่ปรับเปลี่ยนได้
ลักษณะการทํางานแบบตอบสนอง
รอบเส้นรอบวงของสัญญาณบอกสถานะความคืบหน้าจะเติมเต็มความกว้างและความสูงของหน้าจอ/องค์ประกอบ (สำหรับปุ่มเปิด) ตามสัดส่วน ส่วนความกว้างของเส้นจะยังคงเหมือนเดิมในทุกจุดพัก
องศาของช่องว่างสำหรับแบบเต็มหน้าจอจะยังคงอยู่ที่ 51° แต่การกวาดจะเพิ่มขึ้นเป็น dp ตามขนาดหน้าจอ
คุณปรับความกว้างของวงแหวน รวมถึงจุดเริ่มต้นและจุดสิ้นสุดได้
ตัวอย่างเนื้อหาและโค้ดในหน้าเว็บนี้ขึ้นอยู่กับใบอนุญาตที่อธิบายไว้ในใบอนุญาตการใช้เนื้อหา Java และ OpenJDK เป็นเครื่องหมายการค้าหรือเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-27 UTC
[null,null,["อัปเดตล่าสุด 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."]]
