สัญญาณบอกสถานะการโหลดจะแสดงความคืบหน้าสำหรับเวลารอสั้นๆ ซึ่งโดยปกติแล้วจะเป็นการดำเนินการที่เสร็จสมบูรณ์ภายใน 5 วินาที ตัวบ่งชี้การโหลดมีการกำหนดค่า 2 แบบ ดังนี้
- ค่าเริ่มต้น: รูปร่างที่เปลี่ยนรูปได้แบบไม่มีขอบเขต
- Contained: รูปทรงที่เปลี่ยนรูปร่างภายในคอนเทนเนอร์วงกลม
ตัวบอกสถานะจะเปลี่ยนรูปร่างหลายเหลี่ยมอย่างต่อเนื่อง ไม่ว่าจะเป็นแบบไม่มีกำหนดหรือตามค่าความคืบหน้า
การใช้สัญญาณบอกสถานะการโหลด
- แนะนำให้ใช้แทนตัวบอกสถานะความคืบหน้าแบบวงกลมที่ไม่แน่นอนส่วนใหญ่
- แสดงถึงกระบวนการที่ดำเนินอยู่เสมอและไม่ได้เป็นเพียงการตกแต่งเท่านั้น
- ใช้เมื่อไม่สามารถวัดความคืบหน้าได้ หรือเมื่อไม่จำเป็นต้องระบุระยะเวลาที่ใช้ในการทำกิจกรรม
- ใช้สำหรับการโต้ตอบแบบดึงเพื่อรีเฟรชได้
- ดึงดูดความสนใจผ่านการเคลื่อนไหวที่เปลี่ยนรูปร่าง
ตัวอย่าง
ใช้สัญญาณบอกสถานะการโหลด
สัญญาณบอกสถานะการโหลดใช้ภาพเคลื่อนไหวเพื่อดึงดูดความสนใจ ลดเวลาในการตอบสนองที่รับรู้ และระบุว่ากิจกรรมกำลังดำเนินอยู่ ข้อมูลโค้ดต่อไปนี้จะแสดงผล LoadingIndicator ที่ไม่แน่นอนเริ่มต้น
@Composable fun LoadingIndicatorSample() { Column(horizontalAlignment = Alignment.CenterHorizontally) { LoadingIndicator() } }
ใช้สัญญาณบอกสถานะการโหลดที่อยู่ในคอนเทนเนอร์
ใช้ ContainedLoadingIndicator เพื่อแสดงผลรูปร่างที่เปลี่ยนรูปได้ภายในคอนเทนเนอร์วงกลมที่ให้คอนทราสต์เพิ่มเติมเหนือเนื้อหาหลัก ข้อมูลโค้ดต่อไปนี้จะใช้สัญญาณบอกสถานะการโหลดแบบจำกัด
@Composable fun ContainedLoadingIndicatorSample() { Column(horizontalAlignment = Alignment.CenterHorizontally) { ContainedLoadingIndicator() } }
ใช้สัญญาณบอกสถานะการโหลดที่แน่นอน
ส่ง progress lambda ที่แสดงผล Float จาก 0.0 ไปยัง 1.0 เพื่อเปลี่ยนรูปแบบ LoadingIndicator อย่างแน่นอนเมื่อการดำเนินการดำเนินไป ข้อมูลโค้ดต่อไปนี้จะขับเคลื่อนความคืบหน้าของสัญญาณบอกสถานะการโหลดด้วย Slider และ rememberSliderState
@Composable fun DeterminateLoadingIndicatorSample() { val sliderState = rememberSliderState() val animatedProgress by animateFloatAsState( targetValue = sliderState.value, animationSpec = spring( dampingRatio = Spring.DampingRatioNoBouncy, stiffness = Spring.StiffnessVeryLow, visibilityThreshold = 1 / 1000f, ), ) Column(horizontalAlignment = Alignment.CenterHorizontally) { LoadingIndicator(progress = { animatedProgress }) Spacer(Modifier.requiredHeight(30.dp)) Text("Set loading progress:") Slider( state = sliderState, onValueChange = { sliderState.value = it }, modifier = Modifier.width(300.dp), ) } }