文本輸入欄位

TextBox 是一個矩形，允許用戶在其聚焦時提供文本輸入。當你 編寫腳本 來使用 TextBox 時，你可以將其用作搜索欄或表單上的輸入欄位。為了幫助用戶了解他們應該輸入什麼類型的文本，你還可以通過 PlaceholderText 屬性提供提示。

因為這些物件是 GuiObjects，你可以自定義 屬性，例如 BackgroundColor3、 BorderMode、 Transparency，以及 Rotation 以符合你遊戲的美學。

在螢幕上創建文本輸入

在螢幕上的 TextBox 對於 像是表單的輸入欄位非常有用。

要將 TextBox 添加到螢幕上：

1. 在 Explorer 窗口中，選擇 StarterGui 並添加一個 ScreenGui。

   1. 將滑鼠懸停在 StarterGui 上，然後點擊 ⊕ 按鈕。會顯示一個上下文菜單。

   2. 插入一個 ScreenGui。

2. 選擇新的 ScreenGui 並添加一個 TextBox。

   1. 將滑鼠懸停在 ScreenGui 上，然後點擊 ⊕ 按鈕。會顯示一個上下文菜單。

   2. 插入一個 TextBox。

在部件面上創建文本輸入

要將 TextBox 添加到部件的面上：

1. 在 Explorer 窗口中，選擇 StarterGui 並添加一個 SurfaceGui。

   1. 將滑鼠懸停在 StarterGui 上，然後點擊 ⊕ 按鈕。會顯示一個上下文菜單。

   2. 插入一個 SurfaceGui。

2. 選擇新的 SurfaceGui 並添加一個 TextBox。

   1. 將滑鼠懸停在 SurfaceGui 上，然後點擊 ⊕ 按鈕。會顯示一個上下文菜單。

   2. 插入一個 TextBox。

3. 將 SurfaceGui 裝飾到你想顯示 TextBox 的 部件 上。

   1. 在 Properties 窗口中，選擇 Adornee 屬性。你的游標會改變。

   2. 在 Explorer 窗口中，選擇該部件。

編寫文本輸入的腳本

像 按鈕 一樣，當用戶與 TextBox 物件互動時，你可以為其編寫任何操作的腳本。例如，以下腳本連接了 FocusLost 事件，當用戶按下 Enter 鍵或點擊框外時觸發。如果 enterPressed 為 true，意味著用戶提交了輸入而不僅僅是點擊框外，則腳本會將輸入的內容打印到 Output 窗口。

local textBox = script.Parent

local function onFocusLost(enterPressed, inputObject)
	if enterPressed then
		print(textBox.Text)
	end
end

textBox.FocusLost:Connect(onFocusLost)

作為另一個例子，你可能想要在 TextBox 中僅允許數字。以下代碼使用 TextBox.GetPropertyChangedSignal 事件來檢測 TextBox.Text 何時變更，例如當用戶開始輸入時，然後使用 string.gsub() 函數來禁止非數字的輸入。

local textBox = script.Parent

local function allowOnlyNumbers()
	textBox.Text = string.gsub(textBox.Text, "%D", "")
end

textBox:GetPropertyChangedSignal("Text"):Connect(allowOnlyNumbers)

文本過濾

應用於各種來源和輸入，文本過濾 可以防止用戶看到不當的語言和個人識別信息，例如電話號碼。Roblox 自動過濾常見的文本輸出，例如通過 遊戲內文本聊天 的消息，但 您有責任過濾您無法明確控制的任何顯示文本，包括 用戶通過文本輸入輸入的字符/字符串。