Class ColorField

A special foundry.data.fields.StringField which records a standardized CSS color string.

Hierarchy (View Summary)

StringField
- ColorField

Constructors

constructor

new ColorField(
options?: StringFieldOptions,
context?: DataFieldContext,
): ColorField
Parameters
- Optionaloptions: StringFieldOptions = {}
  Options which configure the behavior of the field
- Optionalcontext: DataFieldContext = {}
  Additional context which describes the field
Returns ColorField
Inherited from StringField.constructor

Properties

blank

blank: boolean

Is the string allowed to be blank (empty)?

choices

choices: object | Function | string[] = ...

An array of values or an object of values/labels which represent allowed choices for the field. A function may be provided which dynamically returns the array of choices.

`Internal`name

name: string | undefined

The field name of this DataField instance. This is assigned by SchemaField#initialize.

options

options: DataFieldOptions

The initially provided options which configure the data field

`Internal`parent

parent: any

A reference to the parent schema to which this DataField belongs. This is assigned by SchemaField#initialize.

persisted

persisted: boolean = true

Is a value of this field written to source data? A Non-persisted value is initialized (with its initial value), and ActiveEffects can use the field for change application.

textSearch

textSearch: boolean = ...

Is this string field a target for text search?

trim

trim: boolean = ...

Should any provided string be trimmed as part of cleaning?

`Static`hierarchical

hierarchical: boolean = false

Whether this field defines part of a Document/Embedded Document hierarchy.

`Static`recursive

recursive: boolean = false

Does this field type contain other fields in a recursive structure? Examples of recursive fields are SchemaField, ArrayField, or TypeDataField Examples of non-recursive fields are StringField, NumberField, or ObjectField

Accessors

fieldPath

get fieldPath(): string
A dot-separated string representation of the field path within the parent schema.

Returns string
Inherited from StringField.fieldPath

`Static`_defaults

get _defaults(): DataFieldOptions & {
    blank: boolean;
    choices: undefined;
    textSearch: boolean;
    trim: boolean;
} & { blank: boolean; initial: null; nullable: boolean }
Default parameters for this field type

Returns DataFieldOptions & {
    blank: boolean;
    choices: undefined;
    textSearch: boolean;
    trim: boolean;
} & { blank: boolean; initial: null; nullable: boolean }
Overrides StringField._defaults

`Static`hasFormSupport

get hasFormSupport(): boolean
Does this form field class have defined form support?

Returns boolean
Inherited from StringField.hasFormSupport

Methods

_applyChangeSubtract

_applyChangeSubtract(
    value: string,
    delta: string,
    model: any,
    change: any,
): string
Parameters
- value: string
- delta: string
- model: any
- change: any
Returns string
Inherited from StringField._applyChangeSubtract

_cast

_cast(value: any): string
Parameters
- value: any
Returns string
Overrides StringField._cast

_replaceDataRefs

_replaceDataRefs(
    raw: any,
    data: any,
    __namedParameters?: { strict?: boolean },
): string
Recursively replace data references in a string change value.
Parameters
- raw: any
- data: any
  An object providing replacements
- __namedParameters: { strict?: boolean } = {}
  Additional options to configure the data replacement
Returns string
The expression with data references resolved

Inherited from StringField._replaceDataRefs

_toInput

_toInput(config: any): HTMLColorPickerElement
Parameters
- config: any
Returns HTMLColorPickerElement
Overrides StringField._toInput

_updateCommit

_updateCommit(
    source: object,
    key: string,
    value: object,
    diff: object,
    options: DataModelUpdateOptions,
): void
Internal
Commit a prepared update to DataModel#_source.
Parameters
- source: object
  The parent source object within which the key field exists
- key: string
  The named field in source to commit
- value: object
  The new value of the field which should be committed to source
- diff: object
  The reported change to the field
- options: DataModelUpdateOptions
  Options which modify how this update workflow is performed.
Returns void
Inherited from StringField._updateCommit

_updateDiff

_updateDiff(
    key: string,
    value: any,
    options: DataModelUpdateOptions,
    state: data.types.DataModelUpdateState,
): void
Internal
Update the source data for a DataModel which includes this DataField. Updates are performed depth-first; validated and recorded from leaf-nodes upwards.

This method is responsible for preparing and validating the requested update. If the update is valid, it is responsible for updating the pending source copy and recording the diff. If the update is invalid it must avoid recording a diff or staging an update to the source copy. If validation fails, this workflow may optionally permit fallback to a valid initial value.
```
                                 a partial node of source data, relative to which this field belongs.
```
Parameters
- key: string
  The name of this field within the context of the source data.
- value: any
  The candidate value that should be applied as an update.
- options: DataModelUpdateOptions
  Options which modify how this update workflow is performed.
- state: data.types.DataModelUpdateState
  Stateful data that is transacted throughout the model hierarchy during an update operation.
Returns void
Throws
An error if the requested update cannot be performed.

Inherited from StringField._updateDiff

_validateModel

_validateModel(data: object, options?: object): void
Internal
Certain fields may declare joint data validation criteria. This method will only be called if the field is designated as recursive. This method should throw if any validation error occurred, even if resolved by fallback or dropping.
Parameters
- data: object
  Candidate data for joint model validation
- options: object = {}
  Options which modify joint model validation
Returns void
Throws
An error if joint model validation fails

Inherited from StringField._validateModel

_validateSpecial

_validateSpecial(value: any): boolean | void
Special validation rules which supersede regular field validation. This validator screens for certain values which are otherwise incompatible with this field like null or undefined.
Parameters
- value: any
  The candidate value
Returns boolean | void
A boolean to indicate with certainty whether the value is valid

Throws
An error with a specific reason the value is invalid

Inherited from StringField._validateSpecial

_validateType

_validateType(value: any, options: any): true | undefined
Parameters
- value: any
- options: any
Returns true | undefined
Overrides StringField._validateType

apply

apply(fn: string | Function, value: any, options?: object): object
Apply a function to this DataField which propagates through recursively to any contained data schema.
Parameters
- fn: string | Function
  The function to apply
- value: any
  The current value of this field
- Optionaloptions: object = {}
  Additional options passed to the applied function
Returns object
The results object

Inherited from StringField.apply

applyChange

applyChange<T>(
    value: T,
    model: DataModel,
    change: EffectChangeData,
    options?: { replacementData?: Record<string, unknown> },
): T
Apply an ActiveEffectChange to this field.
Type Parameters
- T
Parameters
- value: T
  The field's current value.
- model: DataModel
  The model instance.
- change: EffectChangeData
  The change to apply.
- options: { replacementData?: Record<string, unknown> } = {}
  Additional options to configure the change application.
  - OptionalreplacementData?: Record<string, unknown>
    Data used to resolve "@" expressions.
Returns T
The updated value.

Inherited from StringField.applyChange

clean

clean(value: any, options: any, _state: any): any
Preprocess and clean source data to ensure that it conforms to the correct data type for this field and is ready to be used by data model construction or update operations. Data cleaning is synchronous and automatically applied as the first step of construction and update operations.
Parameters
- value: any
  An initial requested value
- options: any
  Additional options for how the field is cleaned
- _state: any
  Internal state variables which are used during recursion
Returns any
The cleaned value

Inherited from StringField.clean

getInitialValue

getInitialValue(source: any): any
Parameters
- source: any
Returns any
Inherited from StringField.getInitialValue

initialize

initialize(value: any, model: any, options?: {}): any
Parameters
- value: any
- model: any
- options: {} = {}
Returns any
Overrides StringField.initialize

toFormGroup

toFormGroup(
groupConfig?: FormGroupConfig,
inputConfig?: FormInputConfig,
): HTMLDivElement
Render this DataField as a standardized form-group element.
Parameters
- groupConfig: FormGroupConfig = {}
  Configuration options passed to the wrapping form-group
- inputConfig: FormInputConfig = {}
  Input element configuration options passed to DataField#toInput
Returns HTMLDivElement
The rendered form group element

Inherited from StringField.toFormGroup

toInput

toInput(config?: FormInputConfig): HTMLElement | HTMLCollection | HTMLElement[]
Render this DataField as an HTML element.
Parameters
- config: FormInputConfig = {}
  Form element configuration parameters
Returns HTMLElement | HTMLCollection | HTMLElement[]
A rendered HTMLElement for the field

Throws
An Error if this DataField subclass does not support input rendering

Inherited from StringField.toInput

toObject

toObject(value: any): any
Export the current value of the field into a serializable object.
Parameters
- value: any
  The initialized value of the field
Returns any
An exported representation of the field

Inherited from StringField.toObject

validate

validate(
value: any,
options?: DataFieldValidationOptions,
): void | DataModelValidationFailure
Validate candidate input for this field, ensuring it meets the field requirements.

This public method validates recursively, testing both the immediate value of this field as well as the validity of any child values for fields with hierarchical data types.
Parameters
- value: any
  The candidate value to validate
- Optionaloptions: DataFieldValidationOptions = {}
  Options which affect validation behavior
Returns void | DataModelValidationFailure
A failure that occurred if validation is non-strict. The failure may have been resolved by fallback or dropping invalid elements.

Throws
A failure error type including details of the failure if validation is performed strictly.

Inherited from StringField.validate

validators

validators(
options?: Pick<DataFieldValidationOptions, "recursive" | "phase">,
): Generator<DataFieldValidator, void, unknown>
Iterate over validation functions applied to this field. Validation happens in a depth-first way, for example consider an outerSchema with an innerField:
Parameters
- options: Pick<DataFieldValidationOptions, "recursive" | "phase"> = {}
Returns Generator<DataFieldValidator, void, unknown>
Example: Validator Invocation Order
```
outerSchema
  _validateSpecial
  _validateType
  _validateRecursive
  outerSchema.options.validate
    innerField
      _validateSpecial
      _validateType
      innerField.options.validate
      _validateModel
  _validateModel
```
Yields
Inherited from StringField.validators

`Protected`_applyChangeAdd

_applyChangeAdd(
    value: any,
    delta: any,
    model: DataModel,
    change: EffectChangeData,
): any
Protected
Apply an "add" change to this field.
Parameters
- value: any
  The field's current value.
- delta: any
  The change delta.
- model: DataModel
  The model instance.
- change: EffectChangeData
  The original change data.
Returns any
The updated value.

Inherited from StringField._applyChangeAdd

`Protected`_applyChangeCustom

_applyChangeCustom(
    value: any,
    delta: any,
    model: DataModel,
    change: EffectChangeData,
): any
Protected
Apply a custom change to this field.
Parameters
- value: any
  The field's current value.
- delta: any
  The change delta.
- model: DataModel
  The model instance.
- change: EffectChangeData
  The original change data.
Returns any
The updated value.

Inherited from StringField._applyChangeCustom

`Protected`_applyChangeDowngrade

_applyChangeDowngrade(
    value: any,
    delta: any,
    model: DataModel,
    change: EffectChangeData,
): any
Protected
Apply a "downgrade" change to this field.
Parameters
- value: any
  The field's current value.
- delta: any
  The change delta.
- model: DataModel
  The model instance.
- change: EffectChangeData
  The original change data.
Returns any
The updated value.

Inherited from StringField._applyChangeDowngrade

`Protected`_applyChangeMultiply

_applyChangeMultiply(
    value: any,
    delta: any,
    model: DataModel,
    change: EffectChangeData,
): any
Protected
Apply a "multiply" change to this field.
Parameters
- value: any
  The field's current value.
- delta: any
  The change delta.
- model: DataModel
  The model instance.
- change: EffectChangeData
  The original change data.
Returns any
The updated value.

Inherited from StringField._applyChangeMultiply

`Protected`_applyChangeOverride

_applyChangeOverride(
    value: any,
    delta: any,
    model: DataModel,
    change: EffectChangeData,
): any
Protected
Apply an "override" change to this field.
Parameters
- value: any
  The field's current value.
- delta: any
  The change delta.
- model: DataModel
  The model instance.
- change: EffectChangeData
  The original change data.
Returns any
The updated value.

Inherited from StringField._applyChangeOverride

`Protected`_applyChangeUpgrade

_applyChangeUpgrade(
    value: any,
    delta: any,
    model: DataModel,
    change: EffectChangeData,
): any
Protected
Apply an "upgrade" change to this field.
Parameters
- value: any
  The field's current value.
- delta: any
  The change delta.
- model: DataModel
  The model instance.
- change: EffectChangeData
  The original change data.
Returns any
The updated value.

Inherited from StringField._applyChangeUpgrade

`Protected`_castChangeDelta

_castChangeDelta(delta: any, replacementData?: object): any
Protected
Cast a change delta into an appropriate type to be applied to this field.
Parameters
- delta: any
  The change delta.
- replacementData: object = {}
  Data used to resolve "@" expressions.
Returns any
Inherited from StringField._castChangeDelta

`Protected`_cleanType

_cleanType(
    value: any,
    options?: Readonly<DataModelCleaningOptions>,
    _state?: data.types.DataModelUpdateState,
): any
Protected
Apply any cleaning logic specific to this DataField type.
Parameters
- value: any
  A candidate value that has been cast to the appropriate type
- Optionaloptions: Readonly<DataModelCleaningOptions>
  Options for how the field is cleaned
- Optional_state: data.types.DataModelUpdateState
  Internal state variables which are used during recursion
Returns any
The cleaned value

Inherited from StringField._cleanType

`Protected`_getField

_getField(
parts: string[],
options?: { source?: object; type?: object },
): DataField | undefined
Protected
Recursively traverse a schema and retrieve a field specification by a given path/key
Parameters
- parts: string[]
  The field path or property key if source is passed as an array of strings (in reverse order)
- Optionaloptions: { source?: object; type?: object } = {}
  Additional options
  - Optionalsource?: object
    The source data of the field
  - Optionaltype?: object
    The Document type of the parent field
Returns DataField | undefined
The corresponding DataField definition for that field, or undefined

Inherited from StringField._getField

`Protected`_isValidChoice

_isValidChoice(value: string): boolean
Protected
Test whether a provided value is a valid choice from the allowed choice set
Parameters
- value: string
  The provided value
Returns boolean
Is the choice valid?

Inherited from StringField._isValidChoice

`Protected`_migrate

_migrate(
    value: any,
    options?: Readonly<DataModelCleaningOptions>,
    _state?: data.types.DataModelUpdateState,
): any
Protected
Migrate this field's candidate source data. This workflow occurs as a component step of DataField#clean.
Parameters
- value: any
  Candidate source value for the field
- Optionaloptions: Readonly<DataModelCleaningOptions>
  Options for how the field is cleaned
- Optional_state: data.types.DataModelUpdateState
  Internal state variables transacted during cleaning recursion.
Returns any
A migrated value suitable for cleaning

Inherited from StringField._migrate

`Protected`_validateRecursive

_validateRecursive(
value: any,
options?: DataFieldValidationOptions,
): boolean | void
Protected
For fields which have hierarchical data structures, define how their inner fields should be validated. This method is called after _validateSpecial and _validateType. It can be assumed that those tests passed. This method should throw if any validation error occurred, even if resolved by fallback or dropping.
Parameters
- value: any
  The candidate value
- Optionaloptions: DataFieldValidationOptions
  Options which affect validation behavior
Returns boolean | void
A boolean to indicate with certainty whether the value is valid

Throws
An error with a specific reason the value is invalid

Inherited from StringField._validateRecursive

`Static`_prepareChoiceConfig

_prepareChoiceConfig(
config?: FormInputConfig & Partial<ChoiceInputConfig>,
): void
Internal
Prepare form input configuration to accept a limited choice set of options.
Parameters
- Optionalconfig: FormInputConfig & Partial<ChoiceInputConfig>
Returns void
Inherited from StringField._prepareChoiceConfig

Class ColorField

Hierarchy (View Summary)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns ColorField

Properties

blank

choices

Internalname

options

Internalparent

persisted

textSearch

trim

Statichierarchical

Staticrecursive

Accessors

fieldPath

Returns string

Static_defaults

Returns DataFieldOptions & { blank: boolean; choices: undefined; textSearch: boolean; trim: boolean;} & { blank: boolean; initial: null; nullable: boolean }

StatichasFormSupport

Returns boolean

Methods

_applyChangeSubtract

Parameters

Returns string

_cast

Parameters

Returns string

_replaceDataRefs

Parameters

Returns string

_toInput

Parameters

Returns HTMLColorPickerElement

_updateCommit

Parameters

Returns void

_updateDiff

Parameters

Returns void

Throws

_validateModel

Parameters

Returns void

Throws

_validateSpecial

Parameters

Returns boolean | void

Throws

_validateType

Parameters

Returns true | undefined

apply

Parameters

Returns object

applyChange

Type Parameters

Parameters

OptionalreplacementData?: Record<string, unknown>

Returns T

clean

Parameters

Returns any

getInitialValue

Parameters

Returns any

initialize

Parameters

Returns any

toFormGroup

Parameters

Returns HTMLDivElement

`Internal`name

`Internal`parent

`Static`hierarchical

`Static`recursive

`Static`_defaults

Returns DataFieldOptions & {
blank: boolean;
choices: undefined;
textSearch: boolean;
trim: boolean;
} & { blank: boolean; initial: null; nullable: boolean }

`Static`hasFormSupport

`Optional`replacementData?: Record<string, unknown>

`Protected`_applyChangeAdd

`Protected`_applyChangeCustom

`Protected`_applyChangeDowngrade

`Protected`_applyChangeMultiply

`Protected`_applyChangeOverride

`Protected`_applyChangeUpgrade

`Protected`_castChangeDelta

`Protected`_cleanType

`Protected`_getField

`Optional`source?: object

`Optional`type?: object

`Protected`_isValidChoice

`Protected`_migrate

`Protected`_validateRecursive

`Static`_prepareChoiceConfig