GuiButtons sont des GuiObjects qui permettent aux joueurs d'effectuer une action. Vous pouvez personnaliser ces boutons pour fournir un contexte et un retour d'information, comme changer l'apparence visuelle ou scripting un retour sonore lorsque le joueur interagit avec un bouton.
Il existe deux types de boutons que vous pouvez placer à l'écran ou dans le jeu :
Un TextButton est un rectangle avec du texte qui déclenche l'événement Activated et/ou SecondaryActivated lors d'un clic/tap.
Un ImageButton est un rectangle avec une image qui déclenche l'événement Activated et/ou SecondaryActivated lors d'un clic/tap. Il dispose d'états supplémentaires pour échanger l'image lors du survol ou de l'appui du joueur.
Boutons à l'écran
Les boutons à l'écran sont utiles pour guider rapidement les joueurs vers divers menus ou pages. Pour ajouter ce type de bouton :
Dans la fenêtre Explorer, survolez StarterGui, cliquez sur le bouton ⊕ et insérez un ScreenGui.
Survolez le nouveau ScreenGui, cliquez sur le bouton ⊕ et insérez soit un TextButton soit un ImageButton.
Boutons sur les faces de partie
Les boutons sur une partie sont utiles pour permettre aux joueurs d'interagir avec des parties. Par exemple, vous pouvez permettre aux joueurs de marcher sur un bouton pour compléter une action.
Pour ajouter un bouton à la face d'une partie :
Dans la fenêtre Explorer, survolez la partie, cliquez sur le bouton ⊕ et insérez un SurfaceGui.
Survolez le nouveau SurfaceGui, cliquez sur le bouton ⊕ et insérez soit un TextButton soit un ImageButton.
Apparence des boutons
Les TextButton et ImageButton héritent de GuiObject qui contient des propriétés comme BackgroundColor3, Rotation, et Size. Les boutons acceptent également les modificateurs d'apparence communs à la plupart des objets UI.
Unique au TextButton, il existe diverses propriétés pour changer son apparence visuelle :
- FontFace — La police utilisée pour rendre le texte.
- Text — La chaîne de texte rendue sur le bouton.
- TextSize — La hauteur de ligne du texte en décalages.
- TextColor3 — Couleur du texte rendu.
Un ImageButton a plusieurs propriétés pour changer son apparence visuelle, y compris des variantes d'image au survol et à l'appui pour indiquer l'interaction d'un joueur avec le bouton :
- Image — L'image qui s'affiche lorsqu'un joueur n'interagit pas avec le ImageButton.
- HoverImage — L'image qui s'affiche lorsqu'un joueur survole le ImageButton.
- PressedImage — L'image qui s'affiche lorsqu'un joueur clique/tape sur le ImageButton.
Boutons script
Vous pouvez script une action lorsqu'un joueur appuie sur un bouton en connectant le bouton à l'événement GuiButton.Activated, ou à GuiButton.SecondaryActivated pour une entrée secondaire multiplateforme comme le clic droit sur un bureau et l'appui long sur mobile. Par exemple, lorsque vous parentiez le LocalScript suivant à un bouton, le bouton change de couleur aléatoire chaque fois qu'un joueur clique/tape dessus.
local button = script.Parent
local RNG = Random.new()
local function onButtonActivated()
-- Randomiser la couleur du bouton
button.BackgroundColor3 = Color3.fromHSV(RNG:NextNumber(), 1, 1)
end
button.Activated:Connect(onButtonActivated)