Chips de título no Glimmer do Jetpack Compose

Dispositivos XR relevantes
Estas orientações ajudam você a criar experiências para esses tipos de dispositivos XR.
Óculos de exibição

No Glimmer do Jetpack Compose, o componente TitleChip não é interativo e fornece um breve contexto ou rótulo para o conteúdo associado, como um Card ou um GlimmerLazyColumn.

Use ícones de título para informações concisas, como um título curto, um nome de categoria ou um indicador de status. Normalmente, os ícones de título devem ser colocados acima do conteúdo que descrevem para estabelecer uma relação estrutural clara.

Figura 1. Exemplo de um ícone de título de estilo padrão e um ícone de título fixo no Jetpack Compose Glimmer. Cada ícone de título tem um rótulo (1) e um ícone ou entidade principal opcional (2).

Exemplo básico: criar um ícone de título curto

O código a seguir cria um ícone de título básico:

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

Exemplo básico: criar um ícone de título com um ícone

O código a seguir cria um ícone de título com um ícone:

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

Exemplo: criar um ícone de título com um card

Para usar um ícone de título com outro componente, coloque o ícone de título TitleChipDefaults.associatedContentSpacing acima do outro componente no combinável. O código a seguir cria um ícone de título com um 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")
        }
    }
}

Pontos principais sobre o código

  • O ícone de título é centralizado horizontalmente, que é o alinhamento comum para um ícone de título colocado acima de um card.
  • O Spacer tem uma altura fixa para fornecer a quantidade certa de espaçamento vertical entre os dois componentes. Isso é definido usando TitleChipDefaults.associatedContentSpacing.
  • Usa um leadingIcon opcional para adicionar mais contexto visual antes do conteúdo de texto.
  • O ícone de título usa automaticamente o estilo caption para o texto.
  • O ícone de título não é interativo. Se você precisar de um rótulo clicável, use um Button ou outro componente interativo.