الدليل السريع للصور المتحركة في ميزة "الكتابة"

يتضمّن Compose العديد من آليات الصور المتحركة المضمّنة، وقد يكون من الصعب معرفة أيّ منها يجب اختياره. فيما يلي قائمة بحالات استخدام الرسوم المتحركة الشائعة. لمزيد من المعلومات التفصيلية حول المجموعة الكاملة من خيارات واجهة برمجة التطبيقات المختلفة المتاحة لك، يمكنك قراءة مستندات Compose Animation الكاملة.

إضافة حركة إلى خصائص الدوال المركّبة الشائعة

توفّر Compose واجهات برمجة تطبيقات ملائمة تتيح لك حلّ العديد من حالات الاستخدام الشائعة للصور المتحركة. يوضّح هذا القسم كيفية تحريك السمات الشائعة لدالة مركّبة.

تحريك الظهور / الاختفاء

استخدِم AnimatedVisibility لإخفاء دالة مركّبة أو إظهارها. يمكن للأطفال داخل AnimatedVisibility استخدام Modifier.animateEnterExit() للانتقال إلى الداخل أو الخارج.

var visible by remember {
    mutableStateOf(true)
}
// Animated visibility will eventually remove the item from the composition once the animation has finished.
AnimatedVisibility(visible) {
    // your composable here
    // ...
}
الشكل 1: تحريك ظهور عنصر واختفائه في عمود

تتيح لك مَعلمتا الدخول والخروج في AnimatedVisibility ضبط سلوك الدالة المركّبة عند ظهورها واختفائها. يمكنك الاطّلاع على المستندات الكاملة لمزيد من المعلومات.

هناك خيار آخر لتحريك مستوى ظهور دالة مركّبة، وهو تحريك قيمة ألفا بمرور الوقت باستخدام animateFloatAsState:

var visible by remember {
    mutableStateOf(true)
}
val animatedAlpha by animateFloatAsState(
    targetValue = if (visible) 1.0f else 0f,
    label = "alpha"
)
Box(
    modifier = Modifier
        .size(200.dp)
        .graphicsLayer {
            alpha = animatedAlpha
        }
        .clip(RoundedCornerShape(8.dp))
        .background(colorGreen)
        .align(Alignment.TopCenter)
) {
}
الشكل 2. تحريك شفافية دالة مركّبة

ومع ذلك، فإنّ تغيير قيمة ألفا يأتي مع تحذير بأنّ الدالة المركّبة تظل في التركيب وتستمر في شغل المساحة التي تم وضعها فيها. قد يؤدي ذلك إلى استمرار برامج قراءة الشاشة وآليات تسهيل الاستخدام الأخرى في اعتبار العنصر على الشاشة. من ناحية أخرى، يزيل AnimatedVisibility في النهاية العنصر من التكوين.

تحريك لون الخلفية

دالة مركّبة يتغيّر لون خلفيتها بمرور الوقت كصورة متحركة، حيث تتلاشى الألوان في بعضها البعض.
الشكل 3. تحريك لون خلفية الدالة المركّبة

val animatedColor by animateColorAsState(
    if (animateBackgroundColor) colorGreen else colorBlue,
    label = "color"
)
Column(
    modifier = Modifier.drawBehind {
        drawRect(animatedColor)
    }
) {
    // your composable here
}

يوفّر هذا الخيار أداءً أفضل من استخدام Modifier.background(). يُعدّ Modifier.background() مقبولاً لإعداد لون لمرة واحدة، ولكن عند تحريك لون بمرور الوقت، قد يؤدي ذلك إلى إجراء عمليات إعادة تركيب أكثر من اللازم.

لتحريك لون الخلفية بشكل لا نهائي، راجِع قسم تكرار الحركة.

تحريك حجم دالة مركّبة

تتيح لك أداة Compose تحريك حجم الدوال المركّبة ببضع طرق مختلفة. استخدِم animateContentSize() للصور المتحركة بين تغييرات حجم الدوال المركّبة.

على سبيل المثال، إذا كان لديك مربّع يحتوي على نص يمكن توسيعه من سطر واحد إلى أسطر متعددة، يمكنك استخدام Modifier.animateContentSize() لتحقيق انتقال أكثر سلاسة:

