أشرطة التطبيقات

أشرطة التطبيقات هي حاويات تتيح للمستخدم الوصول إلى الميزات الرئيسية وعناصر التنقل. هناك نوعان من أشرطة التطبيقات، أشرطة التطبيقات العلوية وأشرطة التطبيقات السفلية. وفي ما يلي مظهر كل منها والغرض منه:

النوع

المظهر

الغرض

شريط التطبيق العلوي

في أعلى الشاشة

تتيح الوصول إلى المهام والمعلومات الرئيسية. يستضيف بشكل عام عنوانًا وبنود عمل أساسية وبعض عناصر التنقّل.

شريط التطبيق السفلي

في أسفل الشاشة

يتضمّن عادةً عناصر التنقّل الأساسية. وقد يوفّر أيضًا إمكانية الوصول إلى إجراءات رئيسية أخرى، مثل زر الإجراء الرئيسي المضمَّن.

مثال على شريط التطبيق العلوي والسفلي.
الشكل 1. شريط التطبيق العلوي (يمين) وشريط التطبيق السفلي (يسار)

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

أشرطة التطبيقات العلوية

يوضّح الجدول التالي الأنواع الأربعة لأشرطة التطبيقات العلوية:

النوع

مثال

صغير: للشاشات التي لا تتطلّب الكثير من التنقّل أو الإجراءات

شريط التطبيق العلوي الصغير

محاذاة للوسط: للشاشات التي تتضمّن إجراءً رئيسيًا واحدًا

شريط التطبيق العلوي بمحاذاة للوسط

متوسط: للشاشات التي تتطلّب قدرًا متوسطًا من التنقّل والإجراءات.

شريط التطبيق العلوي المتوسط

كبير: للشاشات التي تتطلّب الكثير من التنقّل والإجراءات

شريط التطبيق العلوي الكبير

مساحة عرض واجهة برمجة التطبيقات

تتشابه الدوال المركّبة المختلفة التي تتيح لك تنفيذ أشرطة التطبيقات العلوية الأربعة المختلفة إلى حد كبير. وتتشارك هذه العناصر في عدة مَعلمات رئيسية:

  • ‫title: النص الذي يظهر في شريط التطبيق
  • ‫navigationIcon: الرمز الأساسي للتنقّل يظهر على يسار شريط التطبيق.
  • actions: رموز تتيح للمستخدم الوصول إلى الإجراءات الرئيسية وتظهر على يمين شريط التطبيق.
  • ‫scrollBehavior: تحدّد هذه السمة كيفية استجابة شريط التطبيق العلوي للتمرير في المحتوى الداخلي للإطار.
  • ‫colors: يحدّد هذا الإعداد كيفية ظهور شريط التطبيق.

سلوك الانتقال

يمكنك التحكّم في كيفية استجابة شريط التطبيق عندما ينتقل المستخدم للأسفل أو للأعلى في المحتوى الداخلي للسقالة المحدّدة. لإجراء ذلك، أنشئ مثيلاً من TopAppBarScrollBehavior ومرِّره إلى شريط التطبيقات العلوي للمَعلمة scrollBehavior.

هناك ثلاثة أنواع من TopAppBarScrollBehavior. وهي على النحو التالي:

  • ‫enterAlwaysScrollBehavior: عندما يسحب المستخدم المحتوى الداخلي للسقالة للأعلى، يتم تصغير شريط التطبيق العلوي. يتسع شريط التطبيق عندما يبدأ المستخدم في سحب المحتوى الداخلي لأسفل.
  • exitUntilCollapsedScrollBehavior: يشبه enterAlwaysScrollBehavior، إلا أنّ شريط التطبيق لا يتوسّع إلا عندما يسحب المستخدم المحتوى إلى الأسفل بالكامل.
  • pinnedScrollBehavior: يظل شريط التطبيق في مكانه ولا يتفاعل مع التمرير.

تنفّذ الأمثلة التالية العديد من هذه الخيارات.

