RayCraftDocs
v1.0.3
nb
raycraft.dev
På denne siden

DataGrid

Complete

Tabell med sortering (klikk på en overskrift: stigende, synkende, av), filtre per kolonne, sideinndeling, radmarkering og maler.

Eksempel

Kontrollen DataGrid

Parametere

DataGrid

ParameterTypeBeskrivelse
AdaptiveboolViser hver rad som et kort på smale skjermer.
AllowAddboolViser en knapp Add som oppretter et nytt element (se NewItemFactory).
AllowCardViewboolLegger til en knapp på verktøylinjen som bytter mellom tabellen og kortvisningen.
AllowDeleteboolViser kommandoen Delete i kommandokolonnen (ber om bekreftelse).
AllowEditboolViser kommandoen Edit i kommandokolonnen.
AllowPasteboolBatchmodus: legger til en knapp Paste som fyller redigerbare celler fra tabulatorseparert tekst fra utklippstavlen.
AllowViewboolLegger til en kommando View som viser raden skrivebeskyttet i en dialogboks.
CardViewboolViser hver rad som et kort i stedet for en tabellrad. Bruk med @bind-CardView.
CellNavigationboolGjør rutenettet til et tastaturrutenett: piltaster, Home, End, Page Up og Page Down flytter mellom celler; Enter, F2 eller Mellomrom aktiverer kontrollen i cellen.
ClassstringEkstra CSS-klasser som legges til rotelementet.
ColumnMenuboolLegger til en menyknapp på hver overskrift med kommandoer for sortering og skjul kolonne.
ColumnsRenderFragmentKolonnedefinisjoner: DataGridColumn-elementer.
DataProviderFunc<DataGridRequest, ValueTask<DataGridResult<TItem>>>Laster rader fra din side: mottar start, antall, sortering, filtre, søk, grupper og aggregater samt et avbruddstoken (avbrutt når en nyere forespørsel starter eller rutenettet fjernes), og returnerer et DataGridResult.
DenseboolBruker strammere celleutfylling.
DetailTemplateRenderFragment<TItem>Innhold som vises under en rad når utvidelsesknappen trykkes.
EditModeDataGridEditModeNone, Row (innebygd), Dialog eller Batch (alle rader på én gang).
EmptyContentRenderFragmentVises når det ikke finnes noen rader.
ExportChoicesboolGjør Export til en meny: CSV eller JSON, gjeldende visning, valgte rader, alle rader, skjulte kolonner.
ExportFileNamestringFilnavn for CSV-eksporten, uten filendelse.
FilterOperatorsboolLegger til en operatorliste (inneholder, begynner med, er lik, større enn, er tom...) over hvert filterfelt.
FormatRulesIEnumerable<DataGridFormatRule>Regler som farger celler eller rader: felt, filteroperator, verdi, alvorlighetsgrad og Cell eller Row. Den første samsvarende regelen vinner.
FreezeFirstColumnboolHolder den første kolonnen synlig under sideveis rulling.
FrozenColumnsintAntall ledende kolonner som blir synlige mens resten ruller sideveis.
FrozenEndColumnsintAntall kolonner i høyre kant som blir synlige mens tabellen ruller sideveis.
FrozenRowsintAntall rader som blir under overskriften mens brødteksten ruller (krever Height).
GroupByFunc<TItem, Object>Grupperer rader etter den returnerte verdien; hver gruppe har en sammenleggbar overskrift.
GroupPanelboolLegger til en stripe over tabellen der brukere grupperer rader ved å dra overskrifter eller velge kolonner.
GroupSummaryboolViser kolonneaggregatene i grupperadene (beregnet lokalt eller hentet fra DataGridResult.Groups med en DataProvider).
GroupTitlestringTekst før gruppeverdien i overskriften.
HeightstringMaksimal høyde på rutenettets brødtekst, for eksempel 24rem (standard 28rem med VirtualScroll).
ItemKeyFunc<TItem, Object>Returnerer en stabil nøkkel per element, slik at markering og åpne detaljer overlever innlasting på nytt.
ItemsIEnumerable<TItem>Alternativene å velge mellom.
KeyboardShortcutsboolCtrl+A merk alle, Ctrl+C kopier valgte rader, Esc tøm markering, Alt+piltaster bytt side.
LabelstringSynlig etikettekst (diagrammer: tilgjengelig navn; IconButton: tilgjengelig navn og verktøytips).
LoadingboolViser en fremdriftslinje over radene.
LoadingSkeletonboolViser plassholderrader under den første lastingen.
LoadMoreboolErstatter sidevelgeren med en knapp Load more som legger til neste side.
MultiSortboolShift+klikk på overskrifter sorterer etter flere kolonner; overskriftene viser rekkefølgen.
NewItemFactoryFunc<TItem>Oppretter elementet for en ny rad; som standard konstruktøren uten parametere.
NoMatchContentRenderFragmentInnhold som vises når filtre eller søk ikke etterlater noen rader (som standard: en tekst med Clear filters).
PageSizeintRader per side.
PageSizeOptionsIEnumerable<int>Radantall som tilbys i en nedtrekksliste under tabellen.
PagingboolViser sideinndelingslinjen (standard true).
PastePreviewboolBatchmodus: viser hva en innliming vil endre og spør før den brukes (standard på).
PersistKeystringHusker posisjon og størrelse (Window), delingen (Splitter) eller oppsettet til et DataGrid (sortering, filtre, kolonner, bredder, side) i det lokale lageret under dette navnet og gjenoppretter dem neste gang.
ReorderableboolLar brukere flytte kolonner ved å dra overskrifter eller med menyen Columns.
ResizableboolLegger til et dragehåndtak (og piltaster) for å endre bredden på hver kolonne.
RowClassFunc<TItem, string>Returnerer en ekstra CSS-klasse for en rad.
RowHeightintRadhøyde i piksler når VirtualScroll er på (standard 44).
RowMenuFunc<TItem, IEnumerable<MenuCommand>>Returnerer kommandoene i en rads hurtigmeny.
RowReorderboolLar rader dras oppå hverandre; håndter RowMoved for å endre listen.
RowSeverityFunc<TItem, Severity?>Returnerer en alvorlighetsgrad for å farge en rad, eller null.
RowValidatorFunc<TItem, IEnumerable<string>>Kontrollerer hele raden etter at redigeringen er brukt; returnerer feiltekster.
SelectedItemsIEnumerable<TItem>Valgte rader. Bruk med @bind-SelectedItems.
SelectionSelectionModeNone (standard), Single eller Multiple.
SelectionActionsRenderFragment<IReadOnlyList<TItem>>Knapper i markeringslinjen; mottar de valgte elementene.
ServerBulkLimitintMed DataProvider: det største antall rader rutenettet ber om i én forespørsel for å merke alle filtrerte rader eller eksportere dem (standard 10000). Over det brukes bare radene på siden.
ShowCopyboolViser kopiknappen.
ShowFiltersboolViser et filterfelt under hver filtrerbare kolonneoverskrift.
ShowPrintboolLegger til en knapp Print som skriver ut tabellen.
ShowSearchboolLegger til et søkefelt som finner tekst i alle kolonner og markerer den i cellene.
ShowSelectionBarboolViser linjen med antall valgte, merk alle rader og tøm markering (markering Multiple).
ShowToolbarboolViser verktøylinjen med kolonnevelgeren og CSV-eksporten.
StripedboolSkraverer hver andre rad.
StylestringInnebygd stil som legges til rotelementet.
ToolbarContentRenderFragmentEkstra innhold i verktøylinjen til et rutenett med ShowToolbar, for eksempel DataGridSpreadsheetButton.
TypedFiltersboolBruker filterfelt for tall, dato og ja/nei etter typen på kolonnens verdier (standard på).
UndoRedoboolLegger til Angre og Gjør om for lagrede radendringer, tillagte og slettede rader (knapper og Ctrl+Z / Ctrl+Y).
ValueFiltersboolLegger til et verdilistefilter (søk, merk alle, tøm) på hver filtrerbare overskrift; fungerer på elementer i minnet.
VirtualScrollboolTegner bare de synlige radene (radene må ha den faste RowHeight).

DataGridColumn

ParameterTypeBeskrivelse
AggregateDataGridAggregateLegger til en verdi i sammendragsraden: Sum, Average, Min, Max eller Count.
AlignTextAlignLeft (standard), Center eller Right.
BadgeSeveritiesIReadOnlyDictionary<string, Severity>Farge for en Badge-kolonne per verdi.
CellSeverityFunc<TItem, Severity?>Returnerer en alvorlighetsgrad for å farge en celle, eller null.
ColumnSpanFunc<TItem, int>Returnerer hvor mange kolonner cellen til et element dekker.
DataBarboolTegner en søyle bak tallene i forhold til kolonnens største verdi.
EditableboolLar brukere redigere cellene i kolonnen ved å klikke på dem.
EditOnDataGridEditOnAlways, Create (bare nye rader) eller Update (bare eksisterende rader).
EditorOptionsIEnumerable<KeyValuePair<string, string>>Verdi-etikett-par; redigereren blir en liste.
FieldstringElementets egenskapsnavn (nestede navn som Address.City fungerer). Den leser cellen, sorterer og filtrerer når Value ikke er angitt, og sendes til DataProvider som kolonneidentifikator (standard Title).
FilterableboolViser et filterfelt for denne kolonnen (standard true).
FormatstringFormatstreng for tall og datoer, f.eks. N0 eller d.
GroupstringTekst i den stablede overskriften over denne kolonnen; naboer med samme tekst deler én celle.
HelpTextstringEt hint som vises under feltet i redigeringsdialogen.
HiddenboolSkjuler kolonnen først; brukere kan vise den fra verktøylinjen.
ImageAltFunc<TItem, string>Alternativ tekst for en Image-kolonne per rad.
ImageHeightintBildets høyde i piksler (standard 32).
LinkHrefFunc<TItem, string>Adresse for en Link-kolonne per rad (som standard: verdien).
LinkTargetstringLenkens mål, for eksempel _blank.
MaxDouble?Største tillatte verdi (ProgressBar: verdien som betyr 100 %; Rating: antall stjerner).
MaxLengthint?Største tillatte antall tegn.
MaxWidthstringContainer: fast maksimal bredde fra et bruddpunkt (Xs til Xxl). DataGridColumn: største bredde som CSS-lengde; størrelseshåndtaket stopper ved den.
MergeRowsboolSlår sammen loddrett tilstøtende celler med samme tekst.
MinDouble?Minste tillatte verdi.
MinLengthint?Minste antall tegn som godtas ved lagring av en redigering.
PatternstringRegulært uttrykk som den redigerte teksten må samsvare med.
PatternMessagestringFeiltekst som vises når Pattern ikke passer.
ProgressMaxDoubleVerdi som fyller en Progress-kolonne (standard 100).
RequiredboolRedigereren avviser en tom verdi.
SortableboolTillater sortering etter denne kolonnen (standard true).
TemplateRenderFragment<TItem>Eget celleinnhold. Raden er tilgjengelig som kontekst.
TitlestringTittel (skuffens overskrift, fanens bildetekst, kolonneoverskrift, trinnets bildetekst).
TypeDataGridColumnTypeHvordan cellen tegnes: Text, Check, Image, Progress, Link, Badge eller Dropdown.
ValidateFunc<TItem, Object, string>Trinn i Stepper: kjører før man går videre, returner false for å bli på trinnet. Kolonne i DataGrid: mottar elementet og den tolkede verdien og returnerer en feiltekst eller null.
ValueFunc<TItem, Object>Returnerer cellens verdi. Brukes til visning, sortering og filtrering.
WidthstringSkeleton: en hvilken som helst CSS-lengde. Charts: tegnebredde i SVG-enheter (diagrammet tilpasses fortsatt beholderen).

Hendelser

DataGrid

HendelseTypeBeskrivelse
CardViewChangedEventCallback<bool>Utløses når brukeren bytter mellom tabellen og kortene.
OnLoadErrorEventCallback<Exception>Utløses med unntaket når DataProvider mislykkes; rutenettet viser da ingen rader. Uten en behandler går feilen til feilgrensen.
OnRowDeletingEventCallback<DataGridRowChange<TItem>>Kjører etter bekreftelsen; angi Error på argumentet for å avbryte slettingen.
OnRowSavingEventCallback<DataGridRowChange<TItem>>Kjører før en rad beholdes; angi Error på argumentet for å avbryte og vise teksten.
PageSizeChangedEventCallback<int>Utløses når en annen sidestørrelse velges.
RowAddedEventCallback<TItem>Utløses med det nye elementet etter at det er lagret; legg det til i listen.
RowDeletedEventCallback<TItem>Utløses med elementet etter at slettingen er bekreftet; fjern det fra listen.
RowMovedEventCallback<DataGridRowMove<TItem>>Utløses når en rad slippes på en annen rad: elementet, sideindeksene (FromIndex, ToIndex), indeksene i hele den sorterte og filtrerte listen (AbsoluteFromIndex, AbsoluteToIndex; PageOffset er forskjellen) og elementet det ble sluppet på (TargetItem).
RowSavedEventCallback<TItem>Utløses med elementet etter at en gyldig redigering er brukt på det.
RowsPastedEventCallback<int>Utløses med antall rader fylt ut av Paste.
SelectedItemsChangedEventCallback<IEnumerable<TItem>>Utløses når markeringen endres.
StateChangedEventCallback<DataGridState>Rapporterer DataGridState etter hver endring av sortering, filtre, kolonner, bredder eller side.

DataGridColumn

HendelseTypeBeskrivelse
EditedEventCallback<DataGridEdit<TItem>>Utløses med elementet og den nye teksten når en redigering bekreftes.

Pakke

DataGrid er en del av RayCraft Complete. Pakke: RayCraft.Blazor.Complete. Den hentes fra RayCrafts private feed og krever en aktiv lisens. Se Kom i gang.