# MessageList

> Props, styling and a live MessageList example.

`MessageList` from `@polymorfa/react`. Choose props and styles above; the preview stays visible in every code view.

## Props

| Prop | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `className` | `string` | Optional |  | Class for the root. |
| `classNames` | `SlotClassNames` | Optional |  | Classes keyed by [slot](https://docs.polymorfa.com/ui-kit/appearance#slots). |
| `controller` | `ConversationController` | Optional |  | Conversation to render. |
| `createController` | `() => ConversationController` | Optional |  | Factory for a controller the component owns. |
| `messageFilter` | `(message: ConversationMessage) => boolean` | Optional |  | Presentation-only: never reloads history or cancels a send. |
| `renderMessage` | `(message: ConversationMessage) => ReactNode` | Optional |  | Replaces a bubble's content. |
| `renderAttachment` | `RenderAttachment` | Optional |  | Replaces one attachment. |
| `onReply` | `(message: ConversationMessage) => void` | Optional |  | Show a Reply action on each message. |

## Types

Named types used in the props above.

```ts @polymorfa/react
type RenderAttachment = (attachment: MessageAttachment, message: ConversationMessage) => ReactNode;
```

## Styling

Use `className`, `classNames` (a class for any [slot](https://docs.polymorfa.com/ui-kit/appearance#slots), typed `SlotClassNames`), appearance variables and element styles. The Style panel applies changes to the live component. See [Appearance](https://docs.polymorfa.com/ui-kit/appearance).

## Setup

Use [the provider and server route](https://docs.polymorfa.com/ui-kit/setup) for your application. The preview above uses local sample data and controllers. [Chat controllers](https://docs.polymorfa.com/ui-kit/chat#controllers) and [inbox data sources](https://docs.polymorfa.com/ui-kit/inbox#data-sources) keep your data separate from the UI.
