Skip to main content

useSharePointDataTable

@spartanfx/react v1.2.2


@spartanfx/react / spfx / useSharePointDataTable

Function: useSharePointDataTable()

function useSharePointDataTable<T>(config): UseSharePointDataTableReturn<T>;

SharePoint adapter hook for DataTable component Provides all necessary props and handlers to connect DataTable with SharePoint lists

Type Parameters

T

T = any

Configuration

Required

PropertyTypeDescription
contextWebPartContextSPFx WebPart context
listNamestringSharePoint list name
spSPFIPnPjs SPFI instance

Options

PropertyTypeDescription
camlQuery?stringOptional CAML query for filtering
columns?IDataTableColumn<any>[]Optional columns configuration
groupByLevel1?stringField name for level-1 grouping
groupByLevel2?stringField name for level-2 grouping
groupByLevel3?stringField name for level-3 grouping
groupsDefaultCollapsed?booleanWhether groups start collapsed
inPlaceSearchText?stringOptional search text
rowLimit?numberRow limit per request
translatedFields?string[]Fields that require translation of filter values

Events & callbacks

PropertyTypeDescription
inPlaceFilterItems?(item) => booleanClient-side filter function
translate?(text) => stringTranslation function

Appearance & theming

PropertyTypeDescription
appearance?AppearanceModeAppearance mode for theming (light or dark)

Full type reference: IUseSharePointDataTableConfig

Returns

UseSharePointDataTableReturn<T>

DataTable props object ready to be spread into DataTable component

Example

const dataTableProps = useSharePointDataTable({
listName: 'Projects',
sp: sp,
context: context,
columns: columns
});

return <DataTable {...dataTableProps} />;