> ## Documentation Index
> Fetch the complete documentation index at: https://cometchat-22654f5b-docs-audit-content-webhooks.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List Item

> List Item — CometChat documentation.

`CometChatListItem` contains one to three lines of text optionally flanked by icons or other widgets, such as `CometChatAvatar`, `CometChatDate` or `Text`. `CometChatAvatar` will always be shown in the leading view therefore either one among the `avatarURL` or `avatarName` must be provided. The icons (or other widgets) for the list item are defined with the `tailView` parameter. The first line of text is optional and is specified with `title`. The value of subtitle is also optional, will occupy the space allocated for an additional line of text or some other widget.

## Methods

| Methods                     | Type                 | Description                                                                    |
| --------------------------- | -------------------- | ------------------------------------------------------------------------------ |
| **setAvatar**               | String               | sets image url to be shown in avatar in the leading view                       |
| **setStatusIndicatorColor** | Color                | sets color of the status indicator                                             |
| **setTitle**                | String               | sets the title to display                                                      |
| **setSubtitleView**         | Widget               | sets custom subtitle below the title                                           |
| **setTailView**             | Widget               | sets the trailing widget, can be a `Text`, `CometChatDate` or `CometChatBadge` |
| **hideSeparator**           | bool                 | used to hide the divider separating the list items                             |
| **setStyle**                | ListItemStyle        | used to customize the appearance of this widget                                |
| **setAvatarStyle**          | AvatarStyle          | used to customise the Avatar shown in the leading view                         |
| **setStatusIndicatorStyle** | StatusIndicatorStyle | used to customise the status indicator                                         |

## ListItemStyle

ListItemStyle is the class containing attributes to customize appearance of this widget.

| Methods                  | Type          | Description                                                    |
| ------------------------ | ------------- | -------------------------------------------------------------- |
| **setTitleAppearance**   | @StyleRes int | used to customise the appearance of the title                  |
| **setSeparatorColor**    | @ColorInt int | used to set the color of the divider separating the list items |
| **setBackground**        | @ColorInt int | used to set the background color                               |
| **setBackground**        | Drawable      | used to set background gradient                                |
| **setBorderWidth**       | int           | used to set border                                             |
| **setCornerRadius**      | float         | used to set border radius                                      |
| **setBorderColor**       | @ColorInt int | used to set border color                                       |
| **setSeparatorDrawable** | Drawable      | used to set separator color                                    |

## Usage

<Tabs>
  <Tab title="XML">
    ```xml theme={null}
    <com.cometchat.chatuikit.shared.views.CometChatListItem.CometChatListItem
            android:id="@+id/list_item"
            android:layout_width="match_parent"
            android:background="?attr/selectableItemBackground"
            android:clickable="true"
            android:focusable="true"
            android:layout_height="72dp" />
    ```
  </Tab>
</Tabs>

<Tabs>
  <Tab title="Java">
    ```java theme={null}
    cometChatListItem = itemView.findViewById(R.id.list_item);
    cometChatListItem.setAvatar("url", "Name");
    cometChatListItem.setTitle("Name");
    ```
  </Tab>
</Tabs>