أمثلة

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

صغير

لإنشاء شريط تطبيقات علوي صغير، استخدِم الدالة المركّبة TopAppBar. ينفّذ المثال التالي شريط تطبيق علويًا أساسيًا يحتوي على عنوان فقط.

لا يمرّر المثال التالي قيمة TopAppBar لـ scrollBehavior، وبالتالي لا يتفاعل مع الانتقال في المحتوى الداخلي.

@Composable
fun SmallTopAppBarExample() {
    Scaffold(
        topBar = {
            TopAppBar(
                colors = TopAppBarDefaults.topAppBarColors(
                    containerColor = MaterialTheme.colorScheme.primaryContainer,
                    titleContentColor = MaterialTheme.colorScheme.primary,
                ),
                title = {
                    Text("Small Top App Bar")
                }
            )
        },
    ) { innerPadding ->
        ScrollContent(innerPadding)
    }
}

يظهر هذا التنفيذ على النحو التالي:

الشكل 2. شريط تطبيق علوي صغير

محاذاة للوسط

شريط التطبيق العلوي المحاذي للوسط هو نفسه شريط التطبيق الصغير، على الرغم من أن العنوان يتوسط المكون. لتنفيذها، استخدِم الدالة المركّبة المخصّصة CenterAlignedTopAppBar.

يستخدم هذا المثال enterAlwaysScrollBehavior() للحصول على القيمة التي يمررها لـ scrollBehavior. وبالتالي، يتم تصغير الشريط عندما ينتقل المستخدم إلى المحتوى الداخلي للإطار.

@Composable
fun CenterAlignedTopAppBarExample() {
    val scrollBehavior = TopAppBarDefaults.pinnedScrollBehavior(rememberTopAppBarState())

    Scaffold(
        modifier = Modifier.nestedScroll(scrollBehavior.nestedScrollConnection),

        topBar = {
            CenterAlignedTopAppBar(
                colors = TopAppBarDefaults.topAppBarColors(
                    containerColor = MaterialTheme.colorScheme.primaryContainer,
                    titleContentColor = MaterialTheme.colorScheme.primary,
                ),
                title = {
                    Text(
                        "Centered Top App Bar",
                        maxLines = 1,
                        overflow = TextOverflow.Ellipsis
                    )
                },
                navigationIcon = {
                    IconButton(onClick = { /* do something */ }) {
                        Icon(
                            painter = rememberVectorPainter(AppIcons.ArrowBack),
                            contentDescription = "Localized description"
                        )
                    }
                },
                actions = {
                    IconButton(onClick = { /* do something */ }) {
                        Icon(
                            painter = rememberVectorPainter(AppIcons.Menu),
                            contentDescription = "Localized description"
                        )
                    }
                },
                scrollBehavior = scrollBehavior,
            )
        },
    ) { innerPadding ->
        ScrollContent(innerPadding)
    }
}

يظهر هذا التنفيذ على النحو التالي:

الشكل 3. شريط تطبيقات علوي محاذاته للوسط

متوسط

يضع شريط التطبيق العلوي المتوسط العنوان أسفل أي أيقونات إضافية. لإنشاء واحد، استخدِم الدالة البرمجية المركّبة MediumTopAppBar.

مثل المقتطف السابق، يستخدم هذا المثال enterAlwaysScrollBehavior() للحصول على القيمة التي يمررها لـ scrollBehavior.

