กรณีการใช้งานองค์ประกอบที่ใช้ร่วมกันทั่วไป

เมื่อสร้างภาพเคลื่อนไหวขององค์ประกอบที่แชร์ จะมีบาง Use Case ที่มีคําแนะนําเฉพาะ

รูปภาพแบบไม่ซิงค์

การใช้ไลบรารีเพื่อโหลดรูปภาพแบบไม่พร้อมกันนั้นเป็นเรื่องปกติ เช่น เมื่อใช้ AsyncImage composable ของ Coil เราขอแนะนำให้ตั้งค่า placeholderMemoryCacheKey() และ memoryCacheKey() เป็นคีย์เดียวกันซึ่งเป็นสตริงที่มาจากคีย์องค์ประกอบที่แชร์ เพื่อให้คีย์แคชเหมือนกันสำหรับองค์ประกอบที่แชร์ซึ่งตรงกัน องค์ประกอบที่แชร์ใหม่จะใช้แคชของรายการที่ตรงกันเป็นตัวยึดตำแหน่งจนกว่าจะโหลดรูปภาพใหม่

การใช้งานทั่วไปสำหรับ AsyncImage มีดังนี้

AsyncImage(
    model = ImageRequest.Builder(LocalContext.current)
        .data("your-image-url")
        .crossfade(true)
        .placeholderMemoryCacheKey("image-key") //  same key as shared element key
        .memoryCacheKey("image-key") // same key as shared element key
        .build(),
    placeholder = null,
    contentDescription = null,
    modifier = Modifier
        .size(120.dp)
        .sharedBounds(
            rememberSharedContentState(
                key = "image-key"
            ),
            animatedVisibilityScope = this
        )
)
SharedElementCommonUseCaseSnippets.kt

ข้อความ

หากต้องการแสดงภาพเคลื่อนไหวของการเปลี่ยนแปลง fontSize ให้ใช้ Modifier.sharedBounds(), resizeMode = ScaleToBounds() การเปลี่ยนรูปแบบนี้ทำให้ขนาดเปลี่ยนแปลงได้อย่างราบรื่น คุณปรับแต่งพารามิเตอร์ contentScale เพื่อทำให้น้ำหนักหรือสไตล์แบบอักษรหนึ่งๆ เคลื่อนไหวได้

Text(
    text = "This is an example of how to share text",
    modifier = Modifier
        .wrapContentWidth()
        .sharedBounds(
            rememberSharedContentState(
                key = "shared Text"
            ),
            animatedVisibilityScope = this,
            enter = fadeIn(),
            exit = fadeOut(),
            resizeMode = SharedTransitionScope.ResizeMode.ScaleToBounds()
        )
)
SharedElementCommonUseCaseSnippets.kt

การเปลี่ยนแปลง TextAlign จะไม่แสดงภาพเคลื่อนไหวโดยค่าเริ่มต้น ให้ใช้ Modifier.wrapContentSize() / Modifier.wrapContentWidth() แทนการใช้ TextAlign ที่แตกต่างกันสำหรับทรานซิชันที่ใช้ร่วมกัน