A set of methods for adapting the contents of your view controllers to size and trait changes.


@protocol UIContentContainer


The methods of this protocol handle size-related transitions that are related to changes in the current trait environment or view controller hierarchy. When the parent view controller changes, or when trait changes occur that affect the size of a view controller, UIKit calls these methods to give the affected objects a chance to respond appropriately.

All UIViewController and UIPresentationController objects provide default implementations for the methods of this protocol. When creating your own custom view controller or presentation controller, you can override the default implementations to make adjustments to your content. For example, you might use these methods to adjust the size or position of any child view controllers.

When overriding the methods of this protocol, call super to let UIKit perform any default behaviors. View controllers and presentation controllers perform their own adjustments when these methods are called. Calling super ensures that UIKit is able to continue adjusting other parts of your user interface.


Responding to Environment Changes

- viewWillTransitionToSize:withTransitionCoordinator:

Notifies the container that the size of its view is about to change.


- willTransitionToTraitCollection:withTransitionCoordinator:

Notifies the container that its trait collection changed.


Responding to Changes in Child View Controllers

- sizeForChildContentContainer:withParentContainerSize:

Returns the size of the specified child view controller’s content.


- preferredContentSizeDidChangeForChildContentContainer:

Notifies an interested controller that the preferred content size of one of its children changed.


- systemLayoutFittingSizeDidChangeForChildContentContainer:

Notifies the container that a child view controller was resized using auto layout.



The preferred size for the container’s content.



Inherits From

See Also

Content View Controllers

Displaying and Managing Views with a View Controller

Build a view controller in storyboards, configure it with custom views, and fill those views with your app’s data.

Showing and Hiding View Controllers

Display view controllers using different techniques, and pass data between them during transitions.


An object that manages a view hierarchy for your UIKit app.


A view controller that specializes in managing a table view.


A view controller that specializes in managing a collection view.