QuickPick

A concrete QuickInput to let the user pick an item from a list of items of type T.

The items can be filtered through a filter text field and there is an option canSelectMany to allow for selecting multiple items.

Note that in many cases the more convenient window.showQuickPick is easier to use. window.createQuickPick should be used when window.showQuickPick does not offer the required flexibility.

Online Documentation

Properties

Link copied to clipboard
abstract external var activeItems: ReadonlyArray<T>

Active items. This can be read and updated by the extension.

Link copied to clipboard
abstract external var busy: Boolean

Determines if the UI should show a progress indicator. Defaults to false.

Link copied to clipboard
abstract external var buttons: ReadonlyArray<QuickInputButton>

Buttons for actions in the UI.

Link copied to clipboard
abstract external var canSelectMany: Boolean

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

Link copied to clipboard
abstract external var enabled: Boolean

Determines if the UI should allow for user input. Defaults to true.

Link copied to clipboard
abstract external var ignoreFocusOut: Boolean

Determines if the UI should stay open even when losing UI focus. Defaults to false. This setting is ignored on iPad and is always false.

Link copied to clipboard
abstract external var items: ReadonlyArray<T>

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

Link copied to clipboard
abstract external var keepScrollPosition: Boolean?

Determines if the scroll position is maintained when the quick pick items are updated. Defaults to false.

Link copied to clipboard
abstract external var matchOnDescription: Boolean

Determines if the filter text should also be matched against the description of the items. Defaults to false.

Link copied to clipboard
abstract external var matchOnDetail: Boolean

Determines if the filter text should also be matched against the detail of the items. Defaults to false.

Link copied to clipboard
abstract external val onDidAccept: Event<Void>

An event signaling when the user indicated acceptance of the selected item(s).

Link copied to clipboard
abstract external val onDidChangeActive: Event<ReadonlyArray<T>>

An event signaling when the active items have changed.

Link copied to clipboard
abstract external val onDidChangeSelection: Event<ReadonlyArray<T>>

An event signaling when the selected items have changed.

Link copied to clipboard
abstract external val onDidChangeValue: Event<JsString>

An event signaling when the value of the filter text has changed.

Link copied to clipboard
abstract external val onDidHide: Event<Void>

An event signaling when this input UI is hidden.

Link copied to clipboard
abstract external val onDidTriggerButton: Event<QuickInputButton>

An event signaling when a button was triggered.

Link copied to clipboard

An event signaling when a button in a particular QuickPickItem was triggered.

Link copied to clipboard
abstract external var placeholder: String?

Optional placeholder text displayed in the filter text box when no value has been entered.

Link copied to clipboard
abstract external var prompt: String?

Optional text that provides instructions or context to the user.

Link copied to clipboard
abstract external var selectedItems: ReadonlyArray<T>

Selected items. This can be read and updated by the extension.

Link copied to clipboard
abstract external var step: Int?

An optional current step count for multi-step input flows.

Link copied to clipboard
abstract external var title: String?

An optional title for the input UI.

Link copied to clipboard
abstract external var totalSteps: Int?

An optional total step count for multi-step input flows.

Link copied to clipboard
abstract external var value: String

The current value of the filter text.

Functions

Link copied to clipboard
abstract external override fun dispose()

Dispose of this input UI and any associated resources.

Link copied to clipboard
abstract external fun hide()

Hides this input UI.

Link copied to clipboard
abstract external fun show()

Makes the input UI visible in its current configuration.