@companion-module/base
    Preparing search index...

    Interface CompanionInputFieldDropdown<TKey, TChoiceId>

    A dropdown input field

    Available for actions/feedbacks/config

    {
    	id: 'val',
    	type: 'dropdown',
    	label: 'Select name',
    	choices: [
    		{ id: 'bob', label: 'Bob' },
    		{ id: 'sally', label: 'Sally' },
    	],
    	default: 'bob'
    }
    interface CompanionInputFieldDropdown<
        TKey extends string = string,
        TChoiceId extends JsonValue = string | number,
    > {
        allowCustom?: boolean;
        allowInvalidValues?: boolean;
        choices: DropdownChoice<TChoiceId>[];
        default: TChoiceId;
        description?: string;
        disableAutoExpression?: boolean;
        expressionDescription?: string;
        id: TKey;
        isVisibleExpression?: string;
        label: string;
        minChoicesForSearch?: number;
        regex?: string;
        tooltip?: string;
        type: "dropdown";
    }

    Type Parameters

    • TKey extends string = string
    • TChoiceId extends JsonValue = string | number

    Hierarchy (View Summary)

    Index

    Properties

    allowCustom? allowInvalidValues? choices default description? disableAutoExpression? expressionDescription? id isVisibleExpression? label minChoicesForSearch? regex? tooltip? type

    Properties

    allowCustom?: boolean

    Allow custom values to be defined by the user Note: These will always come through as strings

    allowInvalidValues?: boolean

    Enabling this will tell companion to validate the value of this field against the definition of the field. If the computed value for this option does not match the validation rules, it will be passed through unchanged. If this is not set, then any invalid value will result in the action/feedback being skipped entirely. Note: This only applies when in expression mode.

    choices: DropdownChoice<TChoiceId>[]

    The possible choices

    default: TChoiceId

    The default selected value

    description?: string

    A longer description/summary/notes for this field

    disableAutoExpression?: boolean

    Whether to disable support for toggling this field to be an expression Danger: Be careful if setting this to true for an existing option, if the user has already defined an expression for this, it will no longer be parsed and will break their configuration.

    expressionDescription?: string

    An alternate description to show when the field is in expression mode. This will replace the normal description

    id: TKey

    The unique id of this input field within the input group

    isVisibleExpression?: string

    A companion expression to check whether this input should be visible, based on the current options selections within the input group

    This is the same syntax as other expressions written inside of Companion. You can access a value of the current options using $(options:some_field_id). Note: you can only reference fields which are set to disableAutoExpression here, as other fields can be expressions and frequently changing values

    label: string

    The label of the field

    minChoicesForSearch?: number

    The minimum number of entries the dropdown must have before it allows searching

    regex?: string

    Check custom value against regex

    tooltip?: string

    A hover tooltip for this field

    type: "dropdown"

    The type of this input field

    Settings

    Member Visibility

    On This Page

    Example
    Properties