var expanded by remember { mutableStateOf(false) }
Box(
    modifier = Modifier
        .background(colorBlue)
        .animateContentSize()
        .height(if (expanded) 400.dp else 200.dp)
        .fillMaxWidth()
        .clickable(
            interactionSource = remember { MutableInteractionSource() },
            indication = null
        ) {
            expanded = !expanded
        }

) {
}
الشكل 4. دالة مركّبة تعرض حركة سلسة بين حجم صغير وحجم أكبر

يمكنك أيضًا استخدام AnimatedContent مع SizeTransform لوصف كيفية إجراء تغييرات الحجم.

تحريك موضع الدالة المركّبة

لتحريك موضع دالة مركّبة، استخدِم Modifier.offset{ } مع animateIntOffsetAsState().

var moved by remember { mutableStateOf(false) }
val pxToMove = with(LocalDensity.current) {
    100.dp.toPx().roundToInt()
}
val offset by animateIntOffsetAsState(
    targetValue = if (moved) {
        IntOffset(pxToMove, pxToMove)
    } else {
        IntOffset.Zero
    },
    label = "offset"
)

Box(
    modifier = Modifier
        .offset {
            offset
        }
        .background(colorBlue)
        .size(100.dp)
        .clickable(
            interactionSource = remember { MutableInteractionSource() },
            indication = null
        ) {
            moved = !moved
        }
)
الشكل 5. دالة مركّبة تتحرك بمقدار إزاحة

إذا أردت التأكّد من عدم رسم الدوال المركّبة فوق أو تحت دوال مركّبة أخرى عند إضافة تأثيرات حركية إلى الموضع أو الحجم، استخدِم Modifier.layout{ }. ينشر هذا المُعدِّل تغييرات الحجم والموضع إلى العنصر الرئيسي، ما يؤثر بعد ذلك في العناصر الفرعية الأخرى.

على سبيل المثال، إذا كنت تنقل Box داخل Column وتحتاج العناصر الثانوية الأخرى إلى التحرك عند تحرك Box، يمكنك تضمين معلومات الإزاحة مع Modifier.layout{ } على النحو التالي:

var toggled by remember {
    mutableStateOf(false)
}
val interactionSource = remember {
    MutableInteractionSource()
}
Column(
    modifier = Modifier
        .padding(16.dp)
        .fillMaxSize()
        .clickable(indication = null, interactionSource = interactionSource) {
            toggled = !toggled
        }
) {
    val offsetTarget = if (toggled) {
        IntOffset(150, 150)
    } else {
        IntOffset.Zero
    }
    val offset = animateIntOffsetAsState(
        targetValue = offsetTarget, label = "offset"
    )
    Box(
        modifier = Modifier
            .size(100.dp)
            .background(colorBlue)
    )
    Box(
        modifier = Modifier
            .layout { measurable, constraints ->
                val offsetValue = if (isLookingAhead) offsetTarget else offset.value
                val placeable = measurable.measure(constraints)
                layout(placeable.width + offsetValue.x, placeable.height + offsetValue.y) {
                    placeable.placeRelative(offsetValue)
                }
            }
            .size(100.dp)
            .background(colorGreen)
    )
    Box(
        modifier = Modifier
            .size(100.dp)
            .background(colorBlue)
    )
}
الشكل 6 إنشاء صور متحركة باستخدام Modifier.layout{ }

تحريك حشو دالة مركّبة

لتحريك حشو دالة مركّبة، استخدِم animateDpAsState مع Modifier.padding():

var toggled by remember {
    mutableStateOf(false)
}
val animatedPadding by animateDpAsState(
    if (toggled) {
        0.dp
    } else {
        20.dp
    },
    label = "padding"
)
Box(
    modifier = Modifier
        .aspectRatio(1f)
        .fillMaxSize()
        .padding(animatedPadding)
        .background(Color(0xff53D9A1))
        .clickable(
            interactionSource = remember { MutableInteractionSource() },
            indication = null
        ) {
            toggled = !toggled
        }
)
الشكل 7. دالة مركّبة مع تحريك الحشو

