Class Action

A button that performs an action when clicked. Shown in the preferences screen, and acts exactly like a setting, but always holds a value of 'null'.

Hierarchy (view full)

  • Setting<undefined, undefined>
    • Action

Constructors

constructor

Properties

allowedValues? defaultValue deserialize? displayOptions? isDisabled isHidden onClick serialize? basicSerializers

Methods

get load lock ok reset set unlock

Constructors

constructor

Properties

Optional ReadonlyallowedValues

allowedValues?: Record<string, undefined> | undefined[]

Allowed values for this setting. Specific values may be provided, or an object of "choice objects": value mapped by the choice label (to be used to get the choice text from i18n, e.g. deputy.setting.user.<group>.<name>.choice.<choice>). When an array is passed, the key to be used for i18n is equal to the result of the allowed value's toString function.

When using allowedValues, as much as possible use primitive types as the deserialized type, since indexOf is used to check if a value is allowed, which may not work properly for class instances or objects.

ReadonlydefaultValue

defaultValue: undefined

The default value of the setting.

Optional Readonlydeserialize

deserialize?: Transformer<undefined, undefined>

Parse a serialized value into a deserialized one.

Param: raw

The raw value to parse.

Returns

The parsed value.

Optional ReadonlydisplayOptions

displayOptions?: DisplayOptions

Display options for this setting when showing up on settings interfaces.

ReadonlyisDisabled

isDisabled: ((config?: UserConfiguration) => string | boolean)

Type declaration

    • (config?): string | boolean

    • Parameters

      Returns string | boolean

      if this option is disabled or not.

ReadonlyisHidden

isHidden: ((config?: UserConfiguration) => string | boolean)

Type declaration

    • (config?): string | boolean

    • Parameters

      Returns string | boolean

      if this option is hidden or not.

onClick

onClick: (() => PromiseOrNot<void>)

Optional Readonlyserialize

serialize?: Transformer<undefined, undefined>

Serialize this setting's value or a given value.

Param: value

The value to serialize

Static ReadonlybasicSerializers

basicSerializers: {
    deserialize: ((value: any) => any);
    serialize: ((value: any) => any);
} = ...

Methods

get

load

  • load(raw): undefined

  • Parses a given raw value and mutates the setting.

    Parameters

    • raw: undefined

      The raw value to parse.

    Returns undefined

    The new value.

lock

ok

reset

set

  • set(v, throwOnInvalid?): void

  • Sets the value and performs validation. If the input is an invalid value, and throwOnInvalid is false, the value will be reset to default.

    Parameters

    • v: undefined
    • throwOnInvalid: boolean = false

    Returns void

unlock

Settings

Member Visibility

On This Page

Constructors
Properties
Methods