> For the complete documentation index, see [llms.txt](https://golua.fatality.win/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://golua.fatality.win/documentation/datatypes/list.md).

# list

{% hint style="info" %}
Inherits all [control ](/documentation/datatypes/control.md)functions
{% endhint %}

{% hint style="info" %}
Multiselect lists return a table if you pass true as an argument for [**get** ](#get)and also accept a table for [**set**](#set)
{% endhint %}

## Functions

### get

```lua
local item = gui.list('lua>elements a>test', 'lua>elements a')
item:add('Value 1')
print(item:get());
```

#### Returns:

| [Value](/documentation/datatypes/control.md) | [Datatype](/documentation/datatypes/control.md) |
| :------------------------------------------: | :---------------------------------------------: |
|                     value                    |                      string                     |

### set

```lua
local item = gui.list('lua>elements a>test', 'lua>elements a')
item:add('Value 1')
item:add('Value 2')

item:set('Value 1')
```

| [Parameter](/documentation/datatypes/control.md) | [Datatype](/documentation/datatypes/control.md) | [Description](/documentation/datatypes/control.md) |
| :----------------------------------------------: | :---------------------------------------------: | :------------------------------------------------: |
|                       value                      |                      string                     |                      new value                     |

### add

```lua
local item = gui.list('lua>elements a>test', 'lua>elements a')
item:add('Value 1')
item:add('Value 2')
```

| [Parameter](/documentation/datatypes/control.md) | [Datatype](/documentation/datatypes/control.md) | [Description](/documentation/datatypes/control.md) |
| :----------------------------------------------: | :---------------------------------------------: | :------------------------------------------------: |
|                       value                      |                      string                     |                    new list item                   |

### remove

```lua
local item = gui.list('lua>elements a>test', 'lua>elements a')
item:add('Value 1')
item:add('Value 2')

item:remove('Value 1')
```

| [Parameter](/documentation/datatypes/control.md) | [Datatype](/documentation/datatypes/control.md) | [Description](/documentation/datatypes/control.md) |
| :----------------------------------------------: | :---------------------------------------------: | :------------------------------------------------: |
|                       value                      |                      string                     |                   item to remove                   |