إضافة تأثيرات حركية إلى ارتفاع دالة مركّبة

لتحريك ارتفاع دالة مركّبة، استخدِم animateDpAsState مع Modifier.graphicsLayer{ }. لإجراء تغييرات في الارتفاع لمرة واحدة، استخدِم Modifier.shadow(). إذا كنت تريد إضافة تأثيرات حركية إلى الظل، يُعدّ استخدام المُعدِّل Modifier.graphicsLayer{ } الخيار الأفضل من حيث الأداء.

val mutableInteractionSource = remember {
    MutableInteractionSource()
}
val pressed = mutableInteractionSource.collectIsPressedAsState()
val elevation = animateDpAsState(
    targetValue = if (pressed.value) {
        32.dp
    } else {
        8.dp
    },
    label = "elevation"
)
Box(
    modifier = Modifier
        .size(100.dp)
        .align(Alignment.Center)
        .graphicsLayer {
            this.shadowElevation = elevation.value.toPx()
        }
        .clickable(interactionSource = mutableInteractionSource, indication = null) {
        }
        .background(colorGreen)
) {
}
الشكل 8. ارتفاع الدالة المركّبة يتحرّك عند النقر

بدلاً من ذلك، يمكنك استخدام الدالة المركّبة Card وضبط سمة الارتفاع على قيم مختلفة لكل حالة.

تحريك حجم النص أو ترجمته أو تدويره

عند تحريك حجم النص أو ترجمته أو تدويره، اضبط المَعلمة textMotion في TextStyle على TextMotion.Animated. يضمن ذلك انتقالات أكثر سلاسة بين الرسوم المتحركة للنص. استخدِم Modifier.graphicsLayer{ } لترجمة النص أو تدويره أو تغيير حجمه.

val infiniteTransition = rememberInfiniteTransition(label = "infinite transition")
val scale by infiniteTransition.animateFloat(
    initialValue = 1f,
    targetValue = 8f,
    animationSpec = infiniteRepeatable(tween(1000), RepeatMode.Reverse),
    label = "scale"
)
Box(modifier = Modifier.fillMaxSize()) {
    Text(
        text = "Hello",
        modifier = Modifier
            .graphicsLayer {
                scaleX = scale
                scaleY = scale
                transformOrigin = TransformOrigin.Center
            }
            .align(Alignment.Center),
        // Text composable does not take TextMotion as a parameter.
        // Provide it via style argument but make sure that we are copying from current theme
        style = LocalTextStyle.current.copy(textMotion = TextMotion.Animated)
    )
}
الشكل 9. نص يتحرك بسلاسة بين حجمَين

تحريك لون النص

لتحريك لون النص، استخدِم دالة lambda‏ color في العنصر المركّب BasicText:

val infiniteTransition = rememberInfiniteTransition(label = "infinite transition")
val animatedColor by infiniteTransition.animateColor(
    initialValue = Color(0xFF60DDAD),
    targetValue = Color(0xFF4285F4),
    animationSpec = infiniteRepeatable(tween(1000), RepeatMode.Reverse),
    label = "color"
)

BasicText(
    text = "Hello Compose",
    color = {
        animatedColor
    },
    // ...
)
الشكل 10: مثال يعرض لون النص المتحرك

التبديل بين أنواع مختلفة من المحتوى

استخدِم AnimatedContent لإضافة تأثيرات متحركة بين الدوال المركّبة المختلفة، وإذا أردت فقط استخدام تأثير التلاشي العادي بين الدوال المركّبة، استخدِم Crossfade.

var state by remember {
    mutableStateOf(UiState.Loading)
}
AnimatedContent(
    state,
    transitionSpec = {
        fadeIn(
            animationSpec = tween(3000)
        ) togetherWith fadeOut(animationSpec = tween(3000))
    },
    modifier = Modifier.clickable(
        interactionSource = remember { MutableInteractionSource() },
        indication = null
    ) {
        state = when (state) {
            UiState.Loading -> UiState.Loaded
            UiState.Loaded -> UiState.Error
            UiState.Error -> UiState.Loading
        }
    },
    label = "Animated Content"
) { targetState ->
    when (targetState) {
        UiState.Loading -> {
            LoadingScreen()
        }
        UiState.Loaded -> {
            LoadedScreen()
        }
        UiState.Error -> {
            ErrorScreen()
        }
    }
}
الشكل 11: استخدام AnimatedContent لتحريك التغييرات بين الدوال المركّبة المختلفة (تم إبطاؤها)