@Composable
fun MediumTopAppBarExample() {
    val scrollBehavior = TopAppBarDefaults.enterAlwaysScrollBehavior(rememberTopAppBarState())

    Scaffold(
        modifier = Modifier.nestedScroll(scrollBehavior.nestedScrollConnection),
        topBar = {
            MediumTopAppBar(
                colors = TopAppBarDefaults.topAppBarColors(
                    containerColor = MaterialTheme.colorScheme.primaryContainer,
                    titleContentColor = MaterialTheme.colorScheme.primary,
                ),
                title = {
                    Text(
                        "Medium Top App Bar",
                        maxLines = 1,
                        overflow = TextOverflow.Ellipsis
                    )
                },
                navigationIcon = {
                    IconButton(onClick = { /* do something */ }) {
                        Icon(
                            painter = rememberVectorPainter(AppIcons.ArrowBack),
                            contentDescription = "Localized description"
                        )
                    }
                },
                actions = {
                    IconButton(onClick = { /* do something */ }) {
                        Icon(
                            painter = rememberVectorPainter(AppIcons.Menu),
                            contentDescription = "Localized description"
                        )
                    }
                },
                scrollBehavior = scrollBehavior
            )
        },
    ) { innerPadding ->
        ScrollContent(innerPadding)
    }
}

يظهر هذا التنفيذ على النحو التالي، مع عرض توضيحي لكيفية ظهور سلوك الانتقال من enterAlwaysScrollBehavior():

الشكل 4. شريط تطبيقات علوي متوسط الحجم يتم تصغيره عندما ينتقل المستخدم للأعلى وتوسيعه عندما ينتقل للأسفل

كبير

يشبه شريط التطبيق العلوي الكبير الشريط المتوسط، إلا أنّ المساحة المتروكة بين العنوان والرموز تكون أكبر ويشغل مساحة أكبر على الشاشة بشكل عام. لإنشاء واحد، استخدِم الدالة المركّبة LargeTopAppBar.

على عكس المقتطفات السابقة، يستخدم هذا المثال exitUntilCollapsedScrollBehavior() للحصول على القيمة التي يمررها scrollBehavior. وبالتالي، يتم تصغير الشريط عندما ينتقل المستخدم إلى المحتوى الداخلي في Scaffold، ولكن يتم توسيعه بعد ذلك عندما ينتقل المستخدم إلى نهاية المحتوى الداخلي.

@Composable
fun LargeTopAppBarExample() {
    val scrollBehavior = TopAppBarDefaults.exitUntilCollapsedScrollBehavior(rememberTopAppBarState())

    Scaffold(
        modifier = Modifier.nestedScroll(scrollBehavior.nestedScrollConnection),
        topBar = {
            LargeTopAppBar(
                colors = TopAppBarDefaults.topAppBarColors(
                    containerColor = MaterialTheme.colorScheme.primaryContainer,
                    titleContentColor = MaterialTheme.colorScheme.primary,
                ),
                title = {
                    Text(
                        "Large Top App Bar",
                        maxLines = 1,
                        overflow = TextOverflow.Ellipsis
                    )
                },
                navigationIcon = {
                    IconButton(onClick = { /* do something */ }) {
                        Icon(
                            painter = rememberVectorPainter(AppIcons.ArrowBack),
                            contentDescription = "Localized description"
                        )
                    }
                },
                actions = {
                    IconButton(onClick = { /* do something */ }) {
                        Icon(
                            painter = rememberVectorPainter(AppIcons.Menu),
                            contentDescription = "Localized description"
                        )
                    }
                },
                scrollBehavior = scrollBehavior
            )
        },
    ) { innerPadding ->
        ScrollContent(innerPadding)
    }
}

يظهر هذا التنفيذ على النحو التالي:

الشكل 5. مثال على تنفيذ شريط تطبيقات علوي كبير

تحديث M3 Expressive

يأتي شريطا التطبيقات الجديدان المتوسط المرن والكبير المرن مع تحسينات كبيرة، مثل الارتفاعات المرنة، ودعم الأسطر المتعددة، والنص الموسط. ويمكن أن تحتوي أيضًا على مجموعة متنوعة من العناصر، مثل الصور. يُنصح باستخدام أشرطة التطبيقات المرنة المتوسطة والكبيرة بدلاً من أشرطة التطبيقات المتوسطة والكبيرة. تم تعديل شريط التطبيقات الصغير ليشمل التحسينات المرنة نفسها.

