Canvas Group
Switch to ScriptingThe Canvas Group can be used to control certain aspects of a whole group of UI(User Interface) Allows a user to interact with your application. Unity currently supports three UI systems. More info
See in Glossary elements from one place without needing to handle them each individually. The properties of the Canvas Group affect the GameObjectThe fundamental object in Unity scenes, which can represent characters, props, scenery, cameras, waypoints, and more. A GameObject’s functionality is defined by the Components attached to it. More info
See in Glossary it is on as well as all children.
Properties
| Property: | Function: |
|---|---|
| Alpha | The opacity of the UI elements in this group. The value is between 0 and 1 where 0 is fully transparent and 1 is fully opaque. Note that elements retain their own transparency as well, so the Canvas Group alpha and the alpha values of the individual UI elements are multiplied with each other. |
| InteractableA UI component property that determines whether the component can accept input. More info See in Glossary |
Determines if this component will accept input. When it is set to false interaction is disabled. |
| Block Raycasts | Will this component act as a colliderAn invisible shape that is used to handle physical collisions for an object. A collider doesn’t need to be exactly the same shape as the object’s mesh - a rough approximation is often more efficient and indistinguishable in gameplay. More info See in Glossary for Raycasts? You will need to call the RayCast function on the graphic raycaster attached to the Canvas. This does not apply to Physics.Raycast. |
| Ignore Parent Groups | Will this group also be affected by the settings in Canvas Group components further up in the Game Object hierarchy, or will it ignore those and hence override them? |
Details
Typical uses of Canvas Group are:
- Fading in or out a whole window by adding a Canvas Group on the GameObject of the Window and control its Alpha property.
- Making a whole set of controls non-interactable (“grayed out”) by adding a Canvas Group to a parent GameObject and setting its Interactable property to false.
- Making one or more UI elements not block mouse events by placing a Canvas Group component on the element or one of its parents and setting its Block Raycasts property to false.