CKEditor 5 widget API
This package implements the widget API for CKEditor 5.
The API consists of a few primitives and helpers that make it easy to implement rich content units such as images with captions.
# Documentation
Browse the API documentation of this package by using the module tree on the left.
The widget API consists of two layers:
- The
Widget
plugin that enables base support for this feature. Usually, your plugin which implements a specific widget will define its reliance on theWidget
plugin via itsPlugin.requires
property. - The
toWidget()
andtoWidgetEditable()
functions. You need to use them during the conversion to make a specific element either a widget or its nested editable. See their documentation for more details.
Besides these mentioned core functionalities, this package implements the following utilities:
- The
WidgetToolbarRepository
plugin which exposes a nice API for registering widget toolbars. - A few helper functions for managing widgets in the
@ckeditor/ckeditor5-widget/utils
module.
The widget API is proposed in a different way than it was in CKEditor 4. It is just a set of utilities that allow you to implement typical object-like entities. Most of the work actually happens in the engine and this API’s only role is to control it.
# Installation
This package is part of our open-source aggregate package.
npm install ckeditor5
# Contribute
The source code of this package is available on GitHub in https://github.com/ckeditor/ckeditor5/tree/master/packages/ckeditor5-widget.
# External links
Every day, we work hard to keep our documentation complete. Have you spotted outdated information? Is something missing? Please report it via our issue tracker.
With the release of version 42.0.0, we have rewritten much of our documentation to reflect the new import paths and features. We appreciate your feedback to help us ensure its accuracy and completeness.