Skip to content

TypedDropdownComponent<T>

A dropdown component that can be used to select a value from a list.

You can add this component using SettingEx.addTypedDropdown.

In order to add the styles for the component, use initPluginContext in your plugin’s onload() function.

Alternatively, you can copy styles from https://github.com/mnaoumov/obsidian-dev-utils/releases/latest/download/styles.css.

Import:

import { TypedDropdownComponent } from 'obsidian-dev-utils/obsidian/setting-components/typed-dropdown-component';

Signature:

export class TypedDropdownComponent<T> extends ValueComponent<null | T> implements ValueComponentWithChangeTracking<null | T>

Extends: ValueComponent<null | T>

Implements: ValueComponentWithChangeTracking<null | T>

Constructor

new TypedDropdownComponent(containerEl: HTMLElement)

Creates a new multiple dropdown component.

Properties

PropertyTypeDescription
dropdownComponentDropdownComponentThe inner dropdown component.
valuesT[]The list of selectable option values, indexed by their position in the dropdown.

Methods

MethodReturnsDescription
addOption(value, display)thisAdds an option to the dropdown.
addOptions(options)thisAdds multiple options to the dropdown.
getValue()null | TGets the value of the component.
onChange(callback)thisSets the callback function to be called when the component is changed.
onChange(callback)thisSets a callback function to be called when the value of the component changes.
(Inherited from ValueComponentWithChangeTracking)
setDisabled(disabled)thisSets the disabled state of the component.
setValue(value)thisSets the value of the component.
simulateChange__()voidSimulate a change event.

Links to this page: