NGUI UIInput组件：文本输入组件

Unity打怪升级

已于 2024-08-04 12:14:45 修改

阅读量711

点赞数 28

分类专栏： # UI 文章标签： Unity NGUI ui 游戏引擎

于 2024-08-01 14:53:34 首次发布

本文链接：https://blog.csdn.net/UnityBoy/article/details/140847719

版权

UI 专栏收录该内容

69 篇文章 2 订阅

订阅专栏

在Unity游戏开发中，用户输入是提供交互性的关键部分。NGUI（Next-Gen UI）系统中的UIInput组件是一个用于创建文本输入框的UI元素，它支持单行和多行文本输入，适用于各种需要用户输入的场景。本文将详细介绍UIInput的用途、特性以及如何在Unity项目中使用它。

UIInput简介

UIInput是NGUI中的一个组件，用于在用户界面中创建文本输入框。它支持基本的文本输入功能，如输入、编辑和格式化文本，并且可以根据需要进行样式和行为的定制。

核心特性

单行和多行输入：支持单行文本输入和多行文本输入（使用UIInputMultiLine）。
文本格式化：可以对输入的文本进行格式化，如大小写转换、数字格式化等。
输入验证：提供输入验证功能，确保用户输入符合特定格式或规则。
事件回调：支持文本改变和提交事件的回调，方便开发者响应用户输入。
键盘和文本编辑器：支持与Unity的键盘和文本编辑器组件集成。

组件详解

在这里插入图片描述
要创建输入字段，只需将其添加到任何可点击区域，然后选择要修改的标签。

输入字段的最基本设置是用于背景的切片 Sprite（如果您希望它不可见，则使用 Widget），以及用于前景的子 Label。在此示例中，精灵需要一个 Box Collider 才能接收事件，并且 UIInput 脚本也会进入它：
注意

Clickable Area (UISprite, BoxCollider, UIInput)
- Text (UILabel)

只需完成此设置，即可单击输入字段并开始输入。

如果您愿意，您可以为输入字段指定一个起始值，也可以通过在“另存为”字段中为其提供一个键来使其自动保存其值。如果指定，则您键入的值将是永久性的。最明显的用法是用于玩家名称或用户名字段。

您可以通过修改标签本身的文本来在输入字段上设置非活动文本。这包括标签的颜色。因此，如果您希望在输入字段中没有文本时看到一个半淡出的“按此处开始输入”文本，请在标签上输入该文本并将标签的颜色设置为半透明（或者只是在 UIInput 上修改 Inactive color 字段）。

选择输入字段后，标签的文本将被替换，其颜色将更改为 UIInput 上指定的活动文本颜色值。

如果您需要将其设置为密码字段，或者您希望在移动平台上有自动更正行为，则可以更改输入的输入类型。键盘类型也适用于移动平台，因为它控制当您选择输入字段时将显示哪种类型的键盘。

如果您希望输入字段进行一些基本验证，例如使其仅接受整数值，请使用“验证”选项进行设置。您还可以使用“字符限制”字段来限制允许用户输入的字符数。将其保留为零将消除字符限制。

要允许用户使用 Tab 键导航到下一个字段，请将下一个输入字段拖放到“在选项卡上选择”字段。

要更改输入字段的对齐方式，请在标签本身上进行修改。同样，您可以通过在 UILabel 上将 Max Lines 属性设置为 1 来将输入字段限制为单行。标签上的所有其他选项也是如此，例如为其提供渐变、阴影效果或更改字符间距。

请注意，在大多数情况下，您可能希望将标签的溢出处理保留在 ClampContent 上，因为这将允许输入在用户不断键入超过原始边界时自动向右滚动。

要接收有关用户何时在输入字段中提交文本的通知，请利用其提交时通知部分。始终可以使用 UIInput.current.value 在要调用的函数中检索输入字段的值。处理完回调后，可以将 UIInput.current.value 设置为 null 以清除输入字段的文本：

    public void MySubmitFunction ()
    {
        Debug.Log("I typed: " + UIInput.current.value);
        UIInput.current.value = null;
    }

提示

如果您希望能够在按下特定键时选择输入字段，例如按“Enter”开始在聊天窗口中输入，请将 UIKeyBinding 脚本附加到其中。
在这里插入图片描述

使用UIInput

创建UIInput

在Unity编辑器中，创建一个新的空GameObject。
将UIInput组件附加到该GameObject上。

配置UIInput

在Inspector面板中，可以配置UIInput的属性：

Input Type：选择输入类型，如文本、数字、密码等。
Placeholder：设置输入框为空时显示的占位符文本。
Max Length：设置最大输入长度。

响应文本变化

使用C#脚本监听UIInput的文本变化事件：

using UnityEngine;
using UnityEngine.UI;

public class InputListener : MonoBehaviour
{
    public UIInput myInput;

    void Start()
    {
        myInput.onInputChanged.AddListener(HandleInputChange);
    }

    void HandleInputChange(string input)
    {
        Debug.Log("Input changed to: " + input);
    }
}

自定义文本格式

使用UIInput的属性和方法自定义文本格式：

public class InputFormatter : MonoBehaviour
{
    public UIInput myInput;

    void Start()
    {
        myInput.label.color = Color.white; // 设置文本颜色
        myInput.inputType = UIInput.InputType.Password; // 设置为密码输入
    }
}