---

WebDocumentRepresentation Protocol Reference

Overview

This protocol is adopted by document representation classes that handle specific MIME types. You can implement your own document view classes and document representation classes to render data for specific MIME types, and register those classes using the WebFrame registerViewClass:representationClass:forMIMEType: method.

Tasks

Setting the Data Source

• – setDataSource:

Loading Content

• – receivedData:withDataSource:
• – receivedError:withDataSource:
• – finishedLoadingWithDataSource:

Getting Document Source

• – canProvideDocumentSource
• – documentSource

Getting the Document Title

• – title

Instance Methods

canProvideDocumentSource

Returns whether the receiver can provide content source.

- (BOOL)canProvideDocumentSource

Discussion

This method returns YES if the receiver can provide source for the document content (for example, HTML source), NO otherwise.

Availability

• Available in Mac OS X v10.2 with Safari 1.0 and later.
• Available in Mac OS X v10.2.7 and later.

See Also

• – documentSource

Declared In

WebDocument.h

documentSource

Returns the receiver’s source as text.

- (NSString *)documentSource

Discussion

For example, for HTML documents, returns the HTML source.

Availability

• Available in Mac OS X v10.2 with Safari 1.0 and later.
• Available in Mac OS X v10.2.7 and later.

See Also

• – canProvideDocumentSource

Declared In

WebDocument.h

finishedLoadingWithDataSource:

Invoked when a data source finishes loading its content.

- (void)finishedLoadingWithDataSource:(WebDataSource *)dataSource

Availability

• Available in Mac OS X v10.2 with Safari 1.0 and later.
• Available in Mac OS X v10.2.7 and later.

See Also

• – setDataSource:

Declared In

WebDocument.h

receivedData:withDataSource:

Invoked when a data source has received some data.

- (void)receivedData:(NSData *)data withDataSource:(WebDataSource *)dataSource

Discussion

Data is loaded incrementally so this method may be invoked multiple times.

Availability

• Available in Mac OS X v10.2 with Safari 1.0 and later.
• Available in Mac OS X v10.2.7 and later.

See Also

• – receivedError:withDataSource:

Declared In

WebDocument.h

receivedError:withDataSource:

Invoked when a data source receives an error loading its content.

- (void)receivedError:(NSError *)error withDataSource:(WebDataSource *)dataSource

Discussion

The error argument contains details on the error that occurred.

Availability

• Available in Mac OS X v10.2 with Safari 1.0 and later.
• Available in Mac OS X v10.2.7 and later.

See Also

• – receivedData:withDataSource:

Declared In

WebDocument.h

setDataSource:

Sets the receiver’s data source.

- (void)setDataSource:(WebDataSource *)dataSource

Discussion

This method is invoked soon after the document representation is created.

Availability

• Available in Mac OS X v10.2 with Safari 1.0 and later.
• Available in Mac OS X v10.2.7 and later.

See Also

• – finishedLoadingWithDataSource:

Declared In

WebDocument.h

title

Returns the receiver’s document title.

- (NSString *)title

Availability

• Available in Mac OS X v10.2 with Safari 1.0 and later.
• Available in Mac OS X v10.2.7 and later.

Declared In

WebDocument.h

---