TextBox는 사용자가 포커스가 맞춰진 상태에서 텍스트 입력을 제공할 수 있는 사각형입니다. TextBox를 스크립트하면 검색창이나 양식의 입력 필드로 사용할 수 있습니다. 사용자가 어떤 유형의 텍스트를 입력해야 하는지 알 수 있도록 PlaceholderText 속성을 통해 프롬프트를 제공할 수 있습니다.

이 객체들은 GuiObjects이기 때문에, 경험의 미적 요소에 맞게 BackgroundColor3, BorderMode, Transparency, 및 Rotation과 같은 속성을 사용자 정의할 수 있습니다.
화면에 텍스트 입력 만들기
화면의 TextBox는 양식의 입력 필드와 같은 용도로 유용합니다.
화면에 TextBox를 추가하려면:
Explorer 창에서 StarterGui를 선택하고 ScreenGui를 추가합니다.
StarterGui 위에 마우스를 올리고 ⊕ 버튼을 클릭합니다. 컨텍스트 메뉴가 표시됩니다.
ScreenGui를 삽입합니다.
새로 생성된 ScreenGui를 선택하고 TextBox를 추가합니다.
ScreenGui 위에 마우스를 올리고 ⊕ 버튼을 클릭합니다. 컨텍스트 메뉴가 표시됩니다.
TextBox를 삽입합니다.
파트 면에 텍스트 입력 만들기
파트의 면에 TextBox를 추가하려면:
Explorer 창에서 StarterGui를 선택하고 SurfaceGui를 추가합니다.
StarterGui 위에 마우스를 올리고 ⊕ 버튼을 클릭합니다. 컨텍스트 메뉴가 표시됩니다.
ScreenGui를 삽입합니다.
새 SurfaceGui를 선택하고 TextBox를 추가합니다.
SurfaceGui 위에 마우스를 올리고 ⊕ 버튼을 클릭합니다. 컨텍스트 메뉴가 표시됩니다.
TextBox를 삽입합니다.
표시할 TextBox에 SurfaceGui를 장식합니다.
Properties 창에서 Adornee 속성을 선택합니다. 커서 모양이 바뀝니다.
Explorer 창에서 파트를 선택합니다.
텍스트 입력 스크립트
버튼와 마찬가지로, 사용자가 상호작용할 때 TextBox 객체에 대해 어떤 작업이든 스크립트를 작성할 수 있습니다. 예를 들어, 다음 스크립트는 사용자가 Enter 버튼을 누르거나 상자 외부를 클릭할 때 발생하는 FocusLost 이벤트를 연결합니다. 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는 게임 내 텍스트 채팅을 통해 전달된 메시지와 같은 일반 텍스트 출력을 자동으로 필터링하지만, 명시적으로 제어하지 않는 모든 표시된 텍스트에 대한 필터링은 귀하의 책임입니다. 여기에 사용자가 텍스트 입력을 통해 입력하는 캐릭터/문자열가 포함됩니다.