Input · Ember · rbx.lol

The smallest input#

Luau

main:Input({
    Text = "Target player",
    Callback = function(text)
        target = text
    end,
})

Live preview

My Script

v1.0

Search…

Main

Visuals

Settings

Ember v3

Filter

Hint at what goes in it:

Luau

main:Input({
    Text = "Target player",
    Placeholder = "Username…",
    Callback = setTarget,
})

Wait until they finish typing — fires on blur or Enter instead of every keystroke:

Luau

main:Input({
    Text = "Target player",
    Placeholder = "Username…",
    FireOnBlur = true,
    Callback = setTarget,
})

Option	Type	Default	What it does
`Text`req	`string`	`—`	The label.
`Callback`	`function(string)`	`—`	Called with the field's contents.
`Placeholder`	`string`	`—`	Ghost text shown while the field is empty.
`Default`	`string`	`""`	Starting contents.
`FireOnBlur`	`boolean`	`false`	Fire on blur or Enter instead of on every keystroke.
`Style`	`string`	`—`	Visual variant, matching the button styles.
`Description`	`string`	`—`	A quieter second line.
`Icon`	`string`	`—`	An icon shown before the label.
`Save`	`string`	`—`	Persist under this key.

Method	Returns	What it does
`Get()`	`string`	The current contents
`Set(text)`	—	Replaces the contents and fires `Callback`

Per keystroke is right when the result is cheap and instant feedback is the point:

Luau

-- Filtering a list narrows as you type. Correct.
main:Input({ Text = "Filter", Callback = function(q) applyFilter(q) end })

FireOnBlur is right when a half-typed value is meaningless or costly:

Luau

-- Without FireOnBlur this fires on "S", then "St", then "Ste"…
main:Input({ Text = "Teleport to", FireOnBlur = true, Callback = teleportTo })