أشرطة التطبيقات العلوية ذات الأنماط التعبيرية
الشكل 6: أشكال شريط التطبيقات العلوي في M3 Expressive

لمزيد من المعلومات حول تعديلات M3 Expressive لأشرطة التطبيقات، يُرجى الاطّلاع على إرشادات أشرطة التطبيقات في التصميم المتعدد الأبعاد 3.

محاذاة للوسط واليسار

صغير شريط التطبيقات العلوي بمحاذاة في الوسط مع عنوان فرعي بالمظهر الفاتح
شريط التطبيق العلوي بالمظهر الداكن
متوسط شريط تطبيقات علوي متوسط الحجم بمحاذاة في الوسط ومظهر فاتح مع عنوان فرعي
شريط التطبيق العلوي المتوسط بالمظهر الداكن
كبير شريط تطبيقات علوي كبير بمظهر فاتح ومحاذاة إلى الوسط مع عنوان فرعي
شريط التطبيقات العلوي الكبير بالمظهر الداكن

يمكن محاذاة العناوين الرئيسية الصغيرة والمتوسطة المرنة والكبيرة المرنة مع الحافة الأمامية أو توسيطها.

يوضّح المقتطف التالي كيفية تنفيذ شريط تطبيق علوي محاذٍ للوسط مع عنوان فرعي:

@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun SimpleCenterAlignedTopAppBarWithSubtitle() {
    val scrollBehavior = TopAppBarDefaults.pinnedScrollBehavior()
    Scaffold(
        modifier = Modifier.nestedScroll(scrollBehavior.nestedScrollConnection),
        topBar = {
            TopAppBar(
                title = { Text("Simple TopAppBar", maxLines = 1, overflow = TextOverflow.Ellipsis) },
                subtitle = { Text("Subtitle", maxLines = 1, overflow = TextOverflow.Ellipsis) },
                titleHorizontalAlignment = Alignment.CenterHorizontally,
                navigationIcon = {
                    IconButton(onClick = { /* onBackClick() */ }) {
                        Icon(
                            painter = rememberVectorPainter(AppIcons.ArrowBack),
                            contentDescription = "Localized description",
                        )
                    }
                },
                actions = {
                    IconButton(onClick = { /* doSomething() */ }) {
                        Icon(painter = rememberVectorPainter(AppIcons.Favorite), contentDescription = "Localized description")
                    }
                },
                scrollBehavior = scrollBehavior,
            )
        },
        content = { innerPadding ->
            // ...
        },
    )
}

سلوك الانتقال

الدخول دائمًا

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

يوضّح المقتطف التالي كيفية تنفيذ شريط تطبيق علوي يتضمّن سلوك التنقّل enter-always:

@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun EnterAlwaysTopAppBar() {
    val scrollBehavior = TopAppBarDefaults.enterAlwaysScrollBehavior()
    Scaffold(
        modifier = Modifier.nestedScroll(scrollBehavior.nestedScrollConnection),
        topBar = {
            TopAppBar(
                title = { Text("TopAppBar", maxLines = 1, overflow = TextOverflow.Ellipsis) },
                subtitle = { Text("Subtitle", maxLines = 1, overflow = TextOverflow.Ellipsis) },
                navigationIcon = {
                    IconButton(onClick = { /* onBackClick() */ }) {
                        Icon(
                            painter = rememberVectorPainter(AppIcons.ArrowBack),
                            contentDescription = "Localized description",
                        )
                    }
                },
                actions = {
                    IconButton(onClick = { /* doSomething() */ }) {
                        Icon(painter = rememberVectorPainter(AppIcons.Favorite), contentDescription = "Localized description")
                    }
                },
                scrollBehavior = scrollBehavior,
            )
        },
        content = { innerPadding ->
            // ...
        },
    )
}

يعرض الفيديو التالي نتيجة المقتطف السابق:

