ScreenManager

Flexible way to manage your UI with transitions, layers and proper navigation handling for Unity.

Features

ScreenEditor inspector
but the whole system can be used fully through code
Multi-layered stack based navigation ( alertbox > popup > main )
- Re-usable screen instances
- Duplication of screens ( popups, alerts )
Optimized clean and bloatfree code, no additional libraries required
Button-mashing-proof, screens respect their order and animate in/out properly
Default input handling using Unity's UI events ( including cancel/back event )
Always-on selected button for gamepad and keyboard-aware navigation
Spread feature: See all your screens in a grid view for an easier overview and editing
Buttons navigation generation
- Optional focused default button
- Cancel/back button which is selected when Cancel key is pressed
- Isolate navigation to the current screen
Extendable generic BaseScreen class
- Including pre-made presets: Animate, Tween, AnimationController
- Easily create your own type of screen using the BaseScreen class
Mobile tested
Includes three examples
Fully documented code

Gif

( Note: The inspector window is not forcefully updated, which is why it lags a bit behind )

Screenshots

Sample code

screenmgr.Show("MainMenu");
screenmgr.ShowPopup<Popup>("Alertbox").Message = "Custom Alert Text";
screenmgr.HideAll();

Info

How to use ?

Simply create a new ScreenManager on any canvas element. (Preferably right underneath the main canvas element.)

Ignore the ScreenManager settings for now, let's create some screens.

To start, we can add SimpleTweenScreen under ScreenManager GameObject.

For custom screens: You can either inherit BaseScreen class or any other pre-made classes: AnimatorScreen, Popup, SimpleTweenScreen, TweenedScreen

Once SimpleTweenScreen is added, you'll notice few things :

It added a CanvasGroup element
It has a lot of strange settings

By default BaseScreen class provides several important settings, these settings are the core of makes the screen work so well :

Generation Settings
Generate Navigation ( Create explicit navigation so that keyboard/gamepad navigation never leaks to an another screen )
Cancel Selection ( Button selected or executed when ESC or back button is pressed )
Cancel Selection
Hide Current ( Hide previous screen or overlay on top of the previous screen )
Keep on Top when hiding ( Keep its drawing order on top when hiding )
Layer Priority ( All screens have layers, imagine that an alert box will block all screen changes that are below it but wouldn't block other alert boxes )
Default Selection ( Button selected by default when the screen is shown, when left empty : first button found is selected )

You can leave those settings as they are for now, no need for additional configuration.

Once we added SimpleTweenScreen to all our screens, we can define our default screen that's going to be open on run.

Go to ScreenManager ( Shortcut Ctrl+Alt+T or Window/Select ScreenManager in the menu )

Select your SimpleTweenScreen in the Screens section. Once selected you'll see a button named "Set Default" appear.

Click on it, it will set that screen as the default/main screen.

Now that's done we can pass to setting up our buttons.

There's two ways to setup the buttons :

You can either show a screen by its name, or by it's GameObject reference.

( Tutorial to be finished )

Contribution

There's always more to add, so if you want to help then feel free to contribute !

License

Xerios/ScreenManager

ErrorLooks like something went wrong!

About

Topics

Resources

License

Stars

Watchers

Forks

Releases

Packages 0

Contributors 8

Languages

Error
Looks like something went wrong!

Packages