Input dialog

An input dialog shows a form in the middle of the screen. The call waits until the player submits or cancels, then returns the values in field order.

inputCopy Anchor Link

local values = exports.lation_ui:input(data)

The call waits for the player, so run it from a thread, command or event handler.

Enter submits and Escape cancels; in a textarea, Shift+Enter starts a new line. Required fields and limits are checked on submit: each field that fails turns red with a message under it, and is checked again as the player corrects it.

You can pass the list of fields itself instead of a table with options:

local values = exports.lation_ui:input({
    { type = 'input', label = 'Name' },
    { type = 'number', label = 'Amount' }
})

An empty options list shows a plain confirm, the title and buttons alone; submitting it returns an empty table. A table with no options and no fields returns nil without showing anything.

local values = exports.lation_ui:input({
    title = 'Create listing',
    subtitle = 'List an item on the market',
    submitText = 'Post',
    options = {
        {
            type = 'input',
            label = 'Title',
            placeholder = 'Rusty toolbox',
            icon = 'fas fa-tag',
            required = true,
            max = 40
        },
        {
            type = 'number',
            label = 'Price',
            icon = 'fas fa-dollar-sign',
            required = true,
            min = 1,
            default = 100
        },
        {
            type = 'select',
            label = 'Category',
            icon = 'fas fa-list',
            options = {
                { label = 'Tools', value = 'tools' },
                { label = 'Electronics', value = 'electronics' },
                { label = 'Weapons', value = 'weapons', disable = true }
            }
        },
        {
            type = 'toggle',
            label = 'Allow offers',
            default = true
        },
        {
            type = 'slider',
            label = 'Condition',
            min = 0,
            max = 100,
            unit = '%',
            default = 75
        }
    }
})

if not values then return end

local title, price, category, allowOffers, condition = values[1], values[2], values[3], values[4], values[5]

FieldsCopy Anchor Link

Every field takes these:

Field typesCopy Anchor Link

select and multi-select options are tables with a value (string or number), an optional label shown in its place, and an optional disable = true to grey one out.

A slider without a default starts at min. A multi-select default is a table of values.

A min or max you set is enforced whatever its value, 0 included: min = 0 on a number field refuses a negative number, and max = 0 on an input allows no characters. A field without them takes any number or any length, negatives included. A slider without them runs from 0 to 100.

The date format is read by its first part: a format that starts with yyyy gives 2025-12-31 style dates, dd gives 31/12/2025 and mm gives 12/31/2025. The separator in the format (/, - or .) is used in the result. A required date or date-range left empty shows "... is required" under it, like any other field.

A date-range field opens a calendar where the first click picks one end and the second the other, in either order; clicking the first day again takes the pick back. Its default is a table of two dates in its format, or both in one string split by a comma. It returns both days, so read them as two values:

local values = exports.lation_ui:input({
    title = 'Book a stay',
    options = {
        { type = 'date-range', label = 'Dates', required = true, format = 'yyyy-mm-dd' }
    }
})
if not values then return end

local checkIn, checkOut = values[1][1], values[1][2] -- '2026-12-24', '2026-12-31'

closeInputCopy Anchor Link

exports.lation_ui:closeInput()

Closes the open input dialog from your script. A waiting input call returns nil.

-- Give the player 30 seconds to answer
SetTimeout(30000, function() exports.lation_ui:closeInput() end)