يمكن تخصيص AnimatedContent لعرض العديد من أنواع انتقالات الدخول والخروج المختلفة. لمزيد من المعلومات، يمكنك قراءة المستندات حول AnimatedContent أو قراءة منشور المدوّنة هذا حول AnimatedContent.

استخدام تأثيرات متحركة أثناء التنقّل إلى وجهات مختلفة

دالتان مركّبتان، إحداهما خضراء تحمل اسم "الصفحة المقصودة" والأخرى زرقاء تحمل اسم "التفاصيل"، وتتحركان من خلال تمرير الدالة المركّبة "التفاصيل" فوق الدالة المركّبة "الصفحة المقصودة".
الشكل 12: التحريك بين الوجهات

لإضافة تأثيرات حركية إلى الانتقالات بين الوجهات عند استخدام Navigation 3، اضبط التأثيرات الحركية التلقائية لجميع الوجهات باستخدام المَعلمات transitionSpec وpopTransitionSpec وpredictivePopTransitionSpec في NavDisplay. لتجاوزها لوجهة واحدة، أضِف البيانات الوصفية NavDisplay.TransitionKey وNavDisplay.PopTransitionKey وNavDisplay.PredictivePopTransitionKey إلى إدخالها:

data object Landing

data class Detail(val photoIndex: Int)

@Preview
@Composable
fun AnimateBetweenComposableDestinations() {
    // To keep the back stack across configuration changes, use rememberNavBackStack instead.
    val backStack = remember { mutableStateListOf<Any>(Landing) }
    NavDisplay(
        backStack = backStack,
        onBack = { backStack.removeLastOrNull() },
        // Default transitions for every destination: no animation.
        transitionSpec = { EnterTransition.None togetherWith ExitTransition.None },
        popTransitionSpec = { EnterTransition.None togetherWith ExitTransition.None },
        predictivePopTransitionSpec = { EnterTransition.None togetherWith ExitTransition.None },
        entryProvider = entryProvider {
            entry<Landing> {
                ScreenLanding(
                    // ...
                )
            }
            entry<Detail>(
                // Override the transitions for this destination.
                metadata = metadata {
                    put(NavDisplay.TransitionKey) {
                        fadeIn(
                            animationSpec = tween(
                                300, easing = LinearEasing
                            )
                        ) + slideIntoContainer(
                            animationSpec = tween(300, easing = EaseIn),
                            towards = AnimatedContentTransitionScope.SlideDirection.Start
                        ) togetherWith ExitTransition.KeepUntilTransitionsFinished
                    }
                    put(NavDisplay.PopTransitionKey) {
                        EnterTransition.None togetherWith fadeOut(
                            animationSpec = tween(
                                300, easing = LinearEasing
                            )
                        ) + slideOutOfContainer(
                            animationSpec = tween(300, easing = EaseOut),
                            towards = AnimatedContentTransitionScope.SlideDirection.End
                        )
                    }
                    put(NavDisplay.PredictivePopTransitionKey) {
                        EnterTransition.None togetherWith fadeOut(
                            animationSpec = tween(
                                300, easing = LinearEasing
                            )
                        ) + slideOutOfContainer(
                            animationSpec = tween(300, easing = EaseOut),
                            towards = AnimatedContentTransitionScope.SlideDirection.End
                        )
                    }
                }
            ) { detail ->
                ScreenDetails(
                    // ...
                )
            }
        }
    )
}

هناك العديد من أنواع تأثيرات الانتقال المختلفة التي تنطبق على المحتوى الوارد والصادر، ويمكنك الاطّلاع على المستندات لمزيد من المعلومات. لمزيد من المعلومات حول إضافة حركة إلى الوجهات، بما في ذلك إيماءة إظهار شاشة الرجوع، يُرجى الاطّلاع على إضافة حركة بين الوجهات.

تكرار صورة متحركة

