Buttons and onClick

Part of the Building Real Games section of Coddy's Unity journey. Lesson 6 of 56.

GameObject > UI > Button - TextMeshPro adds a button: an Image to click, a Button component, and a Text (TMP) child for its label. The Button's onClick is an event, a list of methods it calls when a click is released over it. A script adds its own method to that list with AddListener, once, in Start(). Button lives in the UnityEngine.UI namespace:

using UnityEngine;
using UnityEngine.UI;

public class Doorbell : MonoBehaviour
{
    public Button bellButton;
    private int rings;

    void Start()
    {
        bellButton.onClick.AddListener(Ring);
    }

    void Ring()
    {
        rings++;
        Debug.Log("Ding! " + rings);
    }
}

AddListener(Ring) passes the method itself, without parentheses. AddListener(Ring()) would call Ring at once and pass what it returns, which is nothing, so it does not compile: Argument 1: cannot convert from 'void' to 'UnityEngine.Events.UnityAction'. A listener takes no parameters and returns void. Added in Update(), the same method would join the list again every frame, and one click would ring hundreds of times. A click counts only on the button itself, while Input.GetMouseButtonDown(0) is true for a click anywhere.

A button's interactable decides whether it can be used. bellButton.interactable = false; tints it with its Disabled Color and its listeners are not called until it is set back to true, so the player sees which buttons work right now. On a phone, the same buttons are tapped.

Challenge

Easy

The tower's lift has an Up and a Down button. Write Lift.cs (the scene links upButton, downButton and floorText):

In Start(), hook upButton to a method that takes the lift up one floor, and downButton to one that takes it down one floor.
Floors go from 0 to topFloor (3). The lift stands at y = floor x floorHeight (3), so on floor 2 its y is 6. Its x and z stay as they are.
floorText shows the floor, as Floor: 2, from the start.
On the top floor the Up button is not interactable, and on floor 0 the Down button is not.

Press Play, ride to the top and back, then Check.

Try it yourself

using UnityEngine;
using UnityEngine.UI;
using TMPro;

public class Lift : MonoBehaviour
{
    public Button upButton;
    public Button downButton;
    public TMP_Text floorText;
    public int topFloor = 3;
    public float floorHeight = 3f;
    private int floor;

    void Start()
    {
        // Hook upButton and downButton to methods that move the lift one floor
    }
}