esx_menu_list

esx_menu_list renders a table menu: a header row and any number of data rows, with buttons inside cells. Use it to show tabular data the player can act on, such as a list of employees with "Promote" and "Fire" buttons. You open it with ESX.UI.Menu.Open('list', ...).

OverviewCopy Anchor Link

The resource has no configuration file. The menu takes mouse focus about 200 ms after opening and releases it when the last list menu closes. If several list menus are open, only the most recently opened one is visible.

Opening a list menuCopy Anchor Link

ESX.UI.Menu.Open('list', namespace, name, data, submit, cancel)

The change and close arguments of ESX.UI.Menu.Open are accepted, but this menu type never sends change events. The returned menu object is described on the esx_menu_default page.

Menu dataCopy Anchor Link

There is no title field; the table header is the only heading.

Buttons in cellsCopy Anchor Link

Inside a cell string, {{Label|value}} becomes a button. A cell can contain several buttons:

cols = { 'John Doe', 'Mechanic', '{{Promote|promote}} {{Fire|fire}}' }

Callback dataCopy Anchor Link

cancel receives only _namespace and _name.

ExampleCopy Anchor Link

local function openEmployeeList(employees)
    local rows = {}

    for i = 1, #employees do
        local employee = employees[i]

        rows[#rows + 1] = {
            data = { identifier = employee.identifier },
            cols = {
                employee.name,
                employee.gradeLabel,
                '{{Promote|promote}} {{Fire|fire}}',
            },
        }
    end

    ESX.UI.Menu.Open('list', GetCurrentResourceName(), 'employees', {
        head = { 'Name', 'Grade', 'Actions' },
        rows = rows,
    }, function(data, menu)
        menu.close()
        TriggerServerEvent('my_boss:employeeAction', data.data.identifier, data.value)
    end, function(data, menu)
        menu.close()
    end)
end

ControlsCopy Anchor Link

Common issuesCopy Anchor Link

• Escape does nothing: you did not pass a cancel callback, or it does not call menu.close().
• Button value has the wrong type: jQuery reads data-value and converts numeric strings to numbers, so {{Buy|5}} arrives as the number 5. Use string keys like buy_5 if you need consistent types.
• | or }} in labels breaks buttons: the button syntax is parsed with a simple pattern. Keep labels free of these characters.

RelatedCopy Anchor Link

• esx_menu_default
• esx_menu_dialog
• esx_context
• Client UI functions

Frequently asked questions