Unity UGUI's ContentSizeFitter Content Size Adapter Component UGUI

Introduction and use of the ContentSizeFitter component of Unity UGUI

1. What is the ContentSizeFitter component?

ContentSizeFitter is a component in Unity UGUI that automatically resizes the size of UI elements to suit the size of their content. It can automatically adjust the width and height of UI elements based on the size of the content, ensuring that the content is not truncated or overflowed.

2. How ContentSizeFitter works

The ContentSizeFitter component automatically adjusts the size of the UI element by listening to the changes in the size of the child elements of the UI element. It can automatically adjust the width and height of the UI element according to the size of the child element to ensure that the content of the child element is not truncated or overflowed.

3. Common properties of ContentSizeFitter

• Horizontal Fit: Horizontal adaptation, optional values ​​are Unconstrained, Preferred Size, and Min Size.
• Vertical Fit: Vertical adaptation, optional values ​​are Unconstrained, Preferred Size, and Min Size.

4. Common functions of ContentSizeFitter

• SetLayoutHorizontal(): Manually calling this function can force update the horizontal adaptation method.
• SetLayoutVertical(): Manually calling this function can force update the vertical adaptation method.

5. Example of ContentSizeFitter usage

Example 1: Automatically resize the button to fit the text content

• Create a button and add a Text component as a child element.
• Add the ContentSizeFitter component to the button.
• Set the Horizontal Fit property to Preferred Size and the Vertical Fit property to Preferred Size.

Write a script to call SetLayoutHorizontal() and SetLayoutVertical() functions in the Start function.

using UnityEngine;
using ;
public class ButtonAutoSize : MonoBehaviour
{
 private Button button;
 private Text text;
 private void Start()
 {
     button = GetComponent<Button>();
     text = GetComponentInChildren<Text>();
     <ContentSizeFitter>().SetLayoutHorizontal();
     <ContentSizeFitter>().SetLayoutVertical();
 }
}

Example 2: Automatically resize the panel to fit child elements

• Create a panel and add some child elements.
• Add the ContentSizeFitter component to the panel.
• Set the Horizontal Fit property to Preferred Size and the Vertical Fit property to Preferred Size.

Write a script to call SetLayoutHorizontal() and SetLayoutVertical() functions in the Start function.

using UnityEngine;
using ;
public class PanelAutoSize : MonoBehaviour
{
 private RectTransform panel;
 private void Start()
 {
     panel = GetComponent<RectTransform>();
     <ContentSizeFitter>().SetLayoutHorizontal();
     <ContentSizeFitter>().SetLayoutVertical();
 }
}

Example 3: Automatically resize scroll view to fit content

• Create a scroll view and add some child elements.
• Add the ContentSizeFitter component to the content of the scroll view.
• Set the Horizontal Fit property to Preferred Size and the Vertical Fit property to Preferred Size.

Write a script to call SetLayoutHorizontal() and SetLayoutVertical() functions in the Start function.

using UnityEngine;
using ;
public class ScrollViewAutoSize : MonoBehaviour
{
 private RectTransform content;
 private void Start()
 {
     content = GetComponent<ScrollRect>().content;
     <ContentSizeFitter>().SetLayoutHorizontal();
     <ContentSizeFitter>().SetLayoutVertical();
 }
}

Example 4: Automatically adjust the mesh layout to fit the child elements

• Create a grid layout and add some child elements.
• Add the ContentSizeFitter component to the Content of the grid layout.
• Set the Horizontal Fit property to Preferred Size and the Vertical Fit property to Preferred Size.

Write a script to call SetLayoutHorizontal() and SetLayoutVertical() functions in the Start function.

using UnityEngine;
using ;
public class GridLayoutAutoSize : MonoBehaviour
{
 private GridLayoutGroup gridLayout;
 private void Start()
 {
     gridLayout = GetComponent<GridLayoutGroup>();
     <ContentSizeFitter>().SetLayoutHorizontal();
     <ContentSizeFitter>().SetLayoutVertical();
 }
}

Example 5: Automatically adjust the horizontal layout size to suit child elements

• Create a horizontal layout and add some child elements.
• Add the ContentSizeFitter component to the Content in the horizontal layout.
• Set the Horizontal Fit property to Preferred Size and the Vertical Fit property to Preferred Size.

Write a script to call SetLayoutHorizontal() and SetLayoutVertical() functions in the Start function.

using UnityEngine;
using ;
public class HorizontalLayoutAutoSize : MonoBehaviour
{
 private HorizontalLayoutGroup horizontalLayout;
 private void Start()
 {
     horizontalLayout = GetComponent<HorizontalLayoutGroup>();
     <ContentSizeFitter>().SetLayoutHorizontal();
     <ContentSizeFitter>().SetLayoutVertical();
 }
}

Things to note

• The ContentSizeFitter component can only be used on child elements of a Layout Group.
• The adjustment of the ContentSizeFitter component is performed after the layout calculation, so you need to manually call SetLayoutHorizontal() and SetLayoutVertical() functions to update the layout.

References

• Unity official documentation:ContentSizeFitter
• Unity official tutorial:UI - Content Size Fitter

The above is the detailed content of the Unity UGUI ContentSizeFitter component usage example. For more information about Unity UGUI ContentSizeFitter, please follow my other related articles!