React Native Webview Quilljs

Quill.js editor and viewer components with no native code for React Native apps built using Expo.

Try it in Expo

Link to Expo Project Page

Installation

npm install --save react-native-webview-quilljs

or

yarn add react-native-webview-quilljs

and then

import {WebViewQuillEditor, WebViewQuillViewer} from 'react-native-webview-quilljs'

Usage

This package can be used to create both an editor and a viewer

Creating a Quill.js editor with the standard toolbar:

 <WebViewQuillEditor
    ref={component => (this.webViewQuillEditor = component)}
    getDeltaCallback={this.getDeltaCallback}
    contentToDisplay={contentToDisplay}
    onLoad={this.onLoadCallback}
  />

This component accepts the following props:

Name	Required	Description
ref	yes	A reference to the editor component to be used to retrieve its contents using this.webViewQuillEditor.getDelta();
getDeltaCallback	no	Function called in response to a call to this.webViewQuillEditor.getDelta(). It will receive a Delta object containing the contents of editor
contentToDisplay	no	A Quill delta that will be displayed by the editor when it loads. A deltas is an array describing the content and formatting of the message. See delta details here
onLoad	no	A function called when the Editor finishes loading
onDeltaChangeCallback	no	Function called when the contents of Quill editor have changed. The function receives a delta containing the following arguments:

deltaChange   // changes to the delta
delta         // delta contents as received by getContents() mothod
deltaOld      // the previous contents of the editor
changeSource  // source of change (user, api, etc.)

Further information on what is returned is described in the Quill.js API documentation | | backgroundColor| no | String that equates to a valid CSS color value that the background of the editor will be set to| |getEditorCallback| no | A function that will receive the Quill.js editor as an arguement |

Creating a Delta viewer that can display content created with Quill.js:

<WebViewQuillViewer
    ref={component => (this.webViewQuillViewer = component)}
    contentToDisplay={this.state.messageDelta}
    onLoad={this.onLoadCallback}
  />

This component accepts the following props:

Name	Required	Description
ref	yes	A reference to the editor component to be used to update its contents using this.webViewQuillViewer.sendContentToViewer(delta);
contentToDisplay	no	A Quill delta that will be displayed by the viewer when it loads. A deltas is an array describing the content and formatting of the message. See delta details here
onLoad	no	A function called when the Editor finishes loading
backgroundColor	no	String that equates to a valid CSS color value that the background of the viewer will be set to
getViewerCallback	no	A function that will receive the Quill.js viewer as an argument

Changelog

0.8.3

• Updated onChangeCallback to receive the changes, contents, and previous contents of the delta

0.8.0

• Removes the propType specification for contentToDisplay to address issue #19

0.6.5

• Added initial testing framework

0.6.0

• Removed requirement to download JavaScript files from GitHub in order for the package to work. JavaScript files are now inline with the HTML which enables the package to work without an Internet connection.
• Added getViewerCallback and getEditorCallback

0.4.4

• Changed HTTP path for files to be downloaded in preparation for potential inline JS bundling or Expo Packager bundling of files.

0.4.0

• Added "backgroundColor" props for both the WebViewQuillViewer and WebViewQuillEditor

0.3.20

• Added copy and paste of HTML

0.3.10

• Revert file access features from 0.3.0.

0.3.0

• Library no longer relies on accessing WebView files from the Internet. All files needed by both the Editor and Viewer are included with the packages.
• Fonts display correctly on iOS devices

0.2.5

• Added onDeltaChangeCallback property to Editor

LICENSE

MIT