สัญญาณบอกสถานะการโหลด

สัญญาณบอกสถานะการโหลดจะแสดงความคืบหน้าสำหรับเวลารอสั้นๆ ซึ่งโดยปกติแล้วจะเป็นการดำเนินการที่เสร็จสมบูรณ์ภายใน 5 วินาที ตัวบ่งชี้การโหลดมีการกำหนดค่า 2 แบบ ดังนี้

  1. ค่าเริ่มต้น: รูปร่างที่เปลี่ยนรูปได้แบบไม่มีขอบเขต
  2. Contained: รูปทรงที่เปลี่ยนรูปร่างภายในคอนเทนเนอร์วงกลม
การกำหนดค่าเริ่มต้นและการกำหนดค่าที่มีอยู่ของสัญญาณบอกสถานะการโหลด
รูปที่ 1 สัญญาณบอกสถานะการโหลดเริ่มต้นและแบบมีคอนเทนเนอร์

ตัวบอกสถานะจะเปลี่ยนรูปร่างหลายเหลี่ยมอย่างต่อเนื่อง ไม่ว่าจะเป็นแบบไม่มีกำหนดหรือตามค่าความคืบหน้า

การใช้สัญญาณบอกสถานะการโหลด

  • แนะนำให้ใช้แทนตัวบอกสถานะความคืบหน้าแบบวงกลมที่ไม่แน่นอนส่วนใหญ่
  • แสดงถึงกระบวนการที่ดำเนินอยู่เสมอและไม่ได้เป็นเพียงการตกแต่งเท่านั้น
  • ใช้เมื่อไม่สามารถวัดความคืบหน้าได้ หรือเมื่อไม่จำเป็นต้องระบุระยะเวลาที่ใช้ในการทำกิจกรรม
  • ใช้สำหรับการโต้ตอบแบบดึงเพื่อรีเฟรชได้
  • ดึงดูดความสนใจผ่านการเคลื่อนไหวที่เปลี่ยนรูปร่าง

ตัวอย่าง

ใช้สัญญาณบอกสถานะการโหลด

สัญญาณบอกสถานะการโหลดใช้ภาพเคลื่อนไหวเพื่อดึงดูดความสนใจ ลดเวลาในการตอบสนองที่รับรู้ และระบุว่ากิจกรรมกำลังดำเนินอยู่ ข้อมูลโค้ดต่อไปนี้จะแสดงผล 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),
        )
    }
}