v9.3.0

Features

• Experimental: Better error messages in useCKEditorCloud. It now detects existing editor installations and gives migration info from NPM to CDN. (commit)

Other changes

• Remove ckeditor5-premium-features from peerDependencies. (commit)

v9.2.0

Features

• Experimental: Improve result type of useCKEditorCloud to make CKEditorPremiumFeatures and CKBox non-nullable when proper configuration is passed. (commit)

Other changes

• Experimental: Rename the languages configuration property to translations in useCKEditorCloud. (commit)

v9.1.0

We added an onChangeInitializedEditors callback to CKEditorContext component to allow tracking newly initialized editors within the JSX React tree.

Example

<CKEditorContext
  context={ ClassicEditor.Context }
  contextWatchdog={ ClassicEditor.ContextWatchdog }
  onChangeInitializedEditors={ editors => {
    console.log( editors );
  }}
>
  <CKEditor
    editor={ ClassicEditor }
    data="<h2>Editor</h2>"
    contextItemMetadata={{
      name: 'editor1',
      user: { id: '2' }
    }}
  />

  <CKEditor
    editor={ ClassicEditor }
    data="<h2>Another Editor</h2><p>... in a common Context</p>"
    contextItemMetadata={{
      name: 'editor2'
    }}
  />
</CKEditorContext>

onChangeInitializedEditors will be called twice in the example above:

1. First log: { editor1: ... }
2. Second log: { editor1: ..., editor2: ... }

⚠️ Order of initialization is not guaranteed. editor2 might be initialized before editor1.

Features

• Add an onChangeInitializedEditors callback to CKEditorContext to allow tracking of newly initialized editors within the JSX React tree. Closes #513. (commit)
• Experimental: Added useCKEditorCloud hook for managing asynchronous loading of CKEditor from a CDN. (commit)
• Experimental: Added withCKEditorCloud HOC to simplify CKEditor integration with CDN in React components. (commit)

Bug fixes

• Image upload should be now possible in demos. (commit)
• Indent button is no longer disabled in manual demos. (commit)
• Manual demos should point to existing documentation links. (commit)

v9.0.0

We are excited to announce a new major release of the React integration.

In this release, we have introduced the following breaking changes that should make using the integration more intuitive and easier.

• ESM-first: Besides the UMD build, the integration is now available in ESM format. In most projects, the new ESM build should be automatically prioritized by bundlers and other tools.
• Support for React 19: We improved support for using the integration in React 19. As a result, the <CKEditorContext> component and the useMultiRootEditor hook should no longer throw errors.
• New name of the global variable: The name of the global variable used in the UMD build changed from CKEditor to CKEDITOR_REACT.

BREAKING CHANGES

• Change the global name used in the UMD build from CKEditor to CKEDITOR_REACT.
• onReady in the CKEditorContext behavior has been changed after fixing race conditions in our integration introduced with the newest React versions. Presently, onReady is called after initialization of Context, and then we attach editors to it.

Bug fixes

• Adjusted CKEditorContext format to prevent race conditions in the CKEditor component. (commit)
• Change JSX runtime to classic so that react-jsx-runtime is not bundled. (commit)
• Change the global name used in the UMD build from CKEditor to CKEDITOR_REACT to match the new convention. See ckeditor/ckeditor5#16736. (commit)

Other changes

• Added support for React 19. (commit)
• Updated yarn.lock to fix dependabot alert. (commit)

v9.0.0-alpha.1

BREAKING CHANGES

• Change the global name used in the UMD build from CKEditor to CKEDITOR_REACT.

Bug fixes

• Change JSX runtime to classic so that react-jsx-runtime is not bundled. (commit)
• Change the global name used in the UMD build from CKEditor to CKEDITOR_REACT to match the new convention. See ckeditor/ckeditor5#16736. (commit)

v9.0.0-alpha.0

We are excited to announce the alpha release of the next major version of the React integration.

In this release, we have introduced the following breaking changes that should make using the integration more intuitive and easier.

• ESM-first: Besides the UMD build, the integration is now available in ESM format. In most projects, the new ESM build should be automatically prioritized by bundlers and other tools.
• Support for React 19: We improved support for using the integration in React 19. As a result, the <CKEditorContext> component and the useMultiRootEditor hook should no longer throw errors.

BREAKING CHANGES

• Migrate to ESM. See ckeditor/ckeditor5#16616.

Bug fixes

• Adjusted CKEditorContext format to prevent race conditions in the CKEditor component. (commit)

Other changes

• Added support for React 19. (commit)

v8.0.0

We are excited to announce the next major version of the React integration.

This release is intended to allow the integration to work with the latest version of new installation methods.

v8.0.0-alpha.0

We are happy to announce the alpha release of the next major version of the React integration.

This release is intended to allow the integration to work with existing and new installation methods announced in this post.

Please refer to our nightly documentation build for the installation instructions.

BREAKING CHANGES

• Add a new required contextWatchdog prop to the <CKEditorContext> component.

Features

• Change the implementation to only depend on types from the ckeditor5 package and not runtime code to make the integration work with existing and new installation methods. (commit)

v7.0.0

Bug fixes

• The quick re-rendering, especially in React.StrictMode, will no longer cause the editor errors. Closes #442, #469, #471, #476. (commit)

v6.3.0

Features

• Introduced the disableTwoWayDataBinding flag which disabled the two-way binding between the multi-editor and React state. Please read a new guide explainig the useMultiRootEditor() hook. Closes #457. (commit)

Bug fixes

• The toolbar element will be rendered correctly after changing the reference (in the rerendering process). Closes #434. (commit)
• Sources of peer dependencies of the @ckeditor/ckeditor5-react package are no longer built-in when preparing the dist/ directory. See #470. (commit)