> Documentation index: https://www.gooddata.ai/docs/gooddata-ui/llms.txt lists every page of these docs as Markdown.

# IAttributeElementLoader

- Package: [@gooddata/sdk-ui-filters](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/index.md)
- Kind: interface
- Source: https://github.com/gooddata/gooddata-ui-sdk/blob/rel/11.64/libs/sdk-ui-filters/src/AttributeFilterHandler/types/elementsLoader.ts

Handles the loading of the attribute elements.

**Signature:**

```typescript
export interface IAttributeElementLoader 
```

## Properties

| Property | Modifiers | Type | Description |
| --- | --- | --- | --- |
| [onInitTotalCountCancel](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloaderoninittotalcountcancel) |  | [CallbackRegistration](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.callbackregistration/index.md)<[OnInitTotalCountCancelCallbackPayload](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.oninittotalcountcancelcallbackpayload/index.md)> | Registers a callback that will be fired when the initialization of total count was canceled. Returns unsubscribe function, that will unregister it. |
| [onInitTotalCountError](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloaderoninittotalcounterror) |  | [CallbackRegistration](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.callbackregistration/index.md)<[OnInitTotalCountErrorCallbackPayload](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.oninittotalcounterrorcallbackpayload/index.md)> | Registers a callback that will be fired when error is thrown during the total count initialization. Returns unsubscribe function, that will unregister it. |
| [onInitTotalCountStart](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloaderoninittotalcountstart) |  | [CallbackRegistration](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.callbackregistration/index.md)<[OnInitTotalCountStartCallbackPayload](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.oninittotalcountstartcallbackpayload/index.md)> | Registers a callback that will be fired when the initialization of total count starts. Returns unsubscribe function, that will unregister it, once called. |
| [onInitTotalCountSuccess](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloaderoninittotalcountsuccess) |  | [CallbackRegistration](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.callbackregistration/index.md)<[OnInitTotalCountSuccessCallbackPayload](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.oninittotalcountsuccesscallbackpayload/index.md)> | Registers a callback that will be fired when the initialization of total count is successfully completed. Returns unsubscribe function, that will unregister it. |
| [onLoadCustomElementsCancel](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloaderonloadcustomelementscancel) |  | [CallbackRegistration](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.callbackregistration/index.md)<[OnLoadCustomElementsCancelCallbackPayload](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.onloadcustomelementscancelcallbackpayload/index.md)> | Registers a callback that will be fired when the custom elements load was canceled. Returns unsubscribe function, that will unregister it. |
| [onLoadCustomElementsError](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloaderonloadcustomelementserror) |  | [CallbackRegistration](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.callbackregistration/index.md)<[OnLoadCustomElementsErrorCallbackPayload](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.onloadcustomelementserrorcallbackpayload/index.md)> | Registers a callback that will be fired when error is thrown during the custom elements load. Returns unsubscribe function, that will unregister it. |
| [onLoadCustomElementsStart](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloaderonloadcustomelementsstart) |  | [CallbackRegistration](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.callbackregistration/index.md)<[OnLoadCustomElementsStartCallbackPayload](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.onloadcustomelementsstartcallbackpayload/index.md)> | Registers a callback that will be fired when the custom elements load starts. Returns unsubscribe function, that will unregister it, once called. Multiple callbacks can be registered by this function. |
| [onLoadCustomElementsSuccess](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloaderonloadcustomelementssuccess) |  | [CallbackRegistration](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.callbackregistration/index.md)<[OnLoadCustomElementsSuccessCallbackPayload](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.onloadcustomelementssuccesscallbackpayload/index.md)> | Registers a callback that will be fired when the custom elements load is successfuly completed. Returns unsubscribe function, that will unregister it. |
| [onLoadInitialElementsPageCancel](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloaderonloadinitialelementspagecancel) |  | [CallbackRegistration](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.callbackregistration/index.md)<[OnLoadInitialElementsPageCancelCallbackPayload](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.onloadinitialelementspagecancelcallbackpayload/index.md)> | Registers a callback that will be fired when the initial elements page load was canceled. Returns unsubscribe function, that will unregister it. |
| [onLoadInitialElementsPageError](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloaderonloadinitialelementspageerror) |  | [CallbackRegistration](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.callbackregistration/index.md)<[OnLoadInitialElementsPageErrorCallbackPayload](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.onloadinitialelementspageerrorcallbackpayload/index.md)> | Registers a callback that will be fired when error is thrown during the initial elements page load. Returns unsubscribe function, that will unregister it. |
| [onLoadInitialElementsPageStart](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloaderonloadinitialelementspagestart) |  | [CallbackRegistration](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.callbackregistration/index.md)<[OnLoadInitialElementsPageStartCallbackPayload](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.onloadinitialelementspagestartcallbackpayload/index.md)> | Registers a callback that will be fired when the initial elements page load starts. Returns unsubscribe function, that will unregister it, once called. Multiple callbacks can be registered by this function. |
| [onLoadInitialElementsPageSuccess](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloaderonloadinitialelementspagesuccess) |  | [CallbackRegistration](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.callbackregistration/index.md)<[OnLoadInitialElementsPageSuccessCallbackPayload](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.onloadinitialelementspagesuccesscallbackpayload/index.md)> | Registers a callback that will be fired when the initial elements page load is successfuly completed. Returns unsubscribe function, that will unregister it. |
| [onLoadIrrelevantElementsCancel](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloaderonloadirrelevantelementscancel) |  | [CallbackRegistration](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.callbackregistration/index.md)<[OnLoadIrrelevantElementsCancelCallbackPayload](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.onloadirrelevantelementscancelcallbackpayload/index.md)> | Registers a callback that will be fired when the irrelevant elements load was canceled. Returns unsubscribe function, that will unregister it. |
| [onLoadIrrelevantElementsError](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloaderonloadirrelevantelementserror) |  | [CallbackRegistration](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.callbackregistration/index.md)<[OnLoadIrrelevantElementsErrorCallbackPayload](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.onloadirrelevantelementserrorcallbackpayload/index.md)> | Registers a callback that will be fired when error is thrown during the irrelevant elements load. Returns unsubscribe function, that will unregister it. |
| [onLoadIrrelevantElementsStart](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloaderonloadirrelevantelementsstart) |  | [CallbackRegistration](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.callbackregistration/index.md)<[OnLoadIrrelevantElementsStartCallbackPayload](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.onloadirrelevantelementsstartcallbackpayload/index.md)> | Registers a callback that will be fired when the irrelevant elements load starts. Returns unsubscribe function, that will unregister it, once called. Multiple callbacks can be registered by this function. |
| [onLoadIrrelevantElementsSuccess](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloaderonloadirrelevantelementssuccess) |  | [CallbackRegistration](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.callbackregistration/index.md)<[OnLoadIrrelevantElementsSuccessCallbackPayload](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.onloadirrelevantelementssuccesscallbackpayload/index.md)> | Registers a callback that will be fired when the irrelevant elements load is successfuly completed. Returns unsubscribe function, that will unregister it. |
| [onLoadNextElementsPageCancel](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloaderonloadnextelementspagecancel) |  | [CallbackRegistration](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.callbackregistration/index.md)<[OnLoadNextElementsPageCancelCallbackPayload](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.onloadnextelementspagecancelcallbackpayload/index.md)> | Registers a callback that will be fired when the next elements page load was canceled. Returns unsubscribe function, that will unregister it. |
| [onLoadNextElementsPageError](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloaderonloadnextelementspageerror) |  | [CallbackRegistration](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.callbackregistration/index.md)<[OnLoadNextElementsPageErrorCallbackPayload](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.onloadnextelementspageerrorcallbackpayload/index.md)> | Registers a callback that will be fired when error is thrown during the next elements page load. Returns unsubscribe function, that will unregister it. |
| [onLoadNextElementsPageStart](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloaderonloadnextelementspagestart) |  | [CallbackRegistration](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.callbackregistration/index.md)<[OnLoadNextElementsPageStartCallbackPayload](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.onloadnextelementspagestartcallbackpayload/index.md)> | Registers a callback that will be fired when the next elements page load starts. Returns unsubscribe function, that will unregister it, once called. Multiple callbacks can be registered by this function. |
| [onLoadNextElementsPageSuccess](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloaderonloadnextelementspagesuccess) |  | [CallbackRegistration](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.callbackregistration/index.md)<[OnLoadNextElementsPageSuccessCallbackPayload](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.onloadnextelementspagesuccesscallbackpayload/index.md)> | Registers a callback that will be fired when the next elements page load is successfuly completed. Returns unsubscribe function, that will unregister it. |

