docs/docs/reference/admin-ui-api/list-detail-views/base-list-component.mdx
This is a base class which implements the logic required to fetch and manipulate a list of data from a query which returns a PaginatedList type.
It is normally used in combination with the DataTable2Component.
class BaseListComponent<ResultType, ItemType, VariableType extends Record<string, any> = any> implements OnInit, OnDestroy {
searchTermControl = new FormControl('');
selectionManager = new SelectionManager<any>({
multiSelect: true,
itemsAreEqual: (a, b) => a.id === b.id,
additiveMode: true,
});
result$: Observable<ResultType>;
items$: Observable<ItemType[]>;
totalItems$: Observable<number>;
itemsPerPage$: Observable<number>;
currentPage$: Observable<number>;
protected destroy$ = new Subject<void>();
protected refresh$ = new BehaviorSubject<undefined>(undefined);
protected visibleCustomFieldColumnChange$ = new Subject<
Array<DataTableCustomFieldColumnComponent<any>>
>();
constructor(router: Router, route: ActivatedRoute)
setQueryFn(listQueryFn: ListQueryFn<ResultType>, mappingFn: MappingFn<ItemType, ResultType>, onPageChangeFn?: OnPageChangeFn<VariableType>, defaults?: { take: number; skip: number }) => ;
refreshListOnChanges(streams: Array<Observable<any>>) => ;
setPageNumber(page: number) => ;
setItemsPerPage(perPage: number) => ;
setVisibleColumns(columns: Array<DataTable2ColumnComponent<any>>) => ;
refresh() => ;
setQueryParam(hash: { [key: string]: any }, options?: { replaceUrl?: boolean; queryParamsHandling?: QueryParamsHandling }) => ;
setQueryParam(key: string, value: any, options?: { replaceUrl?: boolean; queryParamsHandling?: QueryParamsHandling }) => ;
setQueryParam(keyOrHash: string | { [key: string]: any }, valueOrOptions?: any, maybeOptions?: { replaceUrl?: boolean; queryParamsHandling?: QueryParamsHandling }) => ;
}
<MemberInfo kind="property" type={``} />
<MemberInfo kind="property" type={``} />
<MemberInfo kind="property" type={Observable<ResultType>} />
<MemberInfo kind="property" type={Observable<ItemType[]>} />
<MemberInfo kind="property" type={Observable<number>} />
<MemberInfo kind="property" type={Observable<number>} />
<MemberInfo kind="property" type={Observable<number>} />
<MemberInfo kind="property" type={``} />
<MemberInfo kind="property" type={``} />
<MemberInfo kind="property" type={``} />
<MemberInfo kind="method" type={(listQueryFn: ListQueryFn<ResultType>, mappingFn: MappingFn<ItemType, ResultType>, onPageChangeFn?: OnPageChangeFn<VariableType>, defaults?: { take: number; skip: number }) => } />
Sets the fetch function for the list being implemented.
<MemberInfo kind="method" type={(streams: Array<Observable<any>>) => } />
Accepts a list of Observables which will trigger a refresh of the list when any of them emit.
<MemberInfo kind="method" type={(page: number) => } />
Sets the current page number in the url.
<MemberInfo kind="method" type={(perPage: number) => } />
Sets the number of items per page in the url.
<MemberInfo kind="method" type={(columns: Array<DataTable2ColumnComponent<any>>) => } />
<MemberInfo kind="method" type={() => } />
Re-fetch the current page of results.
<MemberInfo kind="method" type={(hash: { [key: string]: any }, options?: { replaceUrl?: boolean; queryParamsHandling?: QueryParamsHandling }) => } />
<MemberInfo kind="method" type={(key: string, value: any, options?: { replaceUrl?: boolean; queryParamsHandling?: QueryParamsHandling }) => } />
<MemberInfo kind="method" type={(keyOrHash: string | { [key: string]: any }, valueOrOptions?: any, maybeOptions?: { replaceUrl?: boolean; queryParamsHandling?: QueryParamsHandling }) => } />