# Select

## <mark style="color:green;">class</mark> **UI.Select**

{% hint style="info" %}
This documentation is a work in progress. UI scripting is a new feature, and additional content is still being added. Stay tuned for updates!
{% endhint %}

<table><thead><tr><th width="334">Attribute</th><th>Value</th></tr></thead><tbody><tr><td>label</td><td>any <code>string</code><br><br>This value is required.</td></tr><tr><td>items</td><td><p>a <code>list</code> of items to display.<br><br>Example:<br><code>[{</code></p><p><code>"id": "one",</code> </p><p><code>"title": "Item 1",</code></p><p><code>"iconUrl": "https://i.com/image.png"</code></p><p><code>}]</code><br></p><p><code>id</code>: <strong>Must be unique</strong>. Duplicate IDs can cause unexpected behavior and may result in incorrect UI rendering. Ensure each ID is distinct to avoid issues.</p><p></p><p><code>id</code> &#x26; <code>title</code> are required, <code>iconUrl</code> is optional</p><p><br>Default: <code>None</code></p></td></tr><tr><td>selected_items</td><td>a <code>list</code> of (item) ids to display.<br><br>Default: <code>None</code></td></tr><tr><td>disabled_items</td><td>a <code>list</code> of (item) ids to disable.<br><br>Default: <code>None</code></td></tr><tr><td>mode</td><td><p><code>"single"</code></p><p><code>"multiple"</code><br><br>Default: <code>"single"</code></p></td></tr><tr><td>description</td><td>any <code>string</code><br><br>Default: <code>None</code></td></tr><tr><td>loading</td><td><code>True | False</code><br><br>Default: <code>False</code></td></tr><tr><td>disabled</td><td><code>True | False</code><br><br>Default: <code>False</code></td></tr><tr><td>invalid</td><td><code>True | False</code><br><br>Default: <code>False</code></td></tr><tr><td>error_message</td><td>any <code>string</code><br><br>Default: <code>None</code></td></tr><tr><td>full_width</td><td><code>True | False</code><br><br>Default: <code>False</code></td></tr><tr><td>margin</td><td>See <a href="../..#margin">Margin</a>.<br><br>Default: <code>"m-0"</code></td></tr><tr><td>visible</td><td>See <a href="../..#visible">Visible</a>.<br><br>Default: <code>True</code></td></tr></tbody></table>

### Events

| Event    | Arguments                | Description                           |
| -------- | ------------------------ | ------------------------------------- |
| onChange | selected\_items (`list`) | Triggered when the selection changes. |