ZSSRichTextEditor Documentation

You can install ZSSRichTextEditor using CocoaPods or by manually adding the source to your project.

Requirements:

• iOS 7 or later
• CoreGraphics.framework
• CoreText.framework

Manual Installation Steps:

1. Copy the Source folder to your project.
2. Subclass ZSSRichTextEditor.

CRITICAL XCode Configuration: When adding the files manually, XCode may automatically add ZSSRichTextEditor.js to your 'Compile Sources' build phase. This will prevent the editor from working correctly. You must remove ZSSRichTextEditor.js from 'Compile Sources' and add it to 'Copy Bundle Resources' instead.

To listen for changes in the editor content, set receiveEditorDidChangeEvents = YES; in your viewDidLoad. You can then implement the editorDidChangeWithText:andHTML: method to receive updates for both plain text and HTML.

// In viewDidLoad
self.receiveEditorDidChangeEvents = YES;

// Implementation
- (void)editorDidChangeWithText:(NSString *)text andHTML:(NSString *)html {
    NSLog(@"Text Has Changed: %@", text);
    NSLog(@"HTML Has Changed: %@", html);
}

You can extend the toolbar by adding custom UIButton instances. Use addCustomToolbarItemWithButton: to register the button.

```objective-c
UIButton *myButton = [[UIButton alloc] initWithFrame:CGRectMake(0.0f, 0.0f, buttonWidth, 28.0f)];
[myButton setTitle:@

If you want to use an alternate method for selecting images or links (e.g., picking from the camera roll), override the following methods in your ZSSRichTextEditor subclass. When the user taps the alternate picker icon (crosshair) in the toolbar, these methods are called.

- (void)showInsertURLAlternatePicker {
    [self dismissAlertView];
    // Show your custom picker
}

- (void)showInsertImageAlternatePicker {
    [self dismissAlertView];
    // Show your custom picker
}

You can manually insert links or images at the current cursor position using these methods:

• insertImage:alt:: Inserts an image using a URL and an alt text string.
• insertLink:title:: Inserts a link using a URL and a title string.

Use the following methods to interact with the editor's content:

• setHTML:: Sets the initial HTML content.
• getHTML: Returns the current content as an NSString.
• insertHTML:: Inserts a specific HTML string at the current caret position.
• setPlaceholder:: Sets a placeholder string to display when there is no content.

```objective-c
// Set the initial HTML for the editor
[self setHTML:html];

// Returns an NSString
[self getHTML];

// Insert HTML at the current caret position
NSString *html = @"<strong>I love cats!</strong>";
[self insertHTML:html];

// Set A Placeholder
[self setPlaceholder:@

The editor can recognize hashtags and mentions. Override these methods in your subclass to respond to them:

• hashtagRecognizedWithWord:: Called when a hashtag is identified.
• mentionRecognizedWithWord:: Called when a mention is identified.

- (void)hashtagRecognizedWithWord:(NSString *)word {
    NSLog(@"Hashtag has been recognized: %@", word);
}

- (void)mentionRecognizedWithWord:(NSString *)word {
    NSLog(@"Mention has been recognized: %@", word);
}

You can inject custom CSS into the editor to style elements like links or hover states using setCSS:.

NSString *customCSS = @"a {text-decoration:none;} a:hover {color:#FF0000;}";
[self setCSS:customCSS];