Understanding iOS View Controller Layout: A Comprehensive Guide

Understanding iOS View Controller Layout: A Comprehensive Guide

28 February 2025 Stephan Petzl Leave a comment Xcode

Transitioning to iOS7 brought several changes to how view controllers manage their layout. Developers often encounter terms like automaticallyAdjustsScrollViewInsets, extendedLayoutIncludesOpaqueBars, and edgesForExtendedLayout. In this guide, we will break down these properties and show how they affect your view controller’s layout.

Full-Screen Layout in iOS7

Starting with iOS7, view controllers use a full-screen layout by default. This means that the views can extend underneath the status and navigation bars, providing more control over the layout. Let’s explore the key properties that manage this behavior:

edgesForExtendedLayout

This property determines which sides of a view can extend to fill the entire screen. By default, it is set to UIRectEdgeAll, allowing the view to cover the whole screen. If you want your view to start below the navigation bar, set it to UIRectEdgeNone. Here’s an example:

UIViewController *viewController = [[UIViewController alloc] init];
viewController.view.backgroundColor = [UIColor redColor];
viewController.edgesForExtendedLayout = UIRectEdgeNone;
UINavigationController *mainNavigationController = [[UINavigationController alloc] initWithRootViewController:viewController];

automaticallyAdjustsScrollViewInsets

This property is crucial when working with UIScrollView or its subclasses like UITableView. It ensures that the scroll view’s content starts below the navigation bar while still scrolling behind it. By default, it is set to YES, automatically adjusting the insets:

// Using Swift
override func viewWillAppear(animated: Bool) {
  self.automaticallyAdjustsScrollViewInsets = false;
}

extendedLayoutIncludesOpaqueBars

By default, this property is set to NO, meaning views will not extend under opaque bars like the status bar. Set it to YES to allow views to extend underneath these bars.

Practical Implementation

To adjust your view controller layout effectively, consider the following steps:

  • Use edgesForExtendedLayout to control which parts of your view extend under system bars.
  • Set automaticallyAdjustsScrollViewInsets to NO if you want manual control over scroll view insets.
  • Enable extendedLayoutIncludesOpaqueBars to extend views under opaque system bars if needed.

Enhancing Your Workflow with Repeato

Automating your testing processes can greatly improve efficiency and reliability. Repeato, a no-code test automation tool for iOS, Android, and web apps, offers a robust solution. With its AI-driven test recorder, you can quickly create, run, and maintain automated tests. Repeato’s support for data-driven and keyword-driven testing ensures that your tests are comprehensive and adaptable.

Unlike other tools that may require specific scripting languages or offer limited customization, Repeato saves tests in text and JSON formats, making it easy to integrate with version control systems. This flexibility, along with its fast test execution and editing capabilities, makes Repeato an excellent choice for developers looking to streamline their test automation processes.

Check it out!

Like this article? there’s more where that came from!

Repeato

Documentation

Support

Legal

Repeato Reviews