خلفية خضراء تتحول إلى خلفية زرقاء بشكل لا نهائي من خلال الانتقال بين اللونين.
الشكل 13: لون الخلفية يتحرك بين قيمتين بشكل لا نهائي

استخدِم rememberInfiniteTransition مع infiniteRepeatable animationSpec لتكرار الحركة باستمرار. غيِّر RepeatMode لتحديد كيفية تحرّك الكائن ذهابًا وإيابًا.

استخدِم repeatable لتكرار عدد محدّد من المرات.

val infiniteTransition = rememberInfiniteTransition(label = "infinite")
val color by infiniteTransition.animateColor(
    initialValue = Color.Green,
    targetValue = Color.Blue,
    animationSpec = infiniteRepeatable(
        animation = tween(1000, easing = LinearEasing),
        repeatMode = RepeatMode.Reverse
    ),
    label = "color"
)
Column(
    modifier = Modifier.drawBehind {
        drawRect(color)
    }
) {
    // your composable here
}

بدء صورة متحركة عند تشغيل دالة مركّبة

يتم تشغيل LaunchedEffect عندما تدخل دالة مركّبة إلى التركيب. يبدأ هذا التأثير حركة عند تشغيل دالة مركّبة، ويمكنك استخدامه لتغيير حالة الحركة. استخدام Animatable مع طريقة animateTo لبدء الرسوم المتحركة عند التشغيل:

val alphaAnimation = remember {
    Animatable(0f)
}
LaunchedEffect(Unit) {
    alphaAnimation.animateTo(1f)
}
Box(
    modifier = Modifier.graphicsLayer {
        alpha = alphaAnimation.value
    }
)

إنشاء صور متحركة متسلسلة

أربع دوائر مع أسهم خضراء متحركة بين كل منها، تتحرك واحدة تلو الأخرى.
الشكل 14: مخطّط بياني يوضّح كيفية تقدّم الرسوم المتحركة المتسلسلة، واحدة تلو الأخرى.

استخدِم واجهات برمجة التطبيقات Animatable coroutine لتنفيذ صور متحركة متسلسلة أو متزامنة. يؤدي استدعاء animateTo على Animatable واحدًا تلو الآخر إلى انتظار كل حركة حتى تنتهي الحركات السابقة قبل المتابعة. وذلك لأنّها دالة تعليق.

val alphaAnimation = remember { Animatable(0f) }
val yAnimation = remember { Animatable(0f) }

LaunchedEffect("animationKey") {
    alphaAnimation.animateTo(1f)
    yAnimation.animateTo(100f)
    yAnimation.animateTo(500f, animationSpec = tween(100))
}

إنشاء صور متحركة متزامنة

ثلاث دوائر مع أسهم خضراء تتحرك نحو كل منها، وتتحرك جميعها معًا في الوقت نفسه.
الشكل 15: مخطّط يوضّح كيفية تقدّم الصور المتحركة المتزامنة، كلّها في الوقت نفسه

استخدِم واجهات برمجة التطبيقات الخاصة بالروتين المشترك (Animatable#animateTo() أو animate) أو واجهة برمجة التطبيقات Transition لإنشاء صور متحركة متزامنة. إذا كنت تستخدم دوال تشغيل متعددة في سياق الكوروتين، فسيتم تشغيل الرسوم المتحركة في نفس الوقت:

val alphaAnimation = remember { Animatable(0f) }
val yAnimation = remember { Animatable(0f) }

LaunchedEffect("animationKey") {
    launch {
        alphaAnimation.animateTo(1f)
    }
    launch {
        yAnimation.animateTo(100f)
    }
}

يمكنك استخدام واجهة برمجة التطبيقات updateTransition لاستخدام الحالة نفسها لتشغيل العديد من الصور المتحركة المختلفة للسمات في الوقت نفسه. يوضّح المثال التالي كيفية تحريك خاصيتين يتم التحكّم فيهما من خلال تغيير الحالة، وهما rect وborderWidth:

var currentState by remember { mutableStateOf(BoxState.Collapsed) }
val transition = updateTransition(currentState, label = "transition")

val rect by transition.animateRect(label = "rect") { state ->
    when (state) {
        BoxState.Collapsed -> Rect(0f, 0f, 100f, 100f)
        BoxState.Expanded -> Rect(100f, 100f, 300f, 300f)
    }
}
val borderWidth by transition.animateDp(label = "borderWidth") { state ->
    when (state) {
        BoxState.Collapsed -> 1.dp
        BoxState.Expanded -> 0.dp
    }
}

تحسين أداء الصور المتحركة

يمكن أن تتسبب الصور المتحركة في Compose في حدوث مشاكل في الأداء. ويرجع ذلك إلى طبيعة الرسوم المتحركة: فهي عبارة عن وحدات بكسل تتحرك أو تتغيّر على الشاشة بسرعة، إطارًا تلو الآخر، لإنشاء وهم الحركة.

ضَع في اعتبارك المراحل المختلفة من Compose: الإنشاء والتنسيق والرسم. إذا غيّرت الصورة المتحركة مرحلة التنسيق، يتطلب ذلك إعادة تنسيق وإعادة رسم جميع العناصر المركّبة المتأثرة. إذا حدثت الحركة في مرحلة الرسم، فإنّها تكون أكثر كفاءة من تشغيل الحركة في مرحلة التخطيط، لأنّها ستتطلّب عملاً أقل بشكل عام.

لضمان أن يؤدي تطبيقك أقل قدر ممكن من المهام أثناء عرض الصور المتحركة، اختَر إصدار lambda من Modifier حيثما أمكن. يؤدي ذلك إلى تخطّي إعادة الإنشاء وتنفيذ الحركة خارج مرحلة الإنشاء، وإلا يمكنك استخدام Modifier.graphicsLayer{ }، لأنّ هذا المُعدِّل يتم تشغيله دائمًا في مرحلة الرسم. لمزيد من المعلومات حول هذا الموضوع، يُرجى الاطّلاع على قسم تأجيل عمليات القراءة في مستندات الأداء.

تغيير توقيت الصور المتحركة

يستخدم Compose تلقائيًا حركات ارتدادية لمعظم الحركات. تُعدّ الرسوم المتحركة المستنِدة إلى الفيزياء أكثر واقعية. ويمكن أيضًا مقاطعتها لأنّها تأخذ في الاعتبار السرعة الحالية للعنصر بدلاً من الوقت الثابت. إذا أردت إلغاء الإعداد التلقائي، فإنّ جميع واجهات برمجة التطبيقات الخاصة بالحركة التي تم عرضها سابقًا تتيح لك ضبط animationSpec لتخصيص كيفية تشغيل الحركة، سواء كنت تريد تنفيذها على مدار مدة معيّنة أو أن تكون أكثر ارتدادًا.

في ما يلي ملخّص لخيارات animationSpec المختلفة:

  • spring: صور متحركة مستنِدة إلى الفيزياء، وهي الإعداد التلقائي لجميع الصور المتحركة. يمكنك تغيير الصلابة أو نسبة التخميد للحصول على مظهر وأسلوب مختلفَين للحركة.
  • tween (اختصار لـ between): هي صور متحركة مستندة إلى المدة، وتتحرك بين قيمتَين باستخدام دالة Easing.
  • ‫keyframes: مواصفات لتحديد القيم في نقاط رئيسية معيّنة في الصور المتحركة
  • repeatable: مواصفات مستندة إلى المدة يتم تشغيلها لعدد معيّن من المرات، يتم تحديده من خلال RepeatMode.
  • ‫infiniteRepeatable: مواصفات مستندة إلى المدة يتم تشغيلها إلى الأبد.
  • snap: ينتقل على الفور إلى القيمة النهائية بدون أي حركة.
صورتان متحركتان توضحان عدم ضبط مواصفات مقابل ضبط مواصفات Spring مخصصة.
الشكل 16: مجموعة المواصفات غير المحدّدة مقابل مجموعة المواصفات المخصّصة لـ Spring

يمكنك قراءة المستندات الكاملة لمزيد من المعلومات حول animationSpecs.

مراجع إضافية

للاطّلاع على المزيد من الأمثلة على الصور المتحركة الممتعة في Compose، يمكنك الاطّلاع على ما يلي: