通用提示框
🤖 回答引擎: 前端Lua |
🕒 时间: 2026-04-08 16:18:49 |
👁️ 阅读: 0
根据浮生梦老师前端课程内容，通用提示框可以通过 `SL:OpenCommonTipsUI()` 函数来打开。
**函数说明：**
```lua
---打开通用弹窗
---* data str: 文本<br>btnType: 按钮类型 int 1:"确定" 2:{"确定","取消"} <br> btnDesc: 按钮描述 table<br> showEdit: 是否显示输入框<br>editParams: 输入框参数table <br>```{ inputMode: 键盘编辑类型, maxLength: 可输入最大长度, str: 默认文本内容}```<br> callback: 按钮回调 [参数1: 点击的按钮id 参数2: 额外参数 table: {editStr=输入框字符串}]
---@param data table
function SL:OpenCommonTipsUI(data) end;
```
**使用示例：**
```lua
-- 创建一个简单的确定按钮提示框
local data = {
str = "确定要删除这个物品吗？",
btnType = 1,
callback = function(btnId, extra)
if btnId == 1 then
SL:print("用户点击了确定按钮")
end
end
}
SL:OpenCommonTipsUI(data)
```
**完整功能示例：**
```lua
-- 带确定/取消按钮和输入框的提示框
local data = {
str = "请输入您的角色名：",
btnType = 2,
btnDesc = {"确定", "取消"},
showEdit = true,
editParams = {
inputMode = 0, -- 文本输入模式
maxLength = 12, -- 最大长度12个字符
str = "默认名称" -- 默认文本
},
callback = function(btnId, extra)
if btnId == 1 then
local inputText = extra.editStr or ""
SL:print("用户输入了：" .. inputText)
else
SL:print("用户取消了操作")
end
end
}
SL:OpenCommonTipsUI(data)
```
**关闭提示框：**
```lua
-- 关闭通用弹窗
SL:CloseCommonTipsUI()
```
**UI界面说明：**
根据前端工程文件，通用提示框包含以下主要组件：
1. 背景布局（Layout）
2. 主面板（PMainUI）
3. 描述文本区域（DescList）
4. 输入框背景（TextFieldBg）
5. 输入框（TextField）
6. 按钮区域
**注意事项：**
- 可以通过 `btnType` 参数控制显示单个按钮或双按钮
- 输入框功能需要设置 `showEdit = true` 并配置 `editParams`
- 回调函数会接收按钮ID和额外参数（包含输入框内容）
- 使用 `SL:CloseCommonTipsUI()` 可以主动关闭提示框
这个通用提示框适用于游戏中需要用户确认、输入或查看信息的各种场景。
← 返回问答库