## Methods

| Method | Description |
| --- | --- |
| [cancelCustomElementsLoad(correlation)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadercancelcustomelementsload) | Cancels the running custom elements load, if it matches the specified correlation. |
| [cancelInitialElementsPageLoad()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadercancelinitialelementspageload) | Cancels the running initial elements page load, if any. |
| [cancelIrrelevantElementsLoad(correlation)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadercancelirrelevantelementsload) | Cancels the running irrelevant elements load, if it matches the specified correlation. |
| [cancelNextElementsPageLoad()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadercancelnextelementspageload) | Cancels the running next elements page load, if any. |
| [getAllElements()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadergetallelements) | Returns all attribute elements loaded by initialElementsPageLoad and nextElementsPageLoad methods. |
| [getDisplayAsLabel()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadergetdisplayaslabel) | Get the label used for representing the attribute filter elements visually if defined. |
| [getElementsByKey(keys)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadergetelementsbykey) | Returns the attribute elements for the specified keys. |
| [getInitialElementsPageError()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadergetinitialelementspageerror) | Returns error, if it was thrown during the initial elements page load, undefined otherwise. |
| [getInitialElementsPageStatus()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadergetinitialelementspagestatus) | Returns the current status of the initial elements page load. |
| [getInitTotalCountError()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadergetinittotalcounterror) | Returns error, if it was thrown during the total count initialization, undefined otherwise. |
| [getInitTotalCountStatus()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadergetinittotalcountstatus) | Returns the current status of the total count initialization. |
| [getLimit()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadergetlimit) | Returns the current limit used for the attribute element loads. |
| [getLimitingAttributeFilters()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadergetlimitingattributefilters) | Returns the current attribute filters used to filter the attribute element loads. |
| [getLimitingAttributeFiltersAttributes()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadergetlimitingattributefiltersattributes) | Returns metadata of the attributes set by [IAttributeElementLoader.setLimitingAttributeFilters()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadersetlimitingattributefilters). Note that these attributes will be available only after successful initialization, or after successful [IAttributeElementLoader.loadInitialElementsPage()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloaderloadinitialelementspage) load. |
| [getLimitingDateFilters()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadergetlimitingdatefilters) | Returns the current date filters used to filter the attribute element loads. |
| [getLimitingMeasures()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadergetlimitingmeasures) | Returns the current measures used to filter the attribute element loads. |
| [getLimitingValidationItems()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadergetlimitingvalidationitems) | Return the current validation items used to filter the attribute element loads. |
| [getNextElementsPageError()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadergetnextelementspageerror) | Returns error, if it was thrown during the next elements page load, undefined otherwise. |
| [getNextElementsPageStatus()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadergetnextelementspagestatus) | Returns the current status of the next elements page load. |
| [getOffset()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadergetoffset) | Returns the current offset used for the attribute element loads. |
| [getOrder()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadergetorder) | Returns the current order used for the attribute element loads. |
| [getSearch()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadergetsearch) | Returns the current search string used to filter the attribute element loads. |
| [getTotalElementsCount()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadergettotalelementscount) | Returns the total count of the attribute elements. Total elements count is loaded by default only for child filters. |
| [getTotalElementsCountWithCurrentSettings()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadergettotalelementscountwithcurrentsettings) | Returns the total count of the attribute elements with currently set options. |
| [initTotalCount(correlation)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloaderinittotalcount) | Starts load of total count |
| [loadCustomElements(options, correlation)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloaderloadcustomelements) | Loads the attribute elements with the provided options. |
| [loadInitialElementsPage(correlation)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloaderloadinitialelementspage) | Resets the paging and loads the attribute elements with the current options. |
| [loadIrrelevantElements(correlation)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloaderloadirrelevantelements) | Loads the irrelevant subset of currently selected elements. Irrelevant elements are the selected elements that may be filtered out by limiting filters. |
| [loadNextElementsPage(correlation)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloaderloadnextelementspage) | Loads next page of the attribute elements with the current options. |
| [setDisplayAsLabel(displayAsLabel)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadersetdisplayaslabel) | Set the label used for representing the attribute filter elements visually. |
| [setDisplayForm(displayForm)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadersetdisplayform) | Set attribute's display form |
| [setLimit(limit)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadersetlimit) | Set the limit for the upcoming attribute element loads. |
| [setLimitingAttributeFilters(filters)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadersetlimitingattributefilters) | Set the attribute filters to filter the upcoming attribute element loads. |
| [setLimitingDateFilters(filters)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadersetlimitingdatefilters) | Set the date filters to filter the upcoming attribute element loads. |
| [setLimitingMeasures(measures)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadersetlimitingmeasures) | Set the measures to filter the upcoming attribute element loads. |
| [setLimitingValidationItems(validateBy)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadersetlimitingvalidationitems) | Set the validation items to filter the upcoming attribute element loads. |
| [setOrder(order)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadersetorder) | Set the order for the upcoming attribute element loads. |
| [setSearch(search)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadersetsearch) | Set the search to filter the upcoming attribute element loads. |

