addItem()
Home > @gooddata/sdk-ui-dashboard > IFluidLayoutCustomizer > addItem
IFluidLayoutCustomizer.addItem() method
Adds a new item containing a custom widget onto the dashboard.
Signature:
addItem(sectionIdx: number, itemIdx: number, item: IDashboardLayoutItem<ICustomWidget>): IFluidLayoutCustomizer;
Parameters
| Parameter | Type | Description |
|---|---|---|
| sectionIdx | number | index of section where to add the new item |
| itemIdx | number | index within the section where to add new item; you may specify -1 to add the item at the end of the section |
| item | IDashboardLayoutItem<ICustomWidget> | item containing custom widget; note: customizer will make a deep copy of the item before adding it onto a dashboard. At this moment, the newly added items are read-only. |
Returns:
Remarks
New item will be added to an existing section at index sectionIdx and within that section will be placed at itemIdx. The item to add must contain a custom widget data. Attempts to add item that does not contain any widget data will be ignored and warnings will be reported. Keep in mind that this can lead to further errors or problems down the line if you are adding more items at specific indexes into the same section.
Note: new items will be added into existing sections before new sections will be added using the IFluidLayoutCustomizer.addSection() method. Therefore,