Chip
元件是精簡的互動式 UI 元素。代表聯絡人或標記等複雜的實體,通常也會有圖示和標籤。此部分可勾選、可關閉或可點選。
以下是四種類型的方塊及適用位置:
- 輔助:引導使用者完成工作。通常會顯示為暫時性的 UI 元素,以回應使用者輸入的內容。
- 篩選器:讓使用者透過一組選項修正內容。您可以選取或取消選取,該圖示在選取時可能包含勾號圖示。
- 輸入內容:代表使用者提供的資訊,例如選單中的選項。可包含圖示和文字,並提供「X」代表移除。
- 建議:根據使用者最近的活動或輸入內容提供建議。通常會顯示在輸入欄位下方,以提示使用者動作。
API 介面
共有四種可組合元件,會對應至四種類型的方塊。以下各節將詳細說明這些可組合項及其差異。然而,兩者共用下列參數:
label
:方塊上顯示的字串。icon
:方塊開頭顯示的圖示。某些特定的可組合項具有獨立的leadingIcon
和trailingIcon
參數。onClick
:使用者按下方塊時呼叫的 lambda。
輔助方塊
AssistChip
可組合項可讓您輕鬆建立輔助方塊,以特定方向對使用者進行微調。其中一項特色是 leadingIcon
參數,可讓您在方塊左側顯示圖示。以下範例說明如何實作:
@Composable fun AssistChipExample() { AssistChip( onClick = { Log.d("Assist chip", "hello world") }, label = { Text("Assist chip") }, leadingIcon = { Icon( Icons.Filled.Settings, contentDescription = "Localized description", Modifier.size(AssistChipDefaults.IconSize) ) } ) }
實作內容如下所示。
篩選器方塊
使用 FilterChip
可組合項時,您必須追蹤是否已選取方塊。以下範例說明如何在使用者選取方塊時才顯示開頭的核取圖示:
@Composable fun FilterChipExample() { var selected by remember { mutableStateOf(false) } FilterChip( onClick = { selected = !selected }, label = { Text("Filter chip") }, selected = selected, leadingIcon = if (selected) { { Icon( imageVector = Icons.Filled.Done, contentDescription = "Done icon", modifier = Modifier.size(FilterChipDefaults.IconSize) ) } } else { null }, ) }
未選取該實作項目會如下所示:
選取後,如下所示:
輸入方塊
您可以使用 InputChip
可組合項建立由使用者互動產生的方塊。舉例來說,在電子郵件用戶端中,當使用者撰寫電子郵件時,輸入方塊可能代表使用者在「to:」欄位中輸入的地址。
以下實作示範已處於所選狀態的輸入方塊。使用者按下方塊後關閉方塊。
@Composable fun InputChipExample( text: String, onDismiss: () -> Unit, ) { var enabled by remember { mutableStateOf(true) } if (!enabled) return InputChip( onClick = { onDismiss() enabled = !enabled }, label = { Text(text) }, selected = enabled, avatar = { Icon( Icons.Filled.Person, contentDescription = "Localized description", Modifier.size(InputChipDefaults.AvatarSize) ) }, trailingIcon = { Icon( Icons.Default.Close, contentDescription = "Localized description", Modifier.size(InputChipDefaults.AvatarSize) ) }, ) }
實作內容如下所示。
建議方塊
SuggestionChip
可組合項是本頁所列可組合項最基本概念,這在其 API 定義和常見用途中都包含在內。建議方塊會顯示動態產生的提示。舉例來說,在 AI 即時通訊應用程式中,您可以使用建議方塊,顯示最新訊息可能的回覆。
請考慮採用以下 SuggestionChip
實作:
@Composable fun SuggestionChipExample() { SuggestionChip( onClick = { Log.d("Suggestion chip", "hello world") }, label = { Text("Suggestion chip") } ) }
實作內容如下所示:
進階方塊
本文件中的所有範例都使用具備平坦外觀的基本可組合項。如果想設計具有較高外觀的方塊,請從下列三個可組合元件中擇一使用: