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

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

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

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

الشكل 1. مثال على شريحة عنوان ذات نمط تلقائي وشريحة عنوان ثابتة في Glimmer من Jetpack Compose تحتوي كل شريحة عنوان على تصنيف (1) ورمز أو كيان اختياري في المقدّمة (2).

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

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

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

Example: Create a title chip with a card

To use a title chip with another component, place the title chip TitleChipDefaults.associatedContentSpacing above the other component in the composable. The following code creates a title chip with a card:

@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")
        }
    }
}

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

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