Champs de saisie de texte

Un TextBox est un rectangle qui permet à un utilisateur de fournir une saisie de texte pendant qu'il est en focus. Lorsque vous script un TextBox, vous pouvez l'utiliser comme barre de recherche ou champ de saisie sur un formulaire. Pour aider les utilisateurs à savoir quel type de texte ils doivent saisir, vous pouvez également fournir un indicateur grâce à la propriété PlaceholderText.

Parce que ces objets sont GuiObjects, vous pouvez personnaliser les propriétés telles que BackgroundColor3, BorderMode, Transparency, et Rotation pour s'adapter à l'esthétique de votre expérience.

Créer des saisies de texte à l'écran

Un TextBox sur un écran est utile pour des choses comme un champ de saisie pour un formulaire.

Pour ajouter un TextBox à un écran :

1. Dans la fenêtre Explorer, sélectionnez StarterGui et ajoutez un ScreenGui.

   1. Survolez StarterGui et cliquez sur le bouton ⊕ . Un menu contextuel s'affiche.

   2. Insérez un ScreenGui.

2. Sélectionnez le nouveau ScreenGui et ajoutez un TextBox.

   1. Survolez ScreenGui et cliquez sur le bouton ⊕ . Un menu contextuel s'affiche.

   2. Insérez un TextBox.

Créer des saisies de texte sur des faces de partie

Pour ajouter un TextBox à la face d'une partie :

1. Dans la fenêtre Explorer, sélectionnez StarterGui et ajoutez un SurfaceGui.

   1. Survolez StarterGui et cliquez sur le bouton ⊕ . Un menu contextuel s'affiche.

   2. Insérez un SurfaceGui.

2. Sélectionnez le nouveau SurfaceGui et ajoutez un TextBox.

   1. Survolez SurfaceGui et cliquez sur le bouton ⊕ . Un menu contextuel s'affiche.

   2. Insérez un TextBox.

3. Adorn le SurfaceGui à la partie sur laquelle vous souhaitez afficher le TextBox.

   1. Dans la fenêtre Properties, sélectionnez la propriété Adornee. Votre curseur change.

   2. Dans la fenêtre Explorer, sélectionnez la partie.

Script de saisie de texte

Comme pour les boutons, vous pouvez script tous les actions pour un objet TextBox lorsque l'utilisateur interagit avec lui. Par exemple, le script suivant connecte l'événement FocusLost qui se déclenche lorsque l'utilisateur appuie sur le bouton Entrée ou clique en dehors de la boîte. Si enterPressed est true, ce qui signifie que l'utilisateur a soumis l'entrée plutôt que simplement cliquer en dehors de la boîte, le script affiche le contenu de l'entrée dans la fenêtre Output.

Gestion de la saisie de texte de base
local textBox = script.Parent

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

textBox.FocusLost:Connect(onFocusLost)

Comme autre exemple, vous pourriez vouloir autoriser uniquement les chiffres dans un TextBox. Le code suivant utilise l'événement TextBox.GetPropertyChangedSignal pour détecter lorsque le TextBox.Text change, par exemple lorsque l'utilisateur commence à taper, puis il utilise la fonction string.gsub() pour interdire les non-chiffres.

Restriction de saisie de texte aux chiffres
local textBox = script.Parent

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

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

Filtrage de texte

Appliqué à diverses sources et saisies, le filtrage de texte empêche les utilisateurs de voir un langage inapproprié et des informations personnellement identifiables telles que des numéros de téléphone. Roblox filtre automatiquement les sorties de texte courantes, comme les messages qui ont été transmis par le chat textuel en jeu, mais vous êtes responsable du filtrage de tout texte affiché sur lequel vous n'avez pas de contrôle explicite, y compris caractères/chaînes que les utilisateurs saisissent via les champs de texte.