## Property details

### IAttributeElementLoader.onInitTotalCountCancel

Registers a callback that will be fired when the initialization of total count was canceled. Returns unsubscribe function, that will unregister it.

**Signature:**

```typescript
onInitTotalCountCancel: CallbackRegistration<OnInitTotalCountCancelCallbackPayload>;
```

### IAttributeElementLoader.onInitTotalCountError

Registers a callback that will be fired when error is thrown during the total count initialization. Returns unsubscribe function, that will unregister it.

**Signature:**

```typescript
onInitTotalCountError: CallbackRegistration<OnInitTotalCountErrorCallbackPayload>;
```

### IAttributeElementLoader.onInitTotalCountStart

Registers a callback that will be fired when the initialization of total count starts. Returns unsubscribe function, that will unregister it, once called.

**Signature:**

```typescript
onInitTotalCountStart: CallbackRegistration<OnInitTotalCountStartCallbackPayload>;
```

### IAttributeElementLoader.onInitTotalCountSuccess

Registers a callback that will be fired when the initialization of total count is successfully completed. Returns unsubscribe function, that will unregister it.

**Signature:**

```typescript
onInitTotalCountSuccess: CallbackRegistration<OnInitTotalCountSuccessCallbackPayload>;
```

### IAttributeElementLoader.onLoadCustomElementsCancel

