> For the complete documentation index, see [llms.txt](https://hawklib.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hawklib.gitbook.io/docs/elements/window/tabs/dropdowns.md).

# Dropdowns

## Dropdown Creation

```luau
local SingleDropdown = Tab3:Dropdown({
    Title = "Mode Selection", --dropdown title
    Description = "Select a mode", --dropdown description
    List = {"Mode 1", "Mode 2", "Mode 3", "Mode 4"}, --drop item list
    MultiOption = false, --multioption
    Callback = function(selected)
        print("Selected mode:", selected)
    end
})
```

### Dropdown Functions

Add Item

```luau
--Works only if multioption is false
SingleDropdown:Add("Mode 5", function()
    print("Mode 5 selected")
end)
```

Remove Item

```luau
-- Remove item
SingleDropdown:Remove("Mode 1")
```

Refresh Dropdown

```luau
-- Refresh dropdown
SingleDropdown:Refresh({
    MultiOption = false,
    NewList = {"New 1", "New 2", "New 3"}
})
```

Clear Dropdown

```luau
SingleDropdown:Clear()
```

### Select Items

you can select dropdown items and call their functions

```luau
--Only works if multioption is false
SingleDropdown:Select("New 2")
```

```luau
-- For multi selection
MultiDropdown:Select({"ESP", "Speed"}, true) -- true = clear previous selections
```