Skip to main content
Version: 2.0.0-beta

Interface: ArrayProperty<T, ArrayT>

Type parameters

NameType
Textends ArrayT[] = any[]
ArrayTextends CMSType = CMSType

Hierarchy

Properties

Field

Optional Field: ComponentType<FieldProps<T, any, any>>

If you need to render a custom field, you can create a component that takes FieldProps as props. You receive the value, a function to update the value and additional utility props such as if there is an error. You can customize it by passing custom props that are received in the component.

Inherited from

BaseProperty.Field

Defined in

lib/src/types/properties.ts:145


Preview

Optional Preview: ComponentType<PropertyPreviewProps<T, any, Record<string, any>>>

Configure how a property is displayed as a preview, e.g. in the collection view. You can customize it by passing custom props that are received in the component.

Inherited from

BaseProperty.Preview

Defined in

lib/src/types/properties.ts:152


columnWidth

Optional columnWidth: number

Width in pixels of this column in the collection view. If not set the width is inferred based on the other configurations

Inherited from

BaseProperty.columnWidth

Defined in

lib/src/types/properties.ts:111


customProps

Optional customProps: any

Additional props that are passed to the components defined in field or in preview.

Inherited from

BaseProperty.customProps

Defined in

lib/src/types/properties.ts:158


dataType

dataType: "array"

Datatype of the property

Overrides

BaseProperty.dataType

Defined in

lib/src/types/properties.ts:421


defaultValue

Optional defaultValue: T

This value will be set by default for new entities.

Inherited from

BaseProperty.defaultValue

Defined in

lib/src/types/properties.ts:163


description

Optional description: string

Property description, always displayed under the field

Inherited from

BaseProperty.description

Defined in

lib/src/types/properties.ts:92


disabled

Optional disabled: boolean | PropertyDisabledConfig

Is this field disabled. When set to true, it gets rendered as a disabled field. You can also specify a configuration for defining the behaviour of disabled properties (including custom messages, clear value on disabled or hide the field completely)

Inherited from

BaseProperty.disabled

Defined in

lib/src/types/properties.ts:131


editable

Optional editable: boolean

Should this property be editable in the collection editor. If the property has been defined in code, it defaults to false otherwise, it defaults to true.

Inherited from

BaseProperty.editable

Defined in

lib/src/types/properties.ts:170


expanded

Optional expanded: boolean

Should the field be initially expanded. Defaults to true

Defined in

lib/src/types/properties.ts:481


fieldConfig

Optional fieldConfig: string

You can use this prop to reuse a property that has been defined in the top level of the CMS in the prop fields. All the configuration will be taken from the inherited config, and overwritten by the current property config.

Inherited from

BaseProperty.fieldConfig

Defined in

lib/src/types/properties.ts:100


hideFromCollection

Optional hideFromCollection: boolean

Do not show this property in the collection view

Inherited from

BaseProperty.hideFromCollection

Defined in

lib/src/types/properties.ts:116


longDescription

Optional longDescription: string

Longer description of a field, displayed under a popover

Inherited from

BaseProperty.longDescription

Defined in

lib/src/types/properties.ts:105


name

Optional name: string

Property name (e.g. Product)

Inherited from

BaseProperty.name

Defined in

lib/src/types/properties.ts:87


of

Optional of: PropertyOrBuilder<ArrayT, Record<string, any>> | Property<ArrayT>[]

The property of this array. You can specify any property (except another Array property) You can leave this field empty only if you are providing a custom field, otherwise an error will be thrown.

Defined in

lib/src/types/properties.ts:429


oneOf

Optional oneOf: Object

Use this field if you would like to have an array of properties. It is useful if you need to have values of different types in the same array. Each entry of the array is an object with the shape:

{ type: "YOUR_TYPE", value: "YOUR_VALUE"}

Note that you can use any property so value can take any value (strings, numbers, array, objects...) You can customise the type and value fields to suit your needs.

An example use case for this feature may be a blog entry, where you have images and text blocks using markdown.

Type declaration

NameTypeDescription
propertiesProperties<any>Record of properties, where the key is the type and the value is the corresponding property
propertiesOrder?Extract<keyof T, string>[]Order in which the properties are displayed. If you are specifying your collection as code, the order is the same as the one you define in properties, and you don't need to specify this prop.
typeField?stringName of the field to use as the discriminator for type Defaults to type
valueField?stringName of the field to use as the value Defaults to value

Defined in

lib/src/types/properties.ts:446


readOnly

Optional readOnly: boolean

Is this a read only property. When set to true, it gets rendered as a preview.

Inherited from

BaseProperty.readOnly

Defined in

lib/src/types/properties.ts:122


validation

Optional validation: ArrayPropertyValidationSchema

Rules for validating this property

Overrides

BaseProperty.validation

Defined in

lib/src/types/properties.ts:476

Enterprise?

Learn how to get the most out of your project with the help of our consulting team.
Get in touch
Sign up to our newsletter to get the latest news and updates. No spam!