Campos de entrada de texto

Una TextBox es un rectángulo que permite a un usuario proporcionar entrada de texto mientras está en foco. Cuando guionizas un TextBox, puedes usarlo como una barra de búsqueda o un campo de entrada en un formulario. Para ayudar a los usuarios a saber qué tipo de texto deben ingresar, también puedes proporcionar un aviso a través de la propiedad PlaceholderText.

Debido a que estos objetos son GuiObjects, puedes personalizar propiedades como BackgroundColor3, BorderMode, Transparency, y Rotation para ajustarse a la estética de tu experiencia.

Crear entradas de texto en la pantalla

Una TextBox en una pantalla es útil para cosas como un campo de entrada para un formulario.

Para agregar un TextBox a una pantalla:

1. En la ventana Explorer, selecciona StarterGui y agrega un ScreenGui.

   1. Pasa el ratón por encima de StarterGui y haz clic en el botón ⊕. Se muestra un menú contextual.

   2. Inserta un ScreenGui.

2. Selecciona el nuevo ScreenGui y agrega un TextBox.

   1. Pasa el ratón por encima de ScreenGui y haz clic en el botón ⊕. Se muestra un menú contextual.

   2. Inserta un TextBox.

Crear entradas de texto en las caras de las piezas

Para agregar un TextBox a la cara de una pieza:

1. En la ventana Explorer, selecciona StarterGui y agrega un SurfaceGui.

   1. Pasa el ratón por encima de StarterGui y haz clic en el botón ⊕. Se muestra un menú contextual.

   2. Inserta un ScreenGui.

2. Selecciona el nuevo SurfaceGui y agrega un TextBox.

   1. Pasa el ratón por encima de SurfaceGui y haz clic en el botón ⊕. Se muestra un menú contextual.

   2. Inserta un TextBox.

3. Adorna el SurfaceGui a la pieza en la que deseas mostrar el TextBox.

   1. En la ventana Properties, selecciona la propiedad Adornee. Tu cursor cambiará.

   2. En la ventana Explorer, selecciona la pieza.

Guionizar entradas de texto

Al igual que con botones, puedes guionizar cualquier acción para un objeto TextBox cuando un usuario interactúa con él. Por ejemplo, el siguiente script conecta el evento FocusLost que se activa cuando el usuario presiona la tecla Enter o hace clic fuera del cuadro. Si enterPressed es true, lo que significa que el usuario envió la entrada en lugar de simplemente hacer clic fuera del cuadro, el script imprime el contenido de la entrada en la ventana Output.

Manejo básico de entrada de texto
local textBox = script.Parent

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

textBox.FocusLost:Connect(onFocusLost)

Como otro ejemplo, es posible que desees permitir solo números en un TextBox. El siguiente código utiliza el evento TextBox.GetPropertyChangedSignal para detectar cuando el TextBox.Text cambia, como cuando un usuario comienza a escribir, luego utiliza la función string.gsub() para no permitir caracteres no numéricos.

Restringir la entrada de texto a números
local textBox = script.Parent

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

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

Filtrado de texto

Applied to various sources and inputs, text filtering prevents users from seeing inappropriate language and personally identifiable information such as phone numbers. Roblox automatically filters common text outputs such as messages that have passed through in-game text chat, but you are responsible for filtering any displayed text that you don't have explicit control over, including caracteres/cadenas que los usuarios ingresan a través de entradas de texto.