【前端接口】GUI:TextInput_Create：输入框与聊天输入的安全实现

实战应用：用在哪里

聊天输入、行会招募文案、兑换码输入、改名确认，一切让玩家打字的地方都是 GUI:TextInput_Create。输入框的创建参数与一系列 set 接口控制着输入的类型、长度、占位提示，输入的安全与体验在参数里定调。

创建与限制

---创建输入框 parent:父节点 ID:x/y:坐标 width/height:尺寸 fontSize:字号
function GUI:TextInput_Create(parent, ID, x, y, width, height, fontSize) end

-- 兑换码输入框：限长 16，占位提示
local input = GUI:TextInput_Create(win, "codeInput", 100, 150, 240, 32, 14)
GUI:TextInput_setMaxLength(input, 16)
GUI:TextInput_setPlaceHolder(input, "请输入兑换码")
GUI:TextInput_setInputMode(input, 0)
GUI:addOnClickEvent(confirmBtn, function()
    local code = GUI:TextInput_getString(input)
    SL:SendNetMsg(9101, 0, 0, 0, code)
end)

maxLength 在前端就拦住超长输入，placeHolder 的灰色提示文字告诉玩家该输什么，inputMode 区分纯数字、单行、多行的键盘类型。取值用 TextInput_getString，取到的内容发往服务端校验，前端长度限制是体验优化、服务端校验才是安全边界，两道都要有。

输入事件的监听

-- 输入变化的实时监听
GUI:TextInput_addOnEvent(input, function(widget, eventType)
    local text = GUI:TextInput_getString(widget)
    local byteLen = SL:GetUTF8ByteLen(text)
    if byteLen > 48 then
        SL:ShowSystemTips("名字最长 16 个汉字")
    end
end)

addOnEvent 监听输入的变化事件，实时校验的场景（名字的字节长度、敏感词的即时提示）在事件里做。SL:GetUTF8ByteLen 是输入校验的黄金搭档：中文一个字三个字节，名字长度的限制按字节算，汉字与字母的混合输入的字节校验全靠它。输入框的字体与颜色（setFont、setFontColor、setPlaceholderFontColor）让输入框的视觉与窗口主题统一。

验证与监控

输入框的交互埋点：打开率、输入率、提交率的三级漏斗，输入流程的断点一目了然。

踩坑记录

输入内容的两端空格曾经被原样提交，服务端的 trim 校验补上后才杜绝"带空格的同名"类问题。输入法的中英文切换在部分机型的 maxLength 计数偏差，长度的最终校验以服务端为准的规则从未动摇。

上线要点

输入框的安全边界：前端的一切限制都是体验，服务端的长度、字符集、敏感词校验是安全的全部。输入框的占位文案与错误提示的文案要在文案表里统一管理，提示的语气与游戏调性一致。敏感输入（改名、行会名）的确认流程：输入、预览、二次确认的三步确认在输入类功能里是标准配置。

本文由 996 技术组基于 996 引擎官方知识库与浮生梦老师课程体系整理。团队长期从事传奇类引擎 Lua 后端逻辑、客户端界面与商业版本交付，内容以官方知识库与真实项目为出处，按版本持续修订。