91 lines
5.0 KiB
Markdown
91 lines
5.0 KiB
Markdown
|
# qb-input
|
||
|
|
|
||
|
|
NUI input system for QBCore
|
||
|
|
|
||
|
|
This is a modified version of **[NH Keyboard](https://forum.cfx.re/t/no-longer-supported-standalone-nerohiro-s-keyboard-dynamic-nui-keyboard-input/2506326)** by **[NeroHiro](https://github.com/nerohiro)**
|
||
|
|
|
||
|
|
## Example
|
||
|
|
|
||
|
|
Here is an example commant which will create a basic form and will print out it's inputs:
|
||
|
|
|
||
|
|
```lua
|
||
|
|
RegisterCommand('testinput', function()
|
||
|
|
local dialog = exports['qb-input']:ShowInput({
|
||
|
|
header = "Test",
|
||
|
|
submitText = "Bill",
|
||
|
|
inputs = {
|
||
|
|
{
|
||
|
|
text = "Citizen ID (#)", -- text you want to be displayed as a place holder
|
||
|
|
name = "citizenid", -- name of the input should be unique otherwise it might override
|
||
|
|
type = "text", -- type of the input
|
||
|
|
isRequired = true -- Optional [accepted values: true | false] but will submit the form if no value is inputted
|
||
|
|
},
|
||
|
|
{
|
||
|
|
text = "Bill Price ($)", -- text you want to be displayed as a place holder
|
||
|
|
name = "billprice", -- name of the input should be unique otherwise it might override
|
||
|
|
type = "number", -- type of the input - number will not allow non-number characters in the field so only accepts 0-9
|
||
|
|
isRequired = false -- Optional [accepted values: true | false] but will submit the form if no value is inputted
|
||
|
|
},
|
||
|
|
{
|
||
|
|
text = "Bill Type", -- text you want to be displayed as a input header
|
||
|
|
name = "billtype", -- name of the input should be unique otherwise it might override
|
||
|
|
type = "radio", -- type of the input - Radio is useful for "or" options e.g; billtype = Cash OR Bill OR bank
|
||
|
|
options = { -- The options (in this case for a radio) you want displayed, more than 6 is not recommended
|
||
|
|
{ value = "bill", text = "Bill" }, -- Options MUST include a value and a text option
|
||
|
|
{ value = "cash", text = "Cash" }, -- Options MUST include a value and a text option
|
||
|
|
{ value = "bank", text = "Bank" } -- Options MUST include a value and a text option
|
||
|
|
}
|
||
|
|
},
|
||
|
|
{
|
||
|
|
text = "Include Tax?", -- text you want to be displayed as a input header
|
||
|
|
name = "taxincl", -- name of the input should be unique otherwise it might override
|
||
|
|
type = "checkbox", -- type of the input - Check is useful for "AND" options e.g; taxincle = gst AND business AND othertax
|
||
|
|
options = { -- The options (in this case for a check) you want displayed, more than 6 is not recommended
|
||
|
|
{ value = "gst", text = "10% incl." }, -- Options MUST include a value and a text option
|
||
|
|
{ value = "business", text = "35% incl." }, -- Options MUST include a value and a text option
|
||
|
|
{ value = "othertax", text = "15% incl." } -- Options MUST include a value and a text option
|
||
|
|
}
|
||
|
|
},
|
||
|
|
{
|
||
|
|
text = "Some Select", -- text you want to be displayed as a input header
|
||
|
|
name = "someselect", -- name of the input should be unique otherwise it might override
|
||
|
|
type = "select", -- type of the input - Select is useful for 3+ amount of "or" options e.g; someselect = none OR other OR other2 OR other3...etc
|
||
|
|
options = { -- Select drop down options, the first option will by default be selected
|
||
|
|
{ value = "none", text = "None" }, -- Options MUST include a value and a text option
|
||
|
|
{ value = "other", text = "Other" }, -- Options MUST include a value and a text option
|
||
|
|
{ value = "other2", text = "Other2" }, -- Options MUST include a value and a text option
|
||
|
|
{ value = "other3", text = "Other3" }, -- Options MUST include a value and a text option
|
||
|
|
{ value = "other4", text = "Other4" }, -- Options MUST include a value and a text option
|
||
|
|
{ value = "other5", text = "Other5" }, -- Options MUST include a value and a text option
|
||
|
|
{ value = "other6", text = "Other6" }, -- Options MUST include a value and a text option
|
||
|
|
}
|
||
|
|
}
|
||
|
|
},
|
||
|
|
})
|
||
|
|
|
||
|
|
if dialog ~= nil then
|
||
|
|
for k,v in pairs(dialog) do
|
||
|
|
print(k .. " : " .. v)
|
||
|
|
end
|
||
|
|
end
|
||
|
|
end, false)
|
||
|
|
```
|
||
|
|
|
||
|
|
## License
|
||
|
|
|
||
|
|
QBCore Framework
|
||
|
|
Copyright (C) 2021 Joshua Eger
|
||
|
|
|
||
|
|
This program is free software: you can redistribute it and/or modify
|
||
|
|
it under the terms of the GNU General Public License as published by
|
||
|
|
the Free Software Foundation, either version 3 of the License, or
|
||
|
|
(at your option) any later version.
|
||
|
|
|
||
|
|
This program is distributed in the hope that it will be useful,
|
||
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||
|
|
GNU General Public License for more details.
|
||
|
|
|
||
|
|
You should have received a copy of the GNU General Public License
|
||
|
|
along with this program. If not, see <https://www.gnu.org/licenses/>
|