Registers a callback that will be fired when the custom elements load was canceled. Returns unsubscribe function, that will unregister it.

**Signature:**

```typescript
onLoadCustomElementsCancel: CallbackRegistration<OnLoadCustomElementsCancelCallbackPayload>;
```

#### Remarks

Multiple callbacks can be registered by this function.

### IAttributeElementLoader.onLoadCustomElementsError

Registers a callback that will be fired when error is thrown during the custom elements load. Returns unsubscribe function, that will unregister it.

**Signature:**

```typescript
onLoadCustomElementsError: CallbackRegistration<OnLoadCustomElementsErrorCallbackPayload>;
```

#### Remarks

Multiple callbacks can be registered by this function.

### IAttributeElementLoader.onLoadCustomElementsStart

Registers a callback that will be fired when the custom elements load starts. Returns unsubscribe function, that will unregister it, once called.

Multiple callbacks can be registered by this function.

**Signature:**

```typescript
onLoadCustomElementsStart: CallbackRegistration<OnLoadCustomElementsStartCallbackPayload>;
```

### IAttributeElementLoader.onLoadCustomElementsSuccess

Registers a callback that will be fired when the custom elements load is successfuly completed. Returns unsubscribe function, that will unregister it.

**Signature:**

```typescript
onLoadCustomElementsSuccess: CallbackRegistration<OnLoadCustomElementsSuccessCallbackPayload>;
```

#### Remarks

Multiple callbacks can be registered by this function.

### IAttributeElementLoader.onLoadInitialElementsPageCancel

Registers a callback that will be fired when the initial elements page load was canceled. Returns unsubscribe function, that will unregister it.

**Signature:**

```typescript
onLoadInitialElementsPageCancel: CallbackRegistration<OnLoadInitialElementsPageCancelCallbackPayload>;
```

#### Remarks

Multiple callbacks can be registered by this function.

### IAttributeElementLoader.onLoadInitialElementsPageError

Registers a callback that will be fired when error is thrown during the initial elements page load. Returns unsubscribe function, that will unregister it.

**Signature:**

```typescript
onLoadInitialElementsPageError: CallbackRegistration<OnLoadInitialElementsPageErrorCallbackPayload>;
```

#### Remarks

Multiple callbacks can be registered by this function.

### IAttributeElementLoader.onLoadInitialElementsPageStart

Registers a callback that will be fired when the initial elements page load starts. Returns unsubscribe function, that will unregister it, once called.

Multiple callbacks can be registered by this function.

**Signature:**

```typescript
onLoadInitialElementsPageStart: CallbackRegistration<OnLoadInitialElementsPageStartCallbackPayload>;
```

