Class UpListboxControl

element

multiple

• get multiple(): boolean

• Retrieves the boolean value indicating whether multiple items can be selected from a list.

  Returns boolean

required

• get required(): boolean

• Check if input is required.

  Returns boolean
• set required(value): void

• Set input to required / not required.

  Parameters

  • value: boolean

  Returns void

checkValidity

• checkValidity(): Promise<ValidationInfo>

• Checks the controls validity.

  Returns Promise<ValidationInfo>

getDisplayValue

• getDisplayValue(): null | string | string[]

• Get the current value of the control.

  Returns null | string | string[]

  Display text of the selected option as string.

  • It returns null when no option is selected
  • An array containing the value of each selected option when there is at least one and it is possible to select more.

getValue

• getValue(): string

• Returns string

hasValue

• hasValue(): boolean

• Checking at least one option is selected from current control instance.

  Returns boolean

  It returns true when at least one option is selected.

reload

• reload(reset): Promise<void | Error>

• Reloads the control.

  Parameters

  • reset: boolean

    Reset the control to its first entry.

  Returns Promise<void | Error>

reportValidity

• reportValidity(): Promise<void>

• Reports the elements validity.

  Returns Promise<void>

reset

• reset(fireEvent): void

• Deselects all entries.

  Parameters

  • fireEvent: boolean

    triggerOnchange

  Returns void

selectFirstEntry

• selectFirstEntry(triggerOnchange?): void

• Selects the first entry.

  Parameters

  • triggerOnchange: TriggerValues = "always"

  Returns void

setDisplayValue

• setDisplayValue(value, settings?): void

• Set display value of the control by record id.

  • can be asynchronous, depending on the control type.

  Parameters

  • value: string | string[]

    The display value to be set.

  • Optional settings: {
        triggerOnchange: TriggerValues;
    }

    • triggerOnchange: TriggerValues

  Returns void

setValue

• setValue(value, settings?): void

• Set value of the control.

  • can be asynchronous, depending on the control type.

  Parameters

  • value: string | string[]

    The unformated raw value to be set.

  • Optional settings: {
        triggerOnchange: TriggerValues;
    }

    • triggerOnchange: TriggerValues

  Returns void

triggerOnchange

• triggerOnchange(): void

• Dispatches the onchange event.

  Returns void