XFDF Support

XFDF is an XML-like standard from Adobe XFDF for encoding annotations and forms (see this XFDF overview). It is compatible with Adobe Acrobat and several other third-party frameworks.

ℹ️ Note: XFDF has various limitations. In most cases, using PSPDFKit Instant will result in a smaller file and better synchronization.

PSPDFKit for iOS supports both reading and writing XFDF. It also offers an annotation provider subclass — PSPDFXFDFAnnotationProvider — that will save/load annotations to/from XFDF automatically.

Parsing XFDF

To read from XFDF file:

Swift
Copy
1
2
3
4
5
6
7
8
9

// Load from an example XFDF file.
let fileXML = URL(fileURLWithPath: "path/to/XFDF.xfdf")

// Create document and set up the XFDF provider.
let document = PSPDFDocument()
document.didCreateDocumentProviderBlock = {(_ documentProvider: PSPDFDocumentProvider) -> Void in
    let XFDFProvider = PSPDFXFDFAnnotationProvider(documentProvider: documentProvider, fileURL: fileXML)
    documentProvider.annotationManager.annotationProviders = [XFDFProvider]
}
Objective-C
Copy
1
2
3
4
5
6
7
8
9

// Load from an example XFDF file.
NSURL *fileXML = [NSURL fileURLWithPath:[docsFolder stringByAppendingPathComponent:@"XFDFTest.xfdf"]];

// Create document and set up the XFDF provider.
PSPDFDocument *document = [[PSPDFDocument alloc] initWithURL:documentURL];
document.didCreateDocumentProviderBlock = ^(PSPDFDocumentProvider *documentProvider) {
    PSPDFXFDFAnnotationProvider *XFDFProvider = [[PSPDFXFDFAnnotationProvider alloc] initWithDocumentProvider:documentProvider fileURL:fileXML];
    documentProvider.annotationManager.annotationProviders = @[XFDFProvider];
};

Exporting to XFDF

You can export annotations and form fields from the document to an XFDF file like so:

Swift
Copy
1
2
3
4
5
6
7
8
9
10
11
12

// Collect all existing annotations from the document
let annotations = document.allAnnotations(of: .all).values.flatMap { $0 }

// Write the file
guard let dataSink = try? PSPDFFileDataSink(fileURL: fileXML, options: []) else {
    abort()
}
do {
    try PSPDFXFDFWriter().write(annotations, to: dataSink, documentProvider: document.documentProviders.first!)
} catch {
    print("Failed to write XFDF file: \(error.localizedDescription))")
}
Objective-C
Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14

// Collect all existing annotations from the document
NSMutableArray<PSPDFAnnotation *> *annotations = [NSMutableArray<PSPDFAnnotation *> array];
for (NSArray<PSPDFAnnotation *> *pageAnnotations in [document allAnnotationsOfType:PSPDFAnnotationTypeAll].allValues) {
    [annotations addObjectsFromArray:pageAnnotations];
}

// Write the file
NSError *error;
PSPDFFileDataSink *dataSink = [[PSPDFFileDataSink alloc] initWithFileURL:fileXML options:PSPDFDataSinkOptionNone error:&error];
if (dataSink) {
    if (![[PSPDFXFDFWriter new] writeAnnotations:annotations toDataSink:dataSink documentProvider:tempDocument.documentProviders[0] error:&error]) {
        NSLog(@"Failed to write XFDF file: %@", error.localizedDescription);
    }
}

Was this page helpful? We're happy to answer any questions.

The PSPDFKit SDK is a framework that allows you to view, annotate, sign, and fill PDF forms on iOS, Android, Windows, macOS, and Web. PSPDFKit Instant adds real-time collaboration features to seamlessly share, edit, and annotate PDF documents.