شرائح العناوين في Glimmer من Jetpack Compose

أجهزة XR المشمولة

تساعدك هذه الإرشادات في إنشاء تجارب لهذه الأنواع من أجهزة XR.

مزيد من المعلومات حول أنواع أجهزة XR →

مزيد من المعلومات حول أنواع أجهزة XR →

في Jetpack Compose Glimmer، المكوّن TitleChip هو مكوّن غير تفاعلي يوفّر سياقًا موجزًا أو تصنيفًا للمحتوى المرتبط، مثل Card أو VerticalList.

استخدِم شرائح العناوين لعرض معلومات موجزة، مثل عنوان قصير أو اسم فئة أو مؤشر حالة. عادةً، يجب وضع شرائح العناوين فوق المحتوى الذي تصفه لتحديد علاقة هيكلية واضحة.

مثال أساسي: إنشاء شريحة لعنوان قصير

تنشئ التعليمة البرمجية التالية شريحة عنوان أساسية:

@Composable
fun BasicTitleChipSample() {
    TitleChip { Text("Messages") }
}
TitleChipSample.kt

مثال أساسي: إنشاء شريحة عنوان تتضمّن رمزًا

تنشئ التعليمة البرمجية التالية شريحة عنوان تتضمّن رمزًا:

@Composable
fun TitleChipWithIconSample() {
    TitleChip {
        Icon(FavoriteIcon, contentDescription = "Favorite")
        Text("Favorites")
    }
}
TitleChipSample.kt

مثال: إنشاء شريحة عنوان مع بطاقة

لاستخدام شريحة العنوان مع مكوّن آخر، ضَع شريحة العنوان TitleChipDefaults.associatedContentSpacing فوق المكوّن الآخر في الدالة البرمجية المركّبة. تنشئ التعليمة البرمجية التالية شريحة عنوان مع بطاقة:

@Composable
fun TitleChipWithCardSample() {
    Column(horizontalAlignment = Alignment.CenterHorizontally) {
        TitleChip { Text("Title Chip") }

        Spacer(Modifier.height(TitleChipDefaults.associatedContentSpacing))

        Card(
            title = { Text("Title") },
            subtitle = { Text("Subtitle") },
            leadingIcon = { Icon(FavoriteIcon, "Localized description") },
        ) {
            Text("Card Content")
        }
    }
}
TitleChipSample.kt

نقاط أساسية حول الرمز

• يتم توسيط شريحة العنوان أفقيًا، وهو المحاذاة المعتادة لشريحة العنوان الموضوعة فوق بطاقة.
• يتميّز Spacer بارتفاع ثابت لتوفير المقدار المناسب من المسافة العمودية بين المكوّنين. يتم تحديد ذلك باستخدام TitleChipDefaults.associatedContentSpacing.
• يستخدم leadingIcon اختياريًا لإضافة سياق مرئي إضافي قبل المحتوى النصي.
• تستخدم شريحة العنوان تلقائيًا نمط caption للنص.
• شريحة العنوان غير تفاعلية. إذا كنت بحاجة إلى تصنيف قابل للنقر، استخدِم Button أو مكوّنًا تفاعليًا آخر.