Skip to main content

CustomItem Class

A custom item that allows you to implement and embed any additional items into the Web Dashboard.

Declaration

export class CustomItem extends DataDashboardItem

Remarks

In addition to numerous built-in dashboard items, you can implement and embed your own items into the Web Dashboard - custom items.

The image below demonstrates the FunnelD3 custom item that supports data binding, master filtering, and coloring:

CustomItem_Funnel_Main

You can find and download the full example on GitHub:

View Example: ASP.NET Core View Example: Angular View Example: React

Refer to the following topic for more information on custom items: Custom Item.

constructor(_meta)

Initializes a new instance of the CustomItem class with specified settings.

Declaration

constructor(
    _meta: DevExpress.Dashboard.Model.ICustomItemMetaData,
    modelJson?: any,
    serializer?: DevExpress.Analytics.Utils.ModelSerializer
)

Parameters

Name Type Description
_meta ICustomItemMetaData
modelJson any

A JSON object used for dashboard deserialization. Do not pass this parameter directly.

serializer ModelSerializer

An object used for dashboard deserialization. Do not pass this parameter directly.

Properties

coloringDimensions Property

Declaration

coloringDimensions: ko.ObservableArray<DevExpress.Dashboard.Model.DataItemLink>

Property Value

Type
ObservableArray<DataItemLink>

coloringMeasures Property

Declaration

coloringMeasures: ko.ObservableArray<DevExpress.Dashboard.Model.DataItemLink>

Property Value

Type
ObservableArray<DataItemLink>

coloringOptions Property

Declaration

coloringOptions: DevExpress.Dashboard.Model.DashboardItemColoringOptions

Property Value

Type
DashboardItemColoringOptions

colorScheme Property

Declaration

colorScheme: ko.ObservableArray<DevExpress.Dashboard.Model.ColorSchemeEntry>

Property Value

Type
ObservableArray<ColorSchemeEntry>

customBindings Property

Declaration

get customBindings(): Array<DevExpress.Dashboard.Model.ICustomItemBinding>

Property Value

Type
ICustomItemBinding[]

customInteractivity Property

Declaration

get customInteractivity(): any

Property Value

Type
any

customItemType Property

Declaration

customItemType: ko.Observable<string>

Property Value

Type
Observable<string>

customMetadata Property

Declaration

customMetadata: {}

interactivityOptions Property

Declaration

interactivityOptions: any

Property Value

Type
any

interactivityTargets Property

Declaration

interactivityTargets: ko.ObservableArray<DevExpress.Dashboard.Model.DataItemLink>

Property Value

Type
ObservableArray<DataItemLink>

ItemType Property

Declaration

static ItemType: string

Property Value

Type
string

legacyCustomProperties Property

Declaration

get legacyCustomProperties(): Array<DevExpress.Dashboard.Model.ICustomItemProperty>

Property Value

Type
ICustomItemProperty[]

sliceTables Property

Declaration

sliceTables: ko.ObservableArray<DevExpress.Dashboard.Model.SliceTable>

Property Value

Type
ObservableArray<SliceTable>

Methods

getBindingValue(propertyName) Method

Declaration

getBindingValue(
    propertyName: string,
    index?: number
): Array<DevExpress.Dashboard.Model.ICustomItemBindingValue>

Parameters

Name Type
propertyName string
index number

Returns

Type
ICustomItemBindingValue[]

getInfo Method

Declaration

getInfo(): DevExpress.Analytics.Utils.ISerializationInfoArray

Returns

Type
ISerializationInfoArray

getPropertyInfo(p) Method

Declaration

static getPropertyInfo(
    p: DevExpress.Dashboard.Model.ICustomItemProperty
): DevExpress.Dashboard.Metadata.IDashboardSerializationInfo

Parameters

Name Type
p ICustomItemProperty

Returns

Type
IDashboardSerializationInfo

isDrillDownAllowed Method

Declaration

isDrillDownAllowed(): boolean

Returns

Type
boolean

isFilterAllowed Method

Declaration

isFilterAllowed(): boolean

Returns

Type
boolean

iterateData(action) Method

Declaration

iterateData(
    action: (item: DevExpress.Dashboard.Model.ICustomDataRow) => any,
    sliceTableName?: string
): void

Parameters

Name Type
action (item: ICustomDataRow) => any
sliceTableName string