Nested NSDocuments

What's New


  • add an async API for openDocument

Carthage compatible


ContainedDocument allows you to nest NSDocument instances inside of abstract containers. These can be anything you need, including other NSDocument instances. This turns out to be a very tricky thing to do, and requires careful management of an NSDocumentController to make it possible.

Supporting the full range of NSDocument operations and interactions is challenging. I was able to pull off many of them, but the coordination still requires subclassing both NSDocument and NSDocumentController.



You can use Carthage to intall this as a static library.

github "ChimeHQ/ContainedDocument"

Swift Package Manager:

dependencies: [
    .package(url: "")



An NSDocumentController subclass that manages the NSDocument lifecycle and manages the relationship to your containers. To use it, you must override the three container-document association methods. Restorable state is supported, but is optional.

open func associateDocument(_ document: NSDocument, to container: Container)
open func disassociateDocument(_ document: NSDocument)
open func documentContainer(for document: NSDocument) -> Container?

open func encodeRestorableState(with coder: NSCoder, for document: NSDocument)
open func restoreState(with coder: NSCoder, for document: NSDocument)
// ...


This is an NSDocument subclass that makes it possible to support document duplication and window restoration.

Suggestions or Feedback

We'd love to hear from you! Get in touch via twitter, an issue, or a pull request.

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.


  • Swift Tools 5.0.0
View More Packages from this Author


  • None
Last updated: Tue Nov 08 2022 02:41:49 GMT-0500 (GMT-05:00)