Interface CommentController

A comment controller is able to provide comments support to the editor and provide users various ways to interact with comments.

interface CommentController {
    commentingRangeProvider?: CommentingRangeProvider;
    id: string;
    label: string;
    options?: CommentOptions;
    reactionHandler?: ((comment, reaction) => Thenable<void>);
    createCommentThread(uri, range, comments): CommentThread;
    dispose(): void;
}

Properties

commentingRangeProvider?: CommentingRangeProvider

Optional commenting range provider. Provide a list ranges which support commenting to any given resource uri.

If not provided, users can leave comments in any document opened in the editor.

id: string

The id of this comment controller.

label: string

The human-readable label of this comment controller.

options?: CommentOptions

Comment controller options

reactionHandler?: ((comment, reaction) => Thenable<void>)

Optional reaction handler for creating and deleting reactions on a comment.

Type declaration

Methods

  • Create a comment thread. The comment thread will be displayed in visible text editors (if the resource matches) and Comments Panel once created.

    Parameters

    • uri: Uri

      The uri of the document the thread has been created on.

    • range: Range

      The range the comment thread is located within the document.

    • comments: Comment[]

      The ordered comments of the thread.

    Returns CommentThread