PopUpButton

A PopUpbutton displays a menu of mutually exclusive options.

Summary

Properties

Property	Type	Description
Options	{[number]: string}?	You can use this table to pre-define options. Note that doing it this way will not give you access to the option instances themselves.
Value	number?	The numeric index of the option to be selected.

View all inherited from BaseComponent

View all inherited from Frame

Methods

Method	Signature	Description
Option	(Name: string?) -> Frame	Can be used to seperately create options, use this if you want to access the option instances themselves. An example of use would be a dynamically updating playerlist.
Remove	(Index: number?) -> nil,	Can be used to remove options from the pop-up menu, this automatically removes it from the options list as well.

View all inherited from Frame

Events

Event	Signature	Description
ValueChanged	((self: PopUpButton, value: string) -> unknown)?	A Callback function that is triggered when the Value property has been modified.

View all inherited from Frame

Types

type PopUpButtonProperties = Frame & {
    Options: { [number]: string }?,
    Expanded: boolean?,
    Value: number?,
    ValueChanged: ((self: PopUpButton, value: number) -> unknown)?,
}

type PopUpButton = BaseComponent & Components & PopUpButtonProperties & {
    Option: (Name: string?) -> Frame,
    Remove: (Index: number?) -> nil,
}

Function Signature

function(self, properties: PopUpButtonProperties): PopUpButton

Example

local popUpButton = row:Right():PopUpButton({
    Options = {
        "Item One",
        "Item Two",
    },
    ValueChanged = function(self, value: number)
        print("Value changed:", self.Options[value])
    end,
})

print(popUpButton:IsA("Frame")) --> true
print(popUpButton.ClassName) --> "Frame"
print(popUpButton.Type) --> "PopUpButton"

popUpButton.Value = 3 --> Value changed: "Item Three"

local itemThree = popUpButton:Option("Item Three")

print(itemThree.ClassName) --> Frame
popUpButton:Remove(13)