Version: 2022.1
Coordinate and position systems
UQuery

Relative and absolute positioning C# example

This example demonstrates the difference between relative and absolute positioning.

Example overview

The example uses the automatic layout system to add boxes to a window and calculate their positions. One box demonstrates a relative offset of 25 px, while another box demonstrates the absolute position of 25 px, 25 px.

Visual element positioning
Visual element positioning

You can find the completed files that this example creates in this GitHub repository.

Create the example with a C# script

Create a custom Editor window and add all the boxes with a C# script: four boxes with gray backgrounds for comparison purposes; one box with black background with the absolute position; one box with purple background with the relative position.

  1. Create a Unity project with any template.

  2. Right-click in the Project window, then select Create > UI Toolkit > Editor Window.

  3. In the C# box of the UI(User Interface) Allows a user to interact with your application. Unity currently supports three UI systems. More info
    See in Glossary
    Toolkit Editor Window Creator
    window, enter PositioningTestWindow.

  4. Clear the UXML and USS checkboxes.

  5. Select Confirm. This creates a C# file called PositioningTestWindow.cs.

  6. Replace PositioningTestWindow.cs with the following content:

    using UnityEditor;
    using UnityEngine;
    using UnityEngine.UIElements;
    
    public class PositioningTestWindow : EditorWindow
    {
        [MenuItem("Window/UI Toolkit/Positioning Test Window")]
        public static void ShowExample()
        {
            var wnd = GetWindow<PositioningTestWindow>();
            wnd.titleContent = new GUIContent("Positioning Test Window");
        }
    
        public void CreateGUI()
        {
            for (int i = 0; i < 4; i++)
            {
                var temp = new VisualElement();
                temp.style.width = 70;
                temp.style.height = 70;
                temp.style.marginBottom = 2;
                temp.style.backgroundColor = Color.gray;
                rootVisualElement.Add(temp);
            }
    
            // Relative positioning
            var relative = new Label("Relative\nPos\n25, 0");
            relative.style.width = 70;
            relative.style.height = 70;
            relative.style.left = 25;
            relative.style.marginBottom = 2;
            relative.style.backgroundColor = new Color(0.2165094f, 0, 0.254717f);
            rootVisualElement.Add(relative);
    
            // Absolute positioning
            var absolutePositionElement = new Label("Absolute\nPos\n25, 25");
            absolutePositionElement.style.position = Position.Absolute;
            absolutePositionElement.style.top = 25;
            absolutePositionElement.style.left = 25;
            absolutePositionElement.style.width = 70;
            absolutePositionElement.style.height = 70;
            absolutePositionElement.style.backgroundColor = Color.black;
            rootVisualElement.Add(absolutePositionElement);
        }
    }
    
  7. To see the example, from the menu, select Window > UI Toolkit > Positioning Test Window.

Additional resources

Coordinate and position systems
UQuery