Interface SelectField

SelectField defines "select" type field for storing single or multiple string values from a predefined list.

Requires the Values option to be set.

If MaxSelect is not set or <= 1, then the field value is expected to be a single Values element.

If MaxSelect is > 1, then the field value is expected to be a subset of Values slice.

The respective zero record field value is either empty string (single) or empty string slice (multiple).

The following additional setter keys are available:

  - "fieldName+" - append one or more values to the existing record one. For example:

    record.Set("roles+", []string{"new1", "new2"}) // []string{"old1", "old2", "new1", "new2"}

  - "+fieldName" - prepend one or more values to the existing record one. For example:

    record.Set("+roles", []string{"new1", "new2"}) // []string{"new1", "new2", "old1", "old2"}

  - "fieldName-" - subtract one or more values from the existing record one. For example:

    record.Set("roles-", "old1") // []string{"old2"}

Hierarchy

Implemented by

Methods

columnType driverValue findSetter getHidden getId getName getSystem isMultiple prepareValue setHidden setId setName setSystem type validateSettings validateValue

Properties

help hidden id maxSelect name presentable required system values

Methods

columnType

  • ColumnType implements [Field.ColumnType] interface method.

    Parameters

    Returns string

driverValue

  • DriverValue implements the [DriverValuer] interface.

    Parameters

    Returns any

findSetter

  • FindSetter implements the [SetterFinder] interface.

    Parameters

    • key: string

    Returns SetterFunc

getHidden

  • GetHidden implements [Field.GetHidden] interface method.

    Returns boolean

getId

  • GetId implements [Field.GetId] interface method.

    Returns string

getName

  • GetName implements [Field.GetName] interface method.

    Returns string

getSystem

  • GetSystem implements [Field.GetSystem] interface method.

    Returns boolean

isMultiple

  • IsMultiple implements [MultiValuer] interface and checks whether the current field options support multiple values.

    Returns boolean

prepareValue

  • PrepareValue implements [Field.PrepareValue] interface method.

    Parameters

    Returns any

setHidden

  • SetHidden implements [Field.SetHidden] interface method.

    Parameters

    • hidden: boolean

    Returns void

setId

  • SetId implements [Field.SetId] interface method.

    Parameters

    • id: string

    Returns void

setName

  • SetName implements [Field.SetName] interface method.

    Parameters

    • name: string

    Returns void

setSystem

  • SetSystem implements [Field.SetSystem] interface method.

    Parameters

    • system: boolean

    Returns void

type

  • Type implements [Field.Type] interface method.

    Returns string

validateSettings

  • ValidateSettings implements [Field.ValidateSettings] interface method.

    Parameters

    Returns void

validateValue

  • ValidateValue implements [Field.ValidateValue] interface method.

    Parameters

    Returns void

Properties

help

help: string

Help is an extra text explaining what the field is about. It is usually shown in Dashboard UI under the field input.

hidden

hidden: boolean

Hidden hides the field from the API response.

id

id: string

Id is the unique stable field identifier.

It is automatically generated from the name when adding to a collection FieldsList.

maxSelect

maxSelect: number

MaxSelect specifies the max allowed selected values.

For multiple select the value must be > 1, otherwise fallbacks to single (default).

name

name: string

Name (required) is the unique name of the field.

presentable

presentable: boolean

Presentable hints the Dashboard UI to use the underlying field record value in the relation preview label.

required

required: boolean

Required will require the field value to be non-empty.

system

system: boolean

System prevents the renaming and removal of the field.

values

values: string[]

Values specifies the list of accepted values.

Settings

Member Visibility

Theme

On This Page

Generated using TypeDoc