<!--
{
  "availability" : [
    "tvOS: 12.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "TVUIKit",
  "identifier" : "/documentation/TVUIKit/TVLockupView",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "TVUIKit"
    ],
    "preciseIdentifier" : "c:objc(cs)TVLockupView"
  },
  "title" : "TVLockupView"
}
-->

# TVLockupView

A focusable view that presents main content, like a movie poster, and an optional header and footer.

```
class TVLockupView
```

## Overview

A `TVLockupView` object consists of three views that operate as a single view. The content view typically contains a media item image, like a movie poster, with additional information in the header and footer views. The `TVLockupView` object expands when it comes into focus, using [`focusSizeIncrease`](/documentation/TVUIKit/TVLockupView/focusSizeIncrease) and [`contentSize`](/documentation/TVUIKit/TVLockupView/contentSize) to calculate the size increase. Provide sufficient `focusSizeIncrease` values so that your custom content doesn’t overlap other objects when the content comes into focus.

The following figure shows a `TVLockupView` object that’s in focus. The yellow, vertical bars indicate the space between views. The center view is in focus and has increased in size, expanding into the space between views. Views don’t move as other views come into focus.

![A diagram depicting five TV lockup views in a row, separated by yellow, vertical bars that indicate the space between views. The center view is larger than the other views and covers part of the yellow areas on either side of it.](images/com.apple.tvuikit/media-3016664@2x.png)

> Note:
> Don’t create a ``doc://com.apple.tvuikit/documentation/TVUIKit/TVLockupView`` directly. Instead, create an instance of the subclass that best suits your use case, such as ``doc://com.apple.tvuikit/documentation/TVUIKit/TVPosterView`` or ``doc://com.apple.tvuikit/documentation/TVUIKit/TVCardView``.

## Topics

### Setting view size

[`contentSize`](/documentation/TVUIKit/TVLockupView/contentSize)

The size of the content view.

[`contentViewInsets`](/documentation/TVUIKit/TVLockupView/contentViewInsets)

The spacing between the content view and its peer and containing views.

[`focusSizeIncrease`](/documentation/TVUIKit/TVLockupView/focusSizeIncrease)

The inset or outset values specifying your content’s size increase when in focus.

### Adding subviews

[`contentView`](/documentation/TVUIKit/TVLockupView/contentView)

The main view for the lockup.

[`headerView`](/documentation/TVUIKit/TVLockupView/headerView)

A view containing header information.

[`footerView`](/documentation/TVUIKit/TVLockupView/footerView)

A view containing footer information.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)