### IAttributeElementLoader.onLoadInitialElementsPageSuccess

Registers a callback that will be fired when the initial elements page load is successfuly completed. Returns unsubscribe function, that will unregister it.

**Signature:**

```typescript
onLoadInitialElementsPageSuccess: CallbackRegistration<OnLoadInitialElementsPageSuccessCallbackPayload>;
```

#### Remarks

Multiple callbacks can be registered by this function.

### IAttributeElementLoader.onLoadIrrelevantElementsCancel

Registers a callback that will be fired when the irrelevant elements load was canceled. Returns unsubscribe function, that will unregister it.

**Signature:**

```typescript
onLoadIrrelevantElementsCancel: CallbackRegistration<OnLoadIrrelevantElementsCancelCallbackPayload>;
```

#### Remarks

Multiple callbacks can be registered by this function.

### IAttributeElementLoader.onLoadIrrelevantElementsError

Registers a callback that will be fired when error is thrown during the irrelevant elements load. Returns unsubscribe function, that will unregister it.

**Signature:**

```typescript
onLoadIrrelevantElementsError: CallbackRegistration<OnLoadIrrelevantElementsErrorCallbackPayload>;
```

#### Remarks

Multiple callbacks can be registered by this function.

### IAttributeElementLoader.onLoadIrrelevantElementsStart

Registers a callback that will be fired when the irrelevant elements load starts. Returns unsubscribe function, that will unregister it, once called.

Multiple callbacks can be registered by this function.

**Signature:**

```typescript
onLoadIrrelevantElementsStart: CallbackRegistration<OnLoadIrrelevantElementsStartCallbackPayload>;
```

### IAttributeElementLoader.onLoadIrrelevantElementsSuccess

Registers a callback that will be fired when the irrelevant elements load is successfuly completed. Returns unsubscribe function, that will unregister it.

**Signature:**

```typescript
onLoadIrrelevantElementsSuccess: CallbackRegistration<OnLoadIrrelevantElementsSuccessCallbackPayload>;
```

#### Remarks

Multiple callbacks can be registered by this function.

### IAttributeElementLoader.onLoadNextElementsPageCancel

Registers a callback that will be fired when the next elements page load was canceled. Returns unsubscribe function, that will unregister it.

**Signature:**

```typescript
onLoadNextElementsPageCancel: CallbackRegistration<OnLoadNextElementsPageCancelCallbackPayload>;
```

#### Remarks

Multiple callbacks can be registered by this function.

### IAttributeElementLoader.onLoadNextElementsPageError

Registers a callback that will be fired when error is thrown during the next elements page load. Returns unsubscribe function, that will unregister it.

**Signature:**

```typescript
onLoadNextElementsPageError: CallbackRegistration<OnLoadNextElementsPageErrorCallbackPayload>;
```

#### Remarks

Multiple callbacks can be registered by this function.

### IAttributeElementLoader.onLoadNextElementsPageStart

Registers a callback that will be fired when the next elements page load starts. Returns unsubscribe function, that will unregister it, once called.

Multiple callbacks can be registered by this function.

**Signature:**

```typescript
onLoadNextElementsPageStart: CallbackRegistration<OnLoadNextElementsPageStartCallbackPayload>;
```

### IAttributeElementLoader.onLoadNextElementsPageSuccess

Registers a callback that will be fired when the next elements page load is successfuly completed. Returns unsubscribe function, that will unregister it.

**Signature:**

```typescript
onLoadNextElementsPageSuccess: CallbackRegistration<OnLoadNextElementsPageSuccessCallbackPayload>;
```

#### Remarks

Multiple callbacks can be registered by this function.

## Method details

### IAttributeElementLoader.cancelCustomElementsLoad()

Cancels the running custom elements load, if it matches the specified correlation.

**Signature:**

```typescript
cancelCustomElementsLoad(correlation?: Correlation): void;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| correlation | [Correlation](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.correlation/index.md) | _(Optional)_ |

**Returns:**

void

### IAttributeElementLoader.cancelInitialElementsPageLoad()

Cancels the running initial elements page load, if any.

**Signature:**

```typescript
cancelInitialElementsPageLoad(): void;
```
**Returns:**

void

### IAttributeElementLoader.cancelIrrelevantElementsLoad()

Cancels the running irrelevant elements load, if it matches the specified correlation.

**Signature:**

```typescript
cancelIrrelevantElementsLoad(correlation?: Correlation): void;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| correlation | [Correlation](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.correlation/index.md) | _(Optional)_ |

**Returns:**

void

### IAttributeElementLoader.cancelNextElementsPageLoad()

Cancels the running next elements page load, if any.

**Signature:**

```typescript
cancelNextElementsPageLoad(): void;
```
**Returns:**

void

### IAttributeElementLoader.getAllElements()

Returns all attribute elements loaded by initialElementsPageLoad and nextElementsPageLoad methods.

**Signature:**

```typescript
getAllElements(): IAttributeElement[];
```
**Returns:**

[IAttributeElement](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iattributeelement/index.md)[]

#### Remarks

It does not return attribute elements loaded by loadCustomElements method. To get them, you should use callbacks or getElementsByKey method.

### IAttributeElementLoader.getDisplayAsLabel()

Get the label used for representing the attribute filter elements visually if defined.

**Signature:**

```typescript
getDisplayAsLabel(): ObjRef | undefined;
```
**Returns:**

[ObjRef](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.objref/index.md) &#124; undefined

### IAttributeElementLoader.getElementsByKey()

Returns the attribute elements for the specified keys.

**Signature:**

```typescript
getElementsByKey(keys: AttributeElementKey[]): IAttributeElement[];
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| keys | [AttributeElementKey](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.attributeelementkey/index.md)[] |  |

**Returns:**

[IAttributeElement](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iattributeelement/index.md)[]

#### Remarks

If the attribute elements for the specified keys are not loaded, error is thrown.

### IAttributeElementLoader.getInitialElementsPageError()

Returns error, if it was thrown during the initial elements page load, undefined otherwise.

**Signature:**

```typescript
getInitialElementsPageError(): GoodDataSdkError | undefined;
```
**Returns:**

[GoodDataSdkError](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui/sdk-ui.gooddatasdkerror/index.md) &#124; undefined

### IAttributeElementLoader.getInitialElementsPageStatus()

Returns the current status of the initial elements page load.

**Signature:**

```typescript
getInitialElementsPageStatus(): AsyncOperationStatus;
```
**Returns:**

[AsyncOperationStatus](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.asyncoperationstatus/index.md)

### IAttributeElementLoader.getInitTotalCountError()

Returns error, if it was thrown during the total count initialization, undefined otherwise.

**Signature:**

```typescript
getInitTotalCountError(): GoodDataSdkError | undefined;
```
**Returns:**

[GoodDataSdkError](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui/sdk-ui.gooddatasdkerror/index.md) &#124; undefined

### IAttributeElementLoader.getInitTotalCountStatus()

Returns the current status of the total count initialization.

**Signature:**

```typescript
getInitTotalCountStatus(): AsyncOperationStatus;
```
**Returns:**

[AsyncOperationStatus](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.asyncoperationstatus/index.md)

### IAttributeElementLoader.getLimit()

Returns the current limit used for the attribute element loads.

**Signature:**

```typescript
getLimit(): number;
```
**Returns:**

number

### IAttributeElementLoader.getLimitingAttributeFilters()

Returns the current attribute filters used to filter the attribute element loads.

**Signature:**

```typescript
getLimitingAttributeFilters(): IElementsQueryAttributeFilter[];
```
**Returns:**

[IElementsQueryAttributeFilter](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.ielementsqueryattributefilter/index.md)[]

### IAttributeElementLoader.getLimitingAttributeFiltersAttributes()

Returns metadata of the attributes set by [IAttributeElementLoader.setLimitingAttributeFilters()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloadersetlimitingattributefilters).

Note that these attributes will be available only after successful initialization, or after successful [IAttributeElementLoader.loadInitialElementsPage()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributeelementloader/index.md#iattributeelementloaderloadinitialelementspage) load.

**Signature:**

```typescript
getLimitingAttributeFiltersAttributes(): IAttributeMetadataObject[];
```
**Returns:**

[IAttributeMetadataObject](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iattributemetadataobject/index.md)[]

### IAttributeElementLoader.getLimitingDateFilters()

Returns the current date filters used to filter the attribute element loads.

**Signature:**

```typescript
getLimitingDateFilters(): (IRelativeDateFilter | IAbsoluteDateFilter)[];
```
**Returns:**

([IRelativeDateFilter](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.irelativedatefilter/index.md) &#124; [IAbsoluteDateFilter](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iabsolutedatefilter/index.md))[]

### IAttributeElementLoader.getLimitingMeasures()

Returns the current measures used to filter the attribute element loads.

**Signature:**

```typescript
getLimitingMeasures(): IMeasure[];
```
**Returns:**

[IMeasure](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.imeasure/index.md)[]

### IAttributeElementLoader.getLimitingValidationItems()

Return the current validation items used to filter the attribute element loads.

**Signature:**

```typescript
getLimitingValidationItems(): ObjRef[];
```
**Returns:**

[ObjRef](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.objref/index.md)[]

### IAttributeElementLoader.getNextElementsPageError()

Returns error, if it was thrown during the next elements page load, undefined otherwise.

**Signature:**

```typescript
getNextElementsPageError(): GoodDataSdkError | undefined;
```
**Returns:**

[GoodDataSdkError](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui/sdk-ui.gooddatasdkerror/index.md) &#124; undefined

### IAttributeElementLoader.getNextElementsPageStatus()

Returns the current status of the next elements page load.

**Signature:**

```typescript
getNextElementsPageStatus(): AsyncOperationStatus;
```
**Returns:**

[AsyncOperationStatus](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.asyncoperationstatus/index.md)

### IAttributeElementLoader.getOffset()

Returns the current offset used for the attribute element loads.

**Signature:**

```typescript
getOffset(): number;
```
**Returns:**

number

### IAttributeElementLoader.getOrder()

Returns the current order used for the attribute element loads.

**Signature:**

```typescript
getOrder(): SortDirection | undefined;
```
**Returns:**

[SortDirection](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.sortdirection/index.md) &#124; undefined

### IAttributeElementLoader.getSearch()

Returns the current search string used to filter the attribute element loads.

**Signature:**

```typescript
getSearch(): string;
```
**Returns:**

string

### IAttributeElementLoader.getTotalElementsCount()

Returns the total count of the attribute elements. Total elements count is loaded by default only for child filters.

**Signature:**

```typescript
getTotalElementsCount(): number | undefined;
```
**Returns:**

number &#124; undefined

### IAttributeElementLoader.getTotalElementsCountWithCurrentSettings()

Returns the total count of the attribute elements with currently set options.

**Signature:**

```typescript
getTotalElementsCountWithCurrentSettings(): number | undefined;
```
**Returns:**

number &#124; undefined

### IAttributeElementLoader.initTotalCount()

Starts load of total count

**Signature:**

```typescript
initTotalCount(correlation?: Correlation): void;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| correlation | [Correlation](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.correlation/index.md) | _(Optional)_ correlation that will be included in all callbacks fired by this method |

**Returns:**

void

### IAttributeElementLoader.loadCustomElements()

Loads the attribute elements with the provided options.

**Signature:**

```typescript
loadCustomElements(options: ILoadElementsOptions, correlation?: Correlation): void;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| options | [ILoadElementsOptions](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iloadelementsoptions/index.md) | options to apply for the custom elements load |
| correlation | [Correlation](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.correlation/index.md) | _(Optional)_ correlation that will be included in all callbacks fired by this method |

**Returns:**

void

#### Remarks

This is useful, if you want to load additional attribute elements with different options than the currently set.

Multiple custom elements loads will run in parallel.

Cancels the running custom elements load, if it matches the specified correlation, and starts it again.

You can provide a correlation that will be included in the payload of all callbacks fired as a result of calling this method.

### IAttributeElementLoader.loadInitialElementsPage()

Resets the paging and loads the attribute elements with the current options.

**Signature:**

```typescript
loadInitialElementsPage(correlation?: Correlation): void;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| correlation | [Correlation](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.correlation/index.md) | _(Optional)_ correlation that will be included in all callbacks fired by this method |

**Returns:**

void

#### Remarks

You should call this every time you change the load options (eg search, limit, limitingAttribute filters, etc).

Throws error if you call it before the initialization.

Throws error if you combine staticElements with unsupported elements load options (limitingAttributeFilters, limitingMeasures or limitingDateFilters).

Cancels the running initial elements page load, if any, and starts it again.

Cancels the running next elements page load, if any.

You can provide a correlation that will be included in the payload of all callbacks fired as a result of calling this method.

### IAttributeElementLoader.loadIrrelevantElements()

Loads the irrelevant subset of currently selected elements.

Irrelevant elements are the selected elements that may be filtered out by limiting filters.

**Signature:**

```typescript
loadIrrelevantElements(correlation?: Correlation): void;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| correlation | [Correlation](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.correlation/index.md) | _(Optional)_ correlation that will be included in all callbacks fired by this method |

**Returns:**

void

#### Remarks

This is useful, if you want to load additional irrelevant elements with different options than the currently set.

Multiple loads will run in parallel.

Cancels the running irrelevant elements load, if it matches the specified correlation, and starts it again.

You can provide a correlation that will be included in the payload of all callbacks fired as a result of calling this method.

### IAttributeElementLoader.loadNextElementsPage()

Loads next page of the attribute elements with the current options.

**Signature:**

```typescript
loadNextElementsPage(correlation?: Correlation): void;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| correlation | [Correlation](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.correlation/index.md) | _(Optional)_ correlation that will be included in all callbacks fired by this method |

**Returns:**

void

#### Remarks

Throws error if you call it before the initialization.

Throws error if you changed the load options and did not called loadInitialElementsPage before.

Cancels the running next elements page load, if any, and starts it again.

You can provide a correlation that will be included in the payload of all callbacks fired as a result of calling this method.

### IAttributeElementLoader.setDisplayAsLabel()

Set the label used for representing the attribute filter elements visually.

**Signature:**

```typescript
setDisplayAsLabel(displayAsLabel: ObjRef | undefined): void;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| displayAsLabel | [ObjRef](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.objref/index.md) \| undefined |  |

**Returns:**

void

### IAttributeElementLoader.setDisplayForm()

Set attribute's display form

**Signature:**

```typescript
setDisplayForm(displayForm: ObjRef): void;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| displayForm | [ObjRef](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.objref/index.md) |  |

**Returns:**

void

### IAttributeElementLoader.setLimit()

Set the limit for the upcoming attribute element loads.

**Signature:**

```typescript
setLimit(limit: number): void;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| limit | number | the limit to use. |

**Returns:**

void

#### Remarks

When you change the options for the attribute element loads, you should call initial elements page load.

### IAttributeElementLoader.setLimitingAttributeFilters()

Set the attribute filters to filter the upcoming attribute element loads.

**Signature:**

```typescript
setLimitingAttributeFilters(filters: IElementsQueryAttributeFilter[]): void;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| filters | [IElementsQueryAttributeFilter](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.ielementsqueryattributefilter/index.md)[] | filters to use. |

**Returns:**

void

#### Remarks

When you change the options for the attribute element loads, you should call initial elements page load.

Throws error when the backend implementation does not support parent filtering.

### IAttributeElementLoader.setLimitingDateFilters()

Set the date filters to filter the upcoming attribute element loads.

**Signature:**

```typescript
setLimitingDateFilters(filters: (IRelativeDateFilter | IAbsoluteDateFilter)[]): void;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| filters | ([IRelativeDateFilter](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.irelativedatefilter/index.md) \| [IAbsoluteDateFilter](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iabsolutedatefilter/index.md))[] | filters to use. |

**Returns:**

void

#### Remarks

When you change the options for the attribute element loads, you should call initial elements page load.

### IAttributeElementLoader.setLimitingMeasures()

Set the measures to filter the upcoming attribute element loads.

**Signature:**

```typescript
setLimitingMeasures(measures: IMeasure[]): void;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| measures | [IMeasure](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.imeasure/index.md)[] | measures to use. |

**Returns:**

void

#### Remarks

When you change the options for the attribute element loads, you should call initial elements page load.

### IAttributeElementLoader.setLimitingValidationItems()

Set the validation items to filter the upcoming attribute element loads.

**Signature:**

```typescript
setLimitingValidationItems(validateBy: ObjRef[]): void;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| validateBy | [ObjRef](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.objref/index.md)[] | measures to use. |

**Returns:**

void

#### Remarks

When you change the options for the attribute element loads, you should call initial elements page load.

Throws error when the backend implementation does not support elements validation filtering.

### IAttributeElementLoader.setOrder()

Set the order for the upcoming attribute element loads.

**Signature:**

```typescript
setOrder(order: SortDirection): void;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| order | [SortDirection](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.sortdirection/index.md) | the order to use. |

**Returns:**

void

#### Remarks

When you change the options for the attribute element loads, you should call initial elements page load.

### IAttributeElementLoader.setSearch()

Set the search to filter the upcoming attribute element loads.

**Signature:**

```typescript
setSearch(search: string): void;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| search | string | the search string to use. Use empty string to reset search. |

**Returns:**

void

#### Remarks

When you change the options for the attribute element loads, you should call initial elements page load.