## Documentation Index

Fetch the complete documentation index at: [/llms.txt](https://dev.writer.com/llms.txt)

Use this file to discover all available pages before exploring further.

A user input component that allows users to choose multiple values from a list of options using checkboxes.

## Fields

| Name                   | Type        | Description                                                                                     | Options                      |
|------------------------|-------------|-------------------------------------------------------------------------------------------------|------------------------------|
| Label                  | Text        | -                                                                                               | -                            |
| Options                | Key-Value   | Key-value object with options. Must be a JSON string or a state reference to a dictionary.    | -                            |
| Orientation            | Text        | Specify how to lay out the options.                                                            | 1. Vertical<br>2. Horizontal |
| Primary text           | Color       | -                                                                                               | -                            |
| Accent                 | Color       | -                                                                                               | -                            |
| Custom CSS classes     | Text        | CSS classes, separated by spaces. You can define classes in custom stylesheets.                | -                            |

## Events

**wf-options-change**

Sent when the selected options change.

```
def onchange_handler(state, payload):

# Set the state variable "selected" to the selected options.
    # The payload will be a list, as multiple options are allowed.

state["selected"] = payload
```