텍스트 입력 필드

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

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. ScreenGui를 삽입합니다.

  2. SurfaceGui를 선택하고 TextBox를 추가합니다.

    1. SurfaceGui 위에 마우스를 올리고 ⊕ 버튼을 클릭합니다. 컨텍스트 메뉴가 표시됩니다.

    2. TextBox를 삽입합니다.

  3. 표시할 TextBoxSurfaceGui를 장식합니다.

    1. Properties 창에서 Adornee 속성을 선택합니다. 커서 모양이 바뀝니다.

    2. Explorer 창에서 파트를 선택합니다.

텍스트 입력 스크립트

버튼와 마찬가지로, 사용자가 상호작용할 때 TextBox 객체에 대해 어떤 작업이든 스크립트를 작성할 수 있습니다. 예를 들어, 다음 스크립트는 사용자가 Enter 버튼을 누르거나 상자 외부를 클릭할 때 발생하는 FocusLost 이벤트를 연결합니다. enterPressedtrue이면 사용자가 상자 외부를 클릭하는 대신 입력을 제출한 의미이므로 스크립트는 입력 내용이 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는 게임 내 텍스트 채팅을 통해 전달된 메시지와 같은 일반 텍스트 출력을 자동으로 필터링하지만, 명시적으로 제어하지 않는 모든 표시된 텍스트에 대한 필터링은 귀하의 책임입니다. 여기에 사용자가 텍스트 입력을 통해 입력하는 캐릭터/문자열가 포함됩니다.

©2026 Roblox Corporation. Roblox 및 Roblox 로고, 'Powering Imagination'은 미국 및 기타 국가 내 당사의 등록 및 미등록 상표입니다.