npm @ckeditor/ckeditor5-vue 7.0.0-alpha.0

latest releases: 7.2.0, 7.1.0, 7.1.0-alpha.0...
3 months ago

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

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

  • Composition API: The integration has been rewritten in Composition API, which follows the recommended way of writing components in Vue 3.

  • Vue 3.4+: The minimum required version of Vue is now 3.4+ because we are using the Generics and defineModel() features to provide better typings for the editor prop and component events.

  • 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.

  • Changed exports: We have changed how the Vue plugin and component are exported. The Vue plugin is no longer the default export but is exported as CKEditorPlugin. The component is now exported as CKEditor instead of default.component.

    Here's a comparison of how you can import the Vue plugin that registers a global <ckeditor> component:

     // Before the release.
     import CKEditor from '@ckeditor/ckeditor5-vue';
     
     // After the release.
     import { CKEditorPlugin } from '@ckeditor/ckeditor5-vue';

    If you prefer to use a local component instead of a global component, here's a comparison of how you can import it:

    // Before the release.
    import CKEditor from '@ckeditor/ckeditor5-vue';
    
    const component = CKEditor.component;
    
    // After the release.
    import { CKEditor } from '@ckeditor/ckeditor5-vue';
    
    const component = CKEditor;
  • Remove the editor argument from the destroy event: The destroy event no longer has an editor argument since it was always null.

BREAKING CHANGES

  • The @ckeditor/ckeditor5-vue package requires Vue 3.4+. See #282.
  • Export the component as CKEditor instead of default.component. Closes #284.
  • Migrate to Composition API. Closes #172.
  • Migrate to ESM. See ckeditor/ckeditor5#16616.
  • Remove the argument from the destroy event, as it was always null. Closes #283.
  • Replace the default export with named CKEditorPlugin export.

Bug fixes

  • Use the type of the passed editor prop rather than generic Editor type. Closes #282. (commit)

Other changes

  • Add UMD for better backward compatibility. (commit)
  • Updated yarn.lock to fix dependabot alert. (commit)

Don't miss a new ckeditor5-vue release

NewReleases is sending notifications on new releases.