الشكل 7. شريط تطبيقات علوي يتضمّن سلوك التمرير "الدخول دائمًا"، ويتم تصغيره عندما ينتقل المستخدم للأسفل وتوسيعه عندما ينتقل للأعلى

الخروج حتى التصغير

عندما ينتقل المستخدم للأسفل في المحتوى (سحب المحتوى للأعلى)، يتم تصغير أشرطة التطبيقات المرنة المتوسطة والكبيرة حتى يظل شريط التطبيقات المصغّر فقط مرئيًا. عندما ينتقل المستخدم للأعلى (سحب المحتوى للأسفل)، يظل شريط التطبيق مصغّرًا حتى يصل المستخدم إلى أعلى المحتوى، وعندها يتوسّع شريط التطبيق مرة أخرى إلى ارتفاعه الكامل، ويتوسّط مع العنوان الفرعي.

مرونة متوسطة

يوضّح المقتطف التالي كيفية تنفيذ شريط تطبيقات علوي مرن متوسط الحجم مع سلوك التمرير "الخروج حتى التصغير":

@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun ExitUntilCollapsedCenterAlignedMediumFlexibleTopAppBar() {
    val scrollBehavior = TopAppBarDefaults.exitUntilCollapsedScrollBehavior()
    Scaffold(
        modifier = Modifier.nestedScroll(scrollBehavior.nestedScrollConnection),
        topBar = {
            MediumFlexibleTopAppBar(
                title = { Text("Medium TopAppBar", maxLines = 1, overflow = TextOverflow.Ellipsis) },
                subtitle = { Text("Subtitle", maxLines = 1, overflow = TextOverflow.Ellipsis) },
                titleHorizontalAlignment = Alignment.CenterHorizontally,
                navigationIcon = {
                    IconButton(onClick = { /* onBackClick() */ }) {
                        Icon(
                            painter = rememberVectorPainter(AppIcons.ArrowBack),
                            contentDescription = "Localized description",
                        )
                    }
                },
                actions = {
                    IconButton(onClick = { /* doSomething() */ }) {
                        Icon(painter = rememberVectorPainter(AppIcons.Favorite), contentDescription = "Localized description")
                    }
                },
                scrollBehavior = scrollBehavior,
            )
        },
        content = { innerPadding ->
            // ...
        },
    )
}

يعرض الفيديو التالي نتيجة المقتطف السابق:

الشكل 8: شريط تطبيقات علوي متوسط الحجم ومحاذاته في الوسط، ويتم تصغيره عندما ينتقل المستخدم للأسفل.

مرن كبير

يوضّح المقتطف التالي كيفية تنفيذ شريط تطبيقات علوي كبير ومرن مع سلوك التمرير "الخروج حتى التصغير":

@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun ExitUntilCollapsedCenterAlignedLargeFlexibleTopAppBar() {
    val scrollBehavior = TopAppBarDefaults.exitUntilCollapsedScrollBehavior()
    Scaffold(
        modifier = Modifier.nestedScroll(scrollBehavior.nestedScrollConnection),
        topBar = {
            LargeFlexibleTopAppBar(
                title = { Text("Large TopAppBar", maxLines = 1, overflow = TextOverflow.Ellipsis) },
                subtitle = { Text("Subtitle", maxLines = 1, overflow = TextOverflow.Ellipsis) },
                titleHorizontalAlignment = Alignment.CenterHorizontally,
                navigationIcon = {
                    IconButton(onClick = { /* onBackClick() */ }) {
                        Icon(
                            painter = rememberVectorPainter(AppIcons.ArrowBack),
                            contentDescription = "Localized description",
                        )
                    }
                },
                actions = {
                    IconButton(onClick = { /* doSomething() */ }) {
                        Icon(painter = rememberVectorPainter(AppIcons.Favorite), contentDescription = "Localized description")
                    }
                },
                scrollBehavior = scrollBehavior,
            )
        },
        content = { innerPadding ->
            // ...
        },
    )
}

يعرض الفيديو التالي نتيجة المقتطف السابق:

