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

    Interface CompanionInputFieldDropdown

    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 {
        allowCustom?: boolean;
        choices: DropdownChoice[];
        default: DropdownChoiceId;
        description?: string;
        id: string;
        isVisible?: (options: CompanionOptionValues, data: any) => boolean;
        isVisibleData?: Record<string, any>;
        isVisibleExpression?: string;
        label: string;
        minChoicesForSearch?: number;
        regex?: string;
        tooltip?: string;
        type: "dropdown";
    }

    Hierarchy (View Summary)

    Index

    Properties

    allowCustom? choices default description? id isVisible? isVisibleData? isVisibleExpression? label minChoicesForSearch? regex? tooltip? type

    Properties

    allowCustom?: boolean

    Allow custom values to be defined by the user

    choices: DropdownChoice[]

    The possible choices

    default: DropdownChoiceId

    The default selected value

    description?: string

    A longer description/summary/notes for this field

    id: string

    The unique id of this input field within the input group

    isVisible?: (options: CompanionOptionValues, data: any) => boolean

    This will be removed in 2.0.0 of this api. Use isVisibleExpression instead.

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

    Note: This function must not depend on anything outside of its scope. If it does it will fail to compile and will be skipped.

    Note: If both this and isVisibleExpression are provided, isVisibleExpression will take precedence.

    isVisibleData?: Record<string, any>

    This will be removed in 2.0.0 of this api. Use isVisibleExpression instead.

    A JSON serializable object to provide as extra input to isVisible

    If you think you need this with isVisibleExpression, we want to hear why.

    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 Comapnion. You can access a value of the current options using $(options:some_field_id). This does not support the isVisibleData property, let us know if you need this.

    Note: If both this and isVisible are provided, this will take precedence.

    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