gilzoide / unity-safe-area-layout

uGUI layout group that makes children respect the Safe Area. It drives children's anchors and supports LayoutElement.ignoreLayout

Safe Area Layout

Unity GUI layout group that makes children respect the Safe Area. It drives direct children's anchors while in Play Mode and supports LayoutElement.ignoreLayout.

Features

• Fully integrated with Unity GUI's layout system: only rebuilds the layout when needed, no Update method or coroutines attached
• Does not resize it's own RectTransform, so it can be used in objects with a Canvas component directly
• Does not demand a full screen RectTransform: the script detects where your rect overlaps with the Safe Area and updates accordingly
• Ignore children using a IgnoreSafeArea component or LayoutElement with Ignore Layout marked as true. Useful for background images, for example.
• Preview Safe Area adjustments in Editor using any of the Preview Modes in SafeAreaLayoutGroup's inspector while hovering the Hover to Preview Layout button or while in Play Mode. All Preview Modes support both portrait and landscape resolutions. Screen.safeArea Preview Mode is only applied when using Unity's Device Simulator (in Unity 2020 and older, available as an UPM package)
• Only affects canvases in either Screen Space - Overlay or Screen Space - Camera modes, so World Space canvases are ignored

Installing

Either:

• Install using openupm:

  openupm add com.gilzoide.safe-area-layout
  

• Install via Unity Package Manager using the following git URL:

  https://github.com/gilzoide/unity-safe-area-layout.git#1.0.2
  

• Clone this repository directly to your Packages folder or anywhere inside your project's Assets.

Sample

A sample scene is available at Samples~/SimpleSample.

How to use

1. Add the SafeAreaLayoutGroup script anywhere in your UI hierarchy, even objects with Canvas components are supported. Direct children will have their anchors driven while the script is enabled.
2. (optional) Select the Safe Area edges that your layout group will respect.
3. (optional) Make specific children be ignored by the layout group by adding the IgnoreSafeArea component to them. Alternatively, use LayoutElement components with the Ignore Layout flag marked as true.
4. (optional) Use one of the Preview Modes while in editor to preview the adjustments. Preview is applied on Play Mode and while hovering the Hover to Preview Layout button in the SafeAreaLayoutGroup's inspector.
5. Play the game (play the game, everybody play the gaaaame)
6. Enjoy 🍾

unity-safe-area-layout's Issues

Layout does not refresh it self in Play Mode

Need to move mouse over the specific area in a layout. That is so annoying thing. Because in the middle of development and debugging need to find a component with the SafeAreaLayout component and move mouse over. Is it possible to force it to work automatically OnAwake or OnStart events (at least as an option)?

Unity_RjdR9pUOmB.mp4

P.S. the package is very cool! Thanks for the work <3