Skip to main content

Interface: CustomPick<T>

Defined in: packages/extension-api/src/extension-api.d.ts:1663

A concrete CustomPick to let the user pick an item from a list of items of type T. The items are rendered using a custom UI.

Type Parameters

T

T extends CustomPickItem

Properties

canSelectMany

canSelectMany: boolean

Defined in: packages/extension-api/src/extension-api.d.ts:1683

If multiple items can be selected at the same time. Defaults to false.


description?

optional description: string

Defined in: packages/extension-api/src/extension-api.d.ts:1671

An optional human-readable string which is rendered less prominent in a separate line.


hideItemSections

hideItemSections: boolean

Defined in: packages/extension-api/src/extension-api.d.ts:1689

If the additional sections of an item should be hidden by default when the dialog opens up. The user can still open them by clicking on the 'show more' button. Defaults to false.


icon?

optional icon: string | { dark: string; light: string; }

Defined in: packages/extension-api/src/extension-api.d.ts:1675

An optional base64 PNG image


items

items: T[]

Defined in: packages/extension-api/src/extension-api.d.ts:1679

Items to pick from. This can be read and updated by the extension.


minHeight?

optional minHeight: string

Defined in: packages/extension-api/src/extension-api.d.ts:1695

When a custompick is closed (the sections are hidden) it is possible to set a minimum height so to force different items to have the same height. It must be set using pixels or percentage (e.g 100px or 50%) Use it carefully as it could break the layout.


onDidConfirmSelection

readonly onDidConfirmSelection: Event<number[]>

Defined in: packages/extension-api/src/extension-api.d.ts:1699

An event signaling when the user indicated confirmation of the selected item(s) index(es).


onDidHide

readonly onDidHide: Event<void>

Defined in: packages/extension-api/src/extension-api.d.ts:1703

An event signaling when this input UI is hidden.


title?

optional title: string

Defined in: packages/extension-api/src/extension-api.d.ts:1667

An optional human-readable string which is rendered prominent.

Methods

dispose()

dispose(): void

Defined in: packages/extension-api/src/extension-api.d.ts:1717

Dispose and free associated resources. Call CustomPick.hide.

Returns

void


hide()

hide(): void

Defined in: packages/extension-api/src/extension-api.d.ts:1711

Hides the custom pick.

Returns

void


show()

show(): void

Defined in: packages/extension-api/src/extension-api.d.ts:1707

Shows the custom pick.

Returns

void