Skip to main content

Interface: CustomPick<T>

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

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:1720

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:1708

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:1726

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:1712

An optional base64 PNG image


items

items: T[]

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

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:1732

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:1736

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:1740

An event signaling when this input UI is hidden.


title?

optional title: string

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

An optional human-readable string which is rendered prominent.

Methods

dispose()

dispose(): void

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

Dispose and free associated resources. Call CustomPick.hide.

Returns

void


hide()

hide(): void

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

Hides the custom pick.

Returns

void


show()

show(): void

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

Shows the custom pick.

Returns

void