الشكل 9. شريط تطبيقات علوي كبير ومحاذٍ للوسط يتم تصغيره عندما ينتقل المستخدم للأسفل

شريط التطبيق السفلي

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

  • actions: سلسلة من الرموز التي تظهر على يمين الشريط وهي عادةً إما إجراءات رئيسية للشاشة المحددة أو عناصر تنقّل.
  • ‫floatingActionButton: زر الإجراء الرئيسي الذي يظهر على الجانب الأيمن من الشريط

@Composable
fun BottomAppBarExample() {
    Scaffold(
        bottomBar = {
            BottomAppBar(
                actions = {
                    IconButton(onClick = { /* do something */ }) {
                        Icon(painter = rememberVectorPainter(AppIcons.Check), contentDescription = "Localized description")
                    }
                    IconButton(onClick = { /* do something */ }) {
                        Icon(
                            painter = rememberVectorPainter(AppIcons.Edit),
                            contentDescription = "Localized description",
                        )
                    }
                    IconButton(onClick = { /* do something */ }) {
                        Icon(
                            painter = rememberVectorPainter(AppIcons.Mic),
                            contentDescription = "Localized description",
                        )
                    }
                    IconButton(onClick = { /* do something */ }) {
                        Icon(
                            painter = rememberVectorPainter(AppIcons.Image),
                            contentDescription = "Localized description",
                        )
                    }
                },
                floatingActionButton = {
                    FloatingActionButton(
                        onClick = { /* do something */ },
                        containerColor = BottomAppBarDefaults.bottomAppBarFabColor,
                        elevation = FloatingActionButtonDefaults.bottomAppBarFabElevation()
                    ) {
                        Icon(painter = rememberVectorPainter(AppIcons.Add), "Localized description")
                    }
                }
            )
        },
    ) { innerPadding ->
        Text(
            modifier = Modifier.padding(innerPadding),
            text = "Example of a scaffold with a bottom app bar."
        )
    }
}

يظهر هذا التنفيذ على النحو التالي:

الشكل 10: مثال على تنفيذ شريط التطبيقات السفلي

تحديث M3 Expressive

في Material 3 Expressive، استخدِم شريط الأدوات الثابت (FlexibleBottomAppBar) بدلاً من شريط التطبيق السفلي العادي للحصول على ارتفاع أقصر وترتيب أفقي أكثر مرونة للعناصر.

ينفّذ المقتطف التالي FlexibleBottomAppBar مع AppBarRow ينقل بنود العمل الإضافية إلى قائمة الكاملة عندما تكون المساحة محدودة:

@Composable
fun FlexibleBottomAppBarSample() {
    val icons =
        listOf(
            AppIcons.ArrowBack,
            AppIcons.ArrowForward,
            AppIcons.Add,
            AppIcons.Check,
            AppIcons.Edit,
            AppIcons.Favorite,
        )
    val items = listOf("Back", "Forward", "Add", "Check", "Edit", "Favorite")

    FlexibleBottomAppBar(
        contentPadding = PaddingValues(horizontal = 96.dp),
        horizontalArrangement = BottomAppBarDefaults.FlexibleFixedHorizontalArrangement,
    ) {
        AppBarRow(
            overflowIndicator = { menuState ->
                IconButton(
                    onClick = {
                        if (menuState.isShowing) {
                            menuState.dismiss()
                        } else {
                            menuState.show()
                        }
                    }
                ) {
                    Icon(
                        painter = rememberVectorPainter(AppIcons.MoreVert),
                        contentDescription = "Overflow",
                    )
                }
            }
        ) {
            items.forEachIndexed { index, item ->
                clickableItem(
                    onClick = { /* doSomething() */ },
                    icon = {
                        Icon(
                            painter = rememberVectorPainter(icons[index]),
                            contentDescription = item,
                        )
                    },
                    label = item,
                )
            }
        }
    }
}

مراجع إضافية