CKEditor Ecosystem Documentation
Search
Home/CKEditor 5/API
Interface

CommentsConfig (comments)

@ckeditor/ckeditor5-comments/src/comments

interface

The configuration of the comments feature.

ClassicEditor
	.create( {
		comments: ... // Comments feature configuration.
	} )
	.then( ... )
	.catch( ... );

See all editor options.

Filtering

Properties

  • CommentThreadView : BaseCommentThreadView

    A view class to be used to create comment thread views (used as annotations - in sidebar balloons or in inline annotations).

    CommentThreadView is used by default when this property is not set.

  • CommentView : BaseCommentView

    A view class to be used to create comment views.

    CommentView is used by default when this property is not set.

  • editorConfig : EditorConfig

    Configuration for the comments editor.

    By using this property, you can customize the editor instance used in the comments reply field (e.g. by adding plugins or changing features configuration).

    To use the default configuration (allows only for text input, no formatting), you can pass {} to the comments editor configuration.

    ClassicEditor.create( element, {
	comments: {
		editorConfig: {}
	}
} );

    To provide a better experience, you may add more plugins, that will extend the default editor configuration.

    import Autoformat from '@ckeditor/ckeditor5-autoformat/src/autoformat';
import List from '@ckeditor/ckeditor5-list/src/list';
import Bold from '@ckeditor/ckeditor5-basic-styles/src/bold';
import Italic from '@ckeditor/ckeditor5-italic/src/italic';

ClassicEditor.create( element, {
	comments: {
		editorConfig: {
			extraPlugins: [ Autoformat, Bold, Italic, List ]
		}
	}
} );

    Importing plugins may not be possible in some scenarios (e.g. when using a build created by the online builder tool). In that case, it is possible to get the plugin constructors from the editor builtin plugins.

    const extraCommentsPlugins = ClassicEditor.builtinPlugins.filter( plugin => {
	return [ 'Bold', 'Italic', Autoformat, List ].includes( plugin.pluginName );
} );

ClassicEditor.create( element, {
	comments: {
		editorConfig: {
			extraPlugins: extraCommentsPlugins
		}
	}
} );

  • maxCommentCharsWhenCollapsed : Number

    The maximum number of characters displayed in a comment when the thread view is collapsed. Longer comments will be trimmed.

    Defaults to 140.

  • maxThreadTotalWeight : Number

    The maximum total weight of a thread before the thread becomes collapsed when it is not active:

    • Thread weight is a sum of the weight of its comments.
    • Comment weight is equal to the comment length.
    • The minimal comment weight is 200.

    Defaults to 500.

  • whenCollapsed : Number

    The total number of comments shown when the thread view is collapsed.

    The comments are displayed in the following way:

    • The first comment is displayed.
    • Some comments may be hidden (collapsed).
    • An appropriate number of the most recent comments is displayed.

    For example, when this parameter is set to 3, when collapsed, the thread view will display the first comment and two most recent comments.

    Defaults to 2.