DropDownCommand

A dropdown command shown in a modal’s control strip and bound to a modifier+key shortcut that cycles through its options.

Supported in ModalCommandsRenderMode.Instructions mode only.

Import:

import type { DropDownCommand } from 'obsidian-dev-utils/obsidian/modals/modal-command-builder';

Signature:

export interface DropDownCommand extends CommandBase

Extends: CommandBase

Properties

Property	Type	Description
key	string	The key that activates the command. (Inherited from CommandBase)
modifiers?	Modifier[]	The modifiers combined with CommandBase.key. When omitted, no modifiers are required. (Inherited from CommandBase)
purpose	string	The human-readable description shown next to the control. (Inherited from CommandBase)

Methods

Method	Returns	Description
checkIsAvailable(this)	boolean	Whether the control can be used right now. When it returns false the control is rendered **disabled rather than removed**, so the strip does not reflow under the pointer as modes change — which on a phone means a mis-tap. Re-read by ModalCommands.refresh. When omitted, the builder never touches the control's disabled state, leaving whatever CheckboxCommand.onInit / DropDownCommand.onInit set. (Inherited from CommandBase)
onChange(value)	void	Called when the dropdown value changes.
onInit(dropdownComponent)	void	Called once with the created dropdown component, to initialize its options and state.