Contribute to this guide

guideDeep dive into widget internals

# Disabling the widget type around feature

The WidgetTypeAround plugin allows users to type around the widgets, in places where it is normally impossible to place the caret due to limitations of the web browsers. Although this feature boosts the productivity and ease of typing, some integrations may not want or need it, for instance:

  • When the UI of the feature collides with the integration.
  • When typing outside widgets should be impossible (content made exclusively of widgets).
  • When certain widgets have a fixed location in the document that should never change.

In the sections that follow, you will learn how to configure CKEditor 5 WYSIWYG editor to address these specific needs.

# Hiding the buttons that insert paragraphs around widgets

A screenshot showing the location of the buttons that insert paragraphs around widgets.

The easiest way to get rid of the type around widget buttons is to hide them using CSS. Put the following code snippet anywhere in your application and the buttons will no longer be displayed:

.ck.ck-editor__editable .ck-widget .ck-widget__type-around__button {
    display: none;
}

If you only want to customize the type around widget buttons, you can use the same CSS selector to modify their look or position.

Hiding the type around widget buttons does not disable the feature. Users will still be able to activate the caret before or after individual widgets using the arrow keys and typing. Learn how to disable the entire feature.

# Disabling the entire feature

Although the WidgetTypeAround plugin is an integral part of the widget subsystem and is loaded by default whenever an editor feature uses widgets (for instance, for images or tables), you can still disable it on the fly. Turning off the feature will both hide the widget buttons and disable other behaviors, for instance:

  • The caret will not be rendered before or after a widget when the user navigates the document using arrow keys.
  • The Enter and Shift+Enter keystrokes will no longer insert paragraphs if pressed when a widget is selected.

Use the forceDisabled() method of the plugin to disable it on the fly like in the snippet below:

ClassicEditor
    .create( document.querySelector( '#editor' ), {
        // ...
    } )
    .then( editor => {
        const widgetTypeAroundPlugin = editor.plugins.get( 'WidgetTypeAround' );

        // Disable the widget type around plugin.
        widgetTypeAroundPlugin.forceDisabled( 'MyApplication' );
    } )
    .catch( err => {
        console.error( err.stack );
    } );

You can always re–enable the plugin using the following snippet

widgetTypeAroundPlugin.clearForceDisabled( 'MyApplication' );

Refer to the API documentation to learn more.