ชิปชื่อใน Glimmer ของ Jetpack Compose

อุปกรณ์ XR ที่รองรับ
คำแนะนำนี้จะช่วยคุณสร้างประสบการณ์การใช้งานสำหรับอุปกรณ์ XR ประเภทนี้
แว่นตาที่มีจอแสดงผล

ใน Jetpack Compose Glimmer คอมโพเนนต์ TitleChip เป็นคอมโพเนนต์ที่ไม่มีการโต้ตอบซึ่งให้บริบทหรือป้ายกำกับสั้นๆ สำหรับเนื้อหาที่เกี่ยวข้อง เช่น Card หรือ GlimmerLazyColumn

ใช้ชิปชื่อเพื่อแสดงข้อมูลที่กระชับ เช่น ชื่อย่อ ชื่อหมวดหมู่ หรือตัวบ่งชี้สถานะ โดยปกติแล้ว คุณควรวางชิปชื่อไว้เหนือเนื้อหาที่อธิบายเพื่อสร้างความสัมพันธ์เชิงโครงสร้างที่ชัดเจน

รูปที่ 1 ตัวอย่างชิปชื่อสไตล์เริ่มต้นและชิปชื่อแบบติดหนึบใน Jetpack Compose Glimmer ชิปชื่อแต่ละรายการจะมีป้ายกำกับ (1) และไอคอนหรือเอนทิตีนำหน้า (2) ซึ่งไม่บังคับ

ตัวอย่างพื้นฐาน: สร้างชิปชื่อย่อ

โค้ดต่อไปนี้จะสร้างชิปชื่อพื้นฐาน

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

ตัวอย่างพื้นฐาน: สร้างชิปชื่อที่มีไอคอน

โค้ดต่อไปนี้จะสร้างชิปชื่อที่มีไอคอน

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

ตัวอย่าง: สร้างชิปชื่อด้วยการ์ด

หากต้องการใช้ชิปชื่อร่วมกับคอมโพเนนต์อื่น ให้วางชิปชื่อ TitleChipDefaults.associatedContentSpacing ไว้เหนือคอมโพเนนต์อื่นใน Composable โค้ดต่อไปนี้จะสร้างชิปชื่อที่มีการ์ด

@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 มีความสูงคงที่เพื่อให้มีระยะห่างแนวตั้งที่เหมาะสมระหว่างคอมโพเนนต์ทั้ง 2 รายการ ซึ่งกำหนดโดยใช้ TitleChipDefaults.associatedContentSpacing
  • ใช้ leadingIcon ที่ไม่บังคับเพื่อเพิ่มบริบทภาพเพิ่มเติมก่อนเนื้อหาข้อความ
  • ชิปชื่อจะใช้รูปแบบ caption สำหรับข้อความโดยอัตโนมัติ
  • ชิปชื่อเป็นแบบอินเทอร์แอกทีฟไม่ได้ หากต้องการป้ายกำกับที่คลิกได้ ให้ใช้ Button หรือคอมโพเนนต์แบบอินเทอร์แอกทีฟอื่นๆ