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

    Interface CompanionInputFieldNumber<TKey>

    A number input field

    Available for actions/feedbacks/config

    {
    	id: 'size',
    	type: 'number',
    	label: 'Target size',
    	default: 50,
    	min: 0,
    	max: 100
    }
    interface CompanionInputFieldNumber<TKey extends string = string> {
        allowInvalidValues?: boolean;
        asInteger?: boolean;
        clampValues?: boolean;
        default: number;
        description?: string;
        disableAutoExpression?: boolean;
        expressionDescription?: string;
        id: TKey;
        isVisibleExpression?: string;
        label: string;
        max: number;
        min: number;
        range?: boolean;
        showMaxAsPositiveInfinity?: boolean;
        showMinAsNegativeInfinity?: boolean;
        step?: number;
        tooltip?: string;
        type: "number";
    }

    Type Parameters

    • TKey extends string = string

    Hierarchy (View Summary)

    Index

    Properties

    allowInvalidValues? asInteger? clampValues? default description? disableAutoExpression? expressionDescription? id isVisibleExpression? label max min range? showMaxAsPositiveInfinity? showMinAsNegativeInfinity? step? tooltip? type

    Properties

    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.

    asInteger?: boolean

    Whether to only allow integer values

    clampValues?: boolean

    When value validation occurs, clamp values to the min/max instead of rejecting them as invalid

    default: number

    The default 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

    max: number

    The maximum value to allow Note: values may not conform to this, you should validate the value in your code

    min: number

    The minimum value to allow Note: values may not conform to this, you should validate the value in your code

    range?: boolean

    Whether to show a slider for the input

    showMaxAsPositiveInfinity?: boolean

    When true, show the max value as a visual ∞ when value >= max

    showMinAsNegativeInfinity?: boolean

    When true, show the min value as a visual -∞ when value <= min

    step?: number

    The stepping of the arrows

    tooltip?: string

    A hover tooltip for this field

    type: "number"

    The type of this input field

    Settings

    Member Visibility

    On This Page

    Example
    Properties