Options
All
  • Public
  • Public/Protected
  • All
Menu

Class TreeItem2

Hierarchy

Index

Constructors

constructor

Properties

Optional collapsibleState

collapsibleState: None | Collapsed | Expanded

TreeItemCollapsibleState of the tree item.

Optional command

command: Command

The command which should be run when the tree item is selected.

Optional contextValue

contextValue: string

Context value of the tree item. This can be used to contribute item specific actions in the tree. For example, a tree item is given a context value as folder. When contributing actions to view/item/context using menus extension point, you can specify context value for key viewItem in when expression like viewItem == folder.

   "contributes": {
       "menus": {
           "view/item/context": [
               {
                   "command": "extension.deleteFolder",
                   "when": "viewItem == folder"
               }
           ]
       }
   }

This will show action extension.deleteFolder only for items with contextValue is folder.

Optional description

description: string | boolean

A human readable string which is rendered less prominent. When true, it is derived from resourceUri and when falsy, it is not shown.

Optional iconPath

iconPath: string | Uri | ThemeIcon | { dark: string | Uri; light: string | Uri }

The icon path or ThemeIcon for the tree item. When falsy, Folder Theme Icon is assigned, if item is collapsible otherwise File Theme Icon. When a ThemeIcon is specified, icon is derived from the current file icon theme for the specified theme icon using resourceUri (if provided).

Optional id

id: string

Optional id for the tree item that has to be unique across tree. The id is used to preserve the selection and expansion state of the tree item.

If not provided, an id is generated using the tree item's label. Note that when labels change, ids will change and that selection and expansion state cannot be kept stable anymore.

Optional label

label: any

Label describing this item. When falsy, it is derived from resourceUri.

Optional resourceUri

resourceUri: Uri

The uri of the resource representing this item.

Will be used to derive the label, when it is not provided. Will be used to derive the icon from current icon theme, when iconPath has ThemeIcon value.

Optional tooltip

tooltip: string

The tooltip text when you hover over this item.