Shigo da shi

import-grid.tsx
import { NuiGrid, type NuiGridColumn, type NuiGridHandle } from '@needless-ui/react/grid';

NuiGrid

Data grid a kan tebur na asali.

NuiGrid: Kadarori
SunaIriNa asaliBayani
rowsPropreadonly T[]Bayanan. Gyara yana maye gurbin layinsa kuma yana kiran onRowsChange; rows na gaba da kuka bayar suna maye gurbin gyare-gyaren.
onRowsChangeCallback(rows: readonly T[]) => voidAna kiransa da layukan bayan kowane gyaran da aka tabbatar.
columnsPropNuiGridColumn<T>[]Ginshiƙan, a matsayin objects na NuiGridColumn.
rowIdProp(row: T) => unknownrow.id ?? rowKey na layi, don zaɓi da bibiya.
labelPropstringSunan da ake sanarwa na grid ɗin.
selectionProp'none' | 'single' | 'multiple''none'Ko ana iya zaɓar layuka, da guda nawa.
selected
defaultSelected
onSelectedChangeYanayi
unknown[][]Keys na layukan da aka zaɓa.
sort
defaultSort
onSortChangeYanayi
NuiGridSort[][]Jerawar, a matsayin objects na { column, direction }; na farko ne ke da fifiko.
filters
defaultFilters
onFiltersChangeYanayi
Record<string, NuiGridFilter>{}Tacewa ɗaya ga kowane id na ginshiƙi: operator da ƙima.
search
defaultSearch
onSearchChangeYanayi
string''Kalmomin da dole ne duka su kasance a cikin layi.
pageSize
defaultPageSize
onPageSizeChangeYanayi
number0Layuka a kowane shafi, ko 0 don jeri ɗaya mai gungurawa.
page
defaultPage
onPageChangeYanayi
number0Shafin da ake nunawa, daga 0.
pageSizesPropnumber[][10, 25, 50, 100]Zaɓuɓɓukan da ke cikin pager.
virtualPropboolean | 'auto''auto'Yana nuna layukan da ake gani kawai: koyaushe, ba ko kaɗan, ko auto idan layuka sun wuce 100 ba tare da shafuka ba.
heightPropstringTsawon CSS da ke iyakance grid ɗin; yana gungurawa a ciki.
columnState
defaultColumnState
onColumnStateChangeYanayi
NuiGridColumnState[][]Faɗi, matsayi, kafewa da bayyanar kowane ginshiƙi, don adanawa da maidowa.
modeProp'client' | 'server''client'server yana nuna layuka yadda suke zuwa, kuma yana bar muku jerawa, tacewa da raba shafuka.
totalPropnumberYawan layuka a server.
loadingPropbooleanfalseYana nuna sandar ci gaba, da layukan riƙe wuri idan babu layuka.
localePropstring'en-US'Yana tsara lambobi da kwanan wata, kuma yana karanta lambobin da aka rubuta.
labelsPropPartial<NuiGridLabels>Kowane rubutu da grid ɗin ke nunawa ko sanarwa, don fassarawa.
cornersPropNuiCornersSiffar kusurwoyinsa: round, squircle, bevel, scoop, notch ko square.
radiusPropNuiRadiusGirman kusurwoyinsa: none, small, medium, large ko full.
densityPropNuiDensityYawan sararin da yake ɗauka: compact, regular ko roomy.
groupByPropstring[][]Ginshiƙan da ake rukunta layuka bisa su, na waje da farko.
collapsed
defaultCollapsed
onCollapsedChangeYanayi
string[][]Keys na rukunonin da ke rufe; rukunoni suna farawa a buɗe.
getChildrenProp(row: T) => T[] | undefinedLayukan da ke ƙarƙashin wani layi: grid ɗin yana nuna bayanai masu tsarin bishiya.
expanded
defaultExpanded
onExpandedChangeYanayi
unknown[][]Keys na layukan da ke buɗe a bayanai masu tsarin bishiya; suna farawa a rufe.
details
defaultDetails
onDetailsChangeYanayi
unknown[][]Keys na layukan da cikakken bayaninsu ke buɗe.
totals, flashPropbooleanfalseLayin aggregates a kan dukan layukan da aka tace; cells masu walƙiya idan rubutunsu ya canza, a layukan da ke da rowId mai ɗorewa.
layoutProp'table' | 'list' | 'auto''table'list yana nuna layuka a matsayin katuna, auto kuma yana yin haka a ƙananan allo.
toolbarPropboolean | 'auto''auto'Sanda da ke jera layuka, tana tace su, kuma tana zaɓar dukansu: koyaushe, ba ko kaɗan, ko auto tare da katuna.
renderEmptyRender prop(filtered: boolean) => ReactNodeAbin da ake nunawa idan babu layuka; ana gaya masa ko tacewa ce ta ɓoye su.
renderDetailRender prop(row: T) => ReactNodeCikakken bayanin layi, ana nuna shi a ƙarƙashinsa idan an buɗe. Grid ɗin yana ƙara ginshiƙin toggles.
onRowActivateCallback(row: T) => voidAna kiransa da layin da aka buɗe da Enter ko danna sau biyu.
onCellEditCallback(edit: NuiGridEdit<T>) => voidAna kiransa da kowane gyaran da aka tabbatar.
onQueryChangeCallback(query: NuiGridQuery) => voidAna kiransa da jerawa, tacewa, bincike da shafi duk lokacin da suka canza, da kuma sau ɗaya a farko.
refPropRef<NuiGridHandle>Abin da ref na grid ɗin ke kaiwa: fitarwa, bugawa da focus.
exportXlsx, printMethod(options?) => Blob, () => voidLayukan da aka tace aka jera a matsayin spreadsheet; yana buga kowane layi.
exportCsvMethod(options?) => stringLayukan da aka tace aka jera na ginshiƙan da ake gani, a matsayin CSV.
expandAllMethod(open?: boolean) => voidYana buɗe kowane rukuni da kowane layi mai layuka a ƙarƙashinsa, ko ya rufe su duka.
focusCellMethod(row: number, col: number) => voidYana kai focus kan cell; layi -1 shi ne layin take.
clearFiltersMethod() => voidYana share kowace tacewa da binciken.
fitMethod(id: string) => voidYana daidaita faɗin ginshiƙi da cell ɗinsa mafi faɗi daga cikin waɗanda aka nuna.

Yanayi yana aiki kamar inputs na React da kansu: ku ba da ƙima, ku sabunta ta daga callback ɗinta na on…Change, ko ku ba da ƙimar default…, ku bar component ɗin ya riƙe ta.

Props na keɓancewa da ba ku saita ba suna bin attribute na data-nui-* mafi kusa. Ku duba jagorar keɓancewa.

NuiGridColumn

Ginshiƙi ɗaya. Yana karɓar dukan kadarorin ginshiƙin Angular (id da header kaɗai ake buƙata), da kuma waɗannan biyun da ke zana shi.

NuiGridColumn: Kadarori
SunaIriNa asaliBayani
renderCellRender prop({ row, value, text, column }) => ReactNodeKu zana cells na ginshiƙin da kanku, daga layin, ƙimarsa da rubutunsa.
renderHeaderRender prop(column) => ReactNodeKu zana taken ginshiƙin da kanku; header ne har yanzu ke ba shi suna.