esx_menu_dialog

esx_menu_dialog is the input box of ESX Legacy. It shows a title, one text field (or a larger text area) and Submit/Cancel buttons. Use it when you need a single value from the player, such as an amount of money, a plate or a short message. You open it with ESX.UI.Menu.Open('dialog', ...).

OverviewCopy Anchor Link

The resource has no configuration file. The dialog takes mouse and keyboard focus about 200 ms after opening and releases it when the last dialog closes.

Opening a dialogCopy Anchor Link

ESX.UI.Menu.Open('dialog', namespace, name, data, submit, cancel, change, close)

The returned menu object and the generic helpers (ESX.UI.Menu.Close, CloseAll, IsOpen) are documented on the esx_menu_default page.

Dialog dataCopy Anchor Link

Callback dataCopy Anchor Link

Input rules on submitCopy Anchor Link

Before your submit callback runs, the resource processes the value:

1. If the text parses as a number, it is rounded to the nearest integer.
2. If that number is 0 or negative, the dialog shows the notification "That input is not allowed!" and does not call submit.
3. The value is trimmed and converted to a string.

So " 12.6 " arrives as "13", "-5" and "0" never arrive, and text like "ABC 123" passes through trimmed.

ExampleCopy Anchor Link

local function askDepositAmount()
    ESX.UI.Menu.Open('dialog', GetCurrentResourceName(), 'bank_deposit', {
        title = 'Deposit amount',
    }, function(data, menu)
        local amount = tonumber(data.value)

        if not amount then
            ESX.ShowNotification('Enter a valid number', 'error')
            return
        end

        menu.close()
        TriggerServerEvent('my_bank:deposit', amount)
    end, function(data, menu)
        menu.close()
    end)
end

A multi-line dialog with a prefilled value:

ESX.UI.Menu.Open('dialog', GetCurrentResourceName(), 'edit_note', {
    title = 'Note',
    type = 'big',
    value = currentNote,
}, function(data, menu)
    menu.close()
    TriggerServerEvent('my_notes:save', data.value)
end, function(data, menu)
    menu.close()
end)

ControlsCopy Anchor Link

Common issuesCopy Anchor Link

• Comparing data.value to a number fails: it is a string. Use tonumber(data.value).
• Players cannot enter 0: by design. If you need zero or negative values, read them in a change callback or use esx_context number inputs.
• Dialog stays open after Submit: call menu.close() in submit and cancel.
• Mouse cursor stays after closing: focus is only released when no dialog is left open. Make sure every dialog you open is closed, or call ESX.UI.Menu.CloseAll().

RelatedCopy Anchor Link

• esx_menu_default
• esx_menu_list
• esx_context
• Client UI functions

Frequently asked questions