v3.0.0

BREAKING CHANGES

• The onInit property was renamed to onReady and can be called multiple times (after the initialization and after the component is ready when an error occurred).

• The entry point of the package has changed. The default import was removed since the package provides more than a single component now. Use

  import { CKEditor } from '@ckeditor/ckeditor5-react';

  instead of

  import CKEditor from '@ckeditor/ckeditor5-react';

Features

• Support for the config.initialData option in the configuration object when creating the <CKEditor> component. When passing the [data] property and the initialData value in the configuration object, the later one will take precedence and a warning message will be logged on the console. (commit)

• The <CKEditor> component contains the built-in watchdog feature. Closes #118. (commit)

• Introduced the <CKEditorContext> component that supports the context feature. (commit)

• Added the id property which is used to distinguish different documents. When this property changes, the component restarts the underlying editor instead of setting data on it, which allows e.g. for switching between collaboration documents and fixes a couple of issues (e.g. the onChange event no longer fires during changing the document). Closes #168, #169. (commit)

• The onError() callback will be called with two arguments. The first one will be an error object (as it was before the release 3+). A second argument is an object that contains two properties:. (commit)

  • {String} phase: 'initialization'|'runtime' - Informs when the error has occurred (during the editor/context initialization or after the initialization).

  • {Boolean} willEditorRestart - When true, it means that the editor component will restart itself.

  • {Boolean} willContextRestart - When true, it means that the context component will restart itself.

    The willEditorRestart property will not appear when the error has occurred in the context feature.
    The willContextRestart property will not appear when the error has occurred in the editor.

Both components (<CKEditor> and <CKEditorContext>) will internally use the Watchdog class that restarts the editor or context when an error occurs.

v2.1.0

Features

• Introduced support for onError callback that is being called if an error occurred during the editor's initialization. Closes #123. (becf9f7)

  Thanks to @ansorensen.

v2.0.0

Other changes

• <CKEditor> React component will be distributed in ES6 instead of ES5. Closes #105. (ec34041)
• Removed the BrowserStack integration from this repository. See ckeditor/ckeditor5#1742. (2379fbf)

BREAKING CHANGE

• <CKEditor> React component is now distributed in ES6 instead of ES5. See #105.

v1.1.3

Bug fixes

• The <CKEditor> component will not update anything until it is not ready. Closes #83. (63cb97d)

v1.1.2

Bug fixes

• The <CKEditor> component will not be updated by React itself. The editor won't freeze if the #data property was specified as a static string. Closes #75. Closes #78. (bdb2ce3)

v1.1.1

Bug fixes

• Fixed integration with collaboration features by changing the way how the initial data are passed to an editor instance. Previously the <ckeditor> component had been using the editor.setData() method which produces invalid results in collaboration. Now the initial data are injected directly into the container on which the editor will be created. Closes #68. (1c93b3e)

Other changes

• Added minimal versions of Node and npm. See: ckeditor/ckeditor5#1507. (7b1777c)

v1.1.0

Features

• Introduced onFocus and onBlur properties to the <CKEditor> component. Closes #49. (97d05c9)
• Introduced the disabled property which allows switching the editor to the read-only mode. Closes #53. (6765006)

Bug fixes

• Prevented an infinite loop when the data property is missing. Closes #39. (e16430a)

v1.0.0

Internal changes only (updated dependencies, documentation, etc.).

v1.0.0-beta.1

First developer preview. It contains ready-to-use <CKEditor> component that allows using CKEditor 5 Builds and CKEditor 5 Framework in React applications.