Class InspectorFieldBase`Abstract` `Public Self`

The InspectorFieldBase displays UI elements for a single InspectableProperty. This is a base class that should be specialized for all supported types contained by InspectableProperty. Inspectable fields can and should be created recursively - normally complex types like objects and arrays will contain fields of their own, while primitive types like integer or boolean will consist of only a UI element.

Hierarchy (view full)

InspectorFieldBase
- InspectorField

Constructors

constructor

new InspectorFieldBase(context, title, path, type, depth, layout, property): InspectorFieldBase
Creates a new inspectable field UI for the specified property.
Parameters
- context: InspectorContext
  Context shared by all inspectable fields created by the same parent.
- title: string
  Name of the property, or some other value to set as the title.
- path: string
  Full path to this property (includes name of this property and all parent properties).
- type: EnumValue<InspectablePropertyType, number>
  Type of property this field will be used for displaying.
- depth: number
  Determines how deep within the inspector nesting hierarchy is this field. Some fields may contain other fields, in which case you should increase this value by one.
- layout: InspectorFormLayoutSection
  Parent layout that all the field elements will be added to.
- property: InspectableProperty
  Serializable property referencing the array whose contents to display.
Returns InspectorFieldBase

Properties

`Protected`_active

_active: boolean

`Protected` `Readonly`_context

_context: InspectorContext

`Protected` `Readonly`_depth

_depth: number

`Protected`_disabled

_disabled: boolean

`Protected` `Readonly`_formLayoutSection

_formLayoutSection: InspectorFormLayoutSection

`Protected` `Readonly`_inspector

_inspector: InspectorFieldContainer

`Protected`_isReadOnly

_isReadOnly: boolean

`Protected` `Readonly`_name

_name: string

`Protected` `Readonly`_path

_path: string

`Protected`_property

_property: InspectableProperty

`Protected` `Readonly`_propertyType

_propertyType: EnumValue<InspectablePropertyType, number>

`Protected` `Readonly`_title

_title: string

endUndo

endUndo: (() => void)

Finishes recording an undo command started via startUndoForPath. If any changes are detected on the field an undo command is recorded onto the undo-redo stack, otherwise nothing is done.

startUndo

startUndo: (() => void)

Zero parameter wrapper for startUndoForPath

startUndoForPath

startUndoForPath: ((subPath?: string) => void)

Notifies the system to start recording a new undo command. Any changes to the field after this is called will be recorded in the command. User must call endUndo after field is done being changed.

Type declaration

- (subPath?): void
- Parameters
  - OptionalsubPath: string
    Optional path to append to the end of the current field path.
  Returns void

Accessors

container

get container(): InspectorFieldContainer
Gets the InspectorFieldContainer that owns this field.

Returns InspectorFieldContainer

decoration

get decoration(): InspectablePropertyDecoration
Information that can be used for customizing field rendering and behaviour.

Returns InspectablePropertyDecoration

depth

get depth(): number
Gets the depth of the field.

Returns number

formLayoutSection

get formLayoutSection(): InspectorFormLayoutSection
Gets the layout of the field.

Returns InspectorFormLayoutSection

isActive

get isActive(): boolean
Activates or deactivates the underlying UI elements.

Returns boolean
set isActive(value): void
Parameters
- value: boolean
Returns void

isDisabled

get isDisabled(): boolean
Disables or enables the underlying UI elements. Disabled elements cannot be interacted with and have a faded out appearance.

Returns boolean
set isDisabled(value): void
Parameters
- value: boolean
Returns void

isFocused

get isFocused(): boolean
Determines if the field is in focused state.

Returns boolean

isReadOnly

get isReadOnly(): boolean
Disables or enables the underlying UI elements. Disabled elements cannot be interacted with and have a faded out appearance.

Returns boolean
set isReadOnly(value): void
Parameters
- value: boolean
Returns void

name

get name(): string
Name portion of the field path.

Returns string

path

get path(): string
Returns the path to the field.

Returns string

property

get property(): InspectableProperty
Property this field is displaying contents of.

Returns InspectableProperty
set property(value): void
Parameters
- value: InspectableProperty
Returns void

undoRedo

get undoRedo(): UndoRedo
Gets the UndoRedo for the field.

Returns UndoRedo

Methods

destroy

destroy(): void
Virtual
Destroys all UI elements in the inspectable field.

Returns void

findPath

findPath(path): InspectorFieldBase
Virtual
Searches for a child field with the specified path.
Parameters
- path: string
  Path relative to the current field. Path entries are field names separated with /. Fields within categories are placed within a special category group, surrounded by []. Examples: - myField - myObject/myField - myObject/[myCategory]/myField
Returns InspectorFieldBase
Matching field if one is found, null otherwise.

`Abstract`initialize

initialize(): any
Virtual
Initializes the UI elements for the field.

Returns any

notifyNeedsRefresh

notifyNeedsRefresh(): void
Virtual
Notifies the owning inspector that it needs to be refreshed on the next update loop.

Returns void

refresh

refresh(flags?): EnumValue<InspectableState, number>
Virtual
Checks if contents of the field have been modified, and updates them if needed.
Parameters
- Optionalflags: EnumValue<InspectableRefreshFlag, number>
  Flags that determine the refresh behavior that the field should have.
Returns EnumValue<InspectableState, number>
State representing was anything modified between two last calls to refresh.

setActive

setActive(active): void
Virtual
Activates or deactivates the underlying UI elements.
Parameters
- active: boolean
Returns void

setDisabled

setDisabled(disabled): void
Virtual
Disables or enables the underlying UI elements. Disabled elements cannot be interacted with and have a faded out appearance.
Parameters
- disabled: boolean
Returns void

setHasFocus

setHasFocus(subFieldName?): void
Virtual
Moves keyboard focus to this field.
Parameters
- OptionalsubFieldName: string
  Name of the sub-field to focus on. Only relevant if the inspectable field represents multiple UI input elements.
Returns void

setReadOnly

setReadOnly(readOnly): void
Virtual
Set the element read only.
Parameters
- readOnly: boolean
  The new read only value
Returns void

setValueImmediate

setValueImmediate<T>(value): void
Assigns the field value to the underlying property and creates an undo operation.
Type Parameters
- T
Parameters
- value: ValueTypeOf<T>
Returns void

`Static`createField

createField(context, title, path, layoutIndex, depth, layout, property, parent?, fnGetParentFieldConditionals?): InspectorFieldBase
Creates a new inspectable field, automatically detecting the most appropriate implementation for the type contained in the provided serializable property. This may be one of the built-in inspectable field implemetations (like ones for primitives like int or bool), or a user defined implementation defined with a CustomInspectorAttribute attribute.
Parameters
- context: InspectorContext
  Context shared by all inspectable fields created by the same parent.
- title: string
  Name of the property, or some other value to set as the title.
- path: string
  Full path to this property (includes name of this property and all parent properties).
- layoutIndex: number
  Index into the parent layout at which to insert the UI elements for the field .
- depth: number
  Determines how deep within the inspector nesting hierarchy is this field. Some fields may contain other fields, in which case you should increase this value by one.
- layout: InspectorFormLayoutSection
  Parent layout that all the field elements will be added to.
- property: InspectableProperty
  Serializable property referencing the array whose contents to display.
- Optionalparent: InspectorFieldContainer
- OptionalfnGetParentFieldConditionals: (() => InspectorFieldConditionalInfo[])
  - - (): InspectorFieldConditionalInfo[]
    - Returns InspectorFieldConditionalInfo[]
Returns InspectorFieldBase
Inspectable field that can be used for displaying the UI for an InspectableProperty of the provided type.

`Static`findPathInFields

findPathInFields(path, depth, fields): InspectorFieldBase
Searches for a field with the specified path.
Parameters
- path: string
  Path to search for. Path entries are readable field names separated with /. Fields within categories are placed within a special category group, surrounded by []. Examples: - myField - myObject/myField - myObject/[myCategory]/myField
- depth: number
  Path depth at which the provided set of fields is at.
- fields: InspectorFieldBase[]
  List of fields to search. Children will be searched recursively.
Returns InspectorFieldBase
Matching field if one is found, null otherwise.

`Static`getSubPath

getSubPath(path, count): string
Returns the top-most part of the provided field path. See findPath2 for more information about paths.
Parameters
- path: string
  Path to return the sub-path of.
- count: number
  Number of path elements to retrieve.
Returns string
First count elements of the path.

`Static`updateState

updateState(state): {
newState: EnumValue<InspectableState, number>;
oldState: EnumValue<InspectableState, number>;
}
A helper function that takes a state by reference. If the state has InspectableState.Modified set, the state is set to InspectableState.NotModified. Returns an object of the oldState (before modifying it) and the newState that should be set on the field.

This method should usually be used as such:
Parameters
- state: EnumValue<InspectableState, number>
  The current state of the field.
Returns {
newState: EnumValue<InspectableState, number>;
oldState: EnumValue<InspectableState, number>;
}
An object of the old state of the field and the new state that it should be set to.
- newState: EnumValue<InspectableState, number>
- oldState: EnumValue<InspectableState, number>
Example
```
const [oldState, newState] = InspectorField.updateState(this._state);
	this._state = newState;
	return oldState;
```

Class InspectorFieldBaseAbstract Public Self

Hierarchy (view full)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns InspectorFieldBase

Properties

Protected_active

Protected Readonly_context

Protected Readonly_depth

Protected_disabled

Protected Readonly_formLayoutSection

Protected Readonly_inspector

Protected_isReadOnly

Protected Readonly_name

Protected Readonly_path

Protected_property

Protected Readonly_propertyType

Protected Readonly_title

endUndo

startUndo

startUndoForPath

Type declaration

Parameters

Returns void

Accessors

container

Returns InspectorFieldContainer

decoration

Returns InspectablePropertyDecoration

depth

Returns number

formLayoutSection

Returns InspectorFormLayoutSection

isActive

Returns boolean

Parameters

Returns void

isDisabled

Returns boolean

Parameters

Returns void

isFocused

Returns boolean

isReadOnly

Returns boolean

Parameters

Returns void

name

Returns string

path

Returns string

property

Returns InspectableProperty

Parameters

Returns void

undoRedo

Returns UndoRedo

Methods

destroy

Returns void

findPath

Parameters

Returns InspectorFieldBase

Abstractinitialize

Returns any

notifyNeedsRefresh

Returns void

refresh

Parameters

Returns EnumValue<InspectableState, number>

setActive

Parameters

Returns void

setDisabled

Class InspectorFieldBase`Abstract` `Public Self`

`Protected`_active

`Protected` `Readonly`_context

`Protected` `Readonly`_depth

`Protected`_disabled

`Protected` `Readonly`_formLayoutSection

`Protected` `Readonly`_inspector

`Protected`_isReadOnly

`Protected` `Readonly`_name

`Protected` `Readonly`_path

`Protected`_property

`Protected` `Readonly`_propertyType

`Protected` `Readonly`_title

`Abstract`initialize

`Static`createField

`Static`findPathInFields

`Static`getSubPath

`Static`updateState

Returns {
newState: EnumValue<InspectableState, number>;
oldState: EnumValue<InspectableState, number>;
}