<!--
{
  "availability" : [
    "iOS: 11.0.0 -",
    "iPadOS: 11.0.0 -",
    "macCatalyst: 13.1.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "UIKit",
  "identifier" : "/documentation/UIKit/UIDocumentBrowserTransitionController",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "UIKit"
    ],
    "preciseIdentifier" : "c:objc(cs)UIDocumentBrowserTransitionController"
  },
  "title" : "UIDocumentBrowserTransitionController"
}
-->

# UIDocumentBrowserTransitionController

An object that implements the standard loading and transition animations for a document browser.

```
@MainActor class UIDocumentBrowserTransitionController
```

## Overview

Each transition controller is associated with a document in the document browser. The transition controller can provide two separate animation sequences for this document:

- If you set the [`loadingProgress`](/documentation/UIKit/UIDocumentBrowserTransitionController/loadingProgress) property, the document browser shows the loading progress in the document’s thumbnail.
- If you set the [`targetView`](/documentation/UIKit/UIDocumentBrowserTransitionController/targetView) property, the transition controller acts as a [`UIViewControllerAnimatedTransitioning`](/documentation/UIKit/UIViewControllerAnimatedTransitioning) object, providing a custom transition between the document’s thumbnail and the target view. This transitioning object can be used both when presenting and when dismissing the document.

You don’t instantiate instances of [`UIDocumentBrowserTransitionController`](/documentation/UIKit/UIDocumentBrowserTransitionController) yourself. Instead, call the document browser’s [`transitionController(forDocumentURL:)`](/documentation/UIKit/UIDocumentBrowserViewController/transitionController(forDocumentURL:)) method to get a transition controller for the specified document.

> Note:
> In Mac apps built with Mac Catalyst, the transition controller doesn’t trigger animations because the macOS design doesn’t use animations for opening or closing documents.

## Topics

### Animating transitions

[`loadingProgress`](/documentation/UIKit/UIDocumentBrowserTransitionController/loadingProgress)

A progress object that tracks a document as it loads.

[`targetView`](/documentation/UIKit/UIDocumentBrowserTransitionController/targetView)

The target view for transition animations when presenting or dismissing the transition controller’s document.

## See Also

[`UIDocumentBrowserViewController`](/documentation/UIKit/UIDocumentBrowserViewController)

A view controller for browsing and performing actions on documents that you store locally and in the cloud.


---

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)