Skip to content

ConversationItem

Basic Usage

Slots

Grouping & Sticky Header

Props

PropDescriptionTypeDefault
itemsList of conversation itemsConversationItem[][]
keyNameField name used as unique identifier within itemsstring'key'
activeKey / v-model:activeKeyThe key of the currently active itemstring''
stickyWhether to enable sticky group title headersbooleanfalse
themeTheme mode'dark' | 'light'

Events

EventDescriptionCallback Parameters
update:activeKeyEmitted when the active item changes, used for v-model:activeKey two-way binding(value: string)
activeChangeEmitted when the user clicks to switch the active item(value: string, item: ConversationItem)

Slots

SlotDescriptionSlot Props
itemCustom content for each list item{ item: ConversationItem }
groupCustom content for group title{ groupName: string }

ConversationItem Interface

FieldDescriptionTypeRequired
keyUnique identifier, corresponds to keyNamestringNo
labelDisplay textstringNo
groupGroup name; items with the same value are grouped togetherstringNo
disabledWhether the item is disabledbooleanNo
[key: string]Supports any additional fields, accessible via slotsanyNo