Gå til indholdet

v1.0.3

da

På denne side

Oversigt
Eksempel
Parametre
Hændelser
Pakke
Relaterede kontroller

DataGrid

Complete

Tabel med sortering (klik på en overskrift: stigende, faldende, fra), filtre pr. kolonne, sideinddeling, rækkemarkering og skabeloner.

Eksempel

Kontrollen DataGrid

Parametre

DataGrid

Parameter	Type	Beskrivelse
`Adaptive`	`bool`	Viser hver række som et kort på smalle skærme.
`AllowAdd`	`bool`	Viser en knap Add, der opretter et nyt element (se NewItemFactory).
`AllowCardView`	`bool`	Tilføjer en knap til værktøjslinjen, der skifter mellem tabellen og kortvisningen.
`AllowDelete`	`bool`	Viser kommandoen Delete i kommandokolonnen (beder om bekræftelse).
`AllowEdit`	`bool`	Viser kommandoen Edit i kommandokolonnen.
`AllowPaste`	`bool`	Batchtilstand: tilføjer en knap Paste, der udfylder redigerbare celler fra tabulatorsepareret tekst fra udklipsholderen.
`AllowView`	`bool`	Tilføjer en kommando View, der viser rækken skrivebeskyttet i en dialogboks.
`CardView`	`bool`	Viser hver række som et kort i stedet for en tabelrække. Brug med @bind-CardView.
`CellNavigation`	`bool`	Gør gitteret til et tastaturgitter: piletaster, Home, End, Page Up og Page Down flytter mellem celler; Enter, F2 eller Mellemrum aktiverer kontrollen i cellen.
`Class`	`string`	Ekstra CSS-klasser, der tilføjes til rodelementet.
`ColumnMenu`	`bool`	Tilføjer en menuknap til hver overskrift med kommandoer til sortering og skjul kolonne.
`Columns`	`RenderFragment`	Kolonnedefinitioner: DataGridColumn-elementer.
`DataProvider`	`Func<DataGridRequest, ValueTask<DataGridResult<TItem>>>`	Indlæser rækker fra din side: modtager start, antal, sortering, filtre, søgning, grupper og aggregater samt et annulleringstoken (annulleret, når en nyere anmodning starter, eller gitteret fjernes), og returnerer et DataGridResult.
`Dense`	`bool`	Bruger strammere cellepolstring.
`DetailTemplate`	`RenderFragment<TItem>`	Indhold, der vises under en række, når dens udvidelsesknap trykkes.
`EditMode`	`DataGridEditMode`	None, Row (indlejret), Dialog eller Batch (alle rækker på én gang).
`EmptyContent`	`RenderFragment`	Vises, når der ingen rækker er.
`ExportChoices`	`bool`	Gør Export til en menu: CSV eller JSON, aktuel visning, valgte rækker, alle rækker, skjulte kolonner.
`ExportFileName`	`string`	CSV-eksportens filnavn, uden filtypenavn.
`FilterOperators`	`bool`	Tilføjer en operatorliste (indeholder, begynder med, er lig med, større end, er tom...) over hvert filterfelt.
`FormatRules`	`IEnumerable<DataGridFormatRule>`	Regler, der farver celler eller rækker: felt, filteroperator, værdi, alvorlighed og Cell eller Row. Den første matchende regel vinder.
`FreezeFirstColumn`	`bool`	Holder den første kolonne synlig under sidelæns rulning.
`FrozenColumns`	`int`	Antal førende kolonner, der forbliver synlige, mens resten ruller sidelæns.
`FrozenEndColumns`	`int`	Antal kolonner i højre kant, der forbliver synlige, mens tabellen ruller sidelæns.
`FrozenRows`	`int`	Antal rækker, der bliver under overskriften, mens brødteksten ruller (kræver Height).
`GroupBy`	`Func<TItem, Object>`	Grupperer rækker efter den returnerede værdi; hver gruppe har en sammenklappelig overskrift.
`GroupPanel`	`bool`	Tilføjer en strimmel over tabellen, hvor brugere grupperer rækker ved at trække overskrifter eller vælge kolonner.
`GroupSummary`	`bool`	Viser kolonneaggregaterne i grupperækkerne (beregnet lokalt eller hentet fra DataGridResult.Groups med en DataProvider).
`GroupTitle`	`string`	Tekst før gruppeværdien i overskriften.
`Height`	`string`	Maksimal højde på gitterets brødtekst, for eksempel 24rem (standard 28rem med VirtualScroll).
`ItemKey`	`Func<TItem, Object>`	Returnerer en stabil nøgle pr. element, så markering og åbne detaljer overlever genindlæsning.
`Items`	`IEnumerable<TItem>`	De valgmuligheder, der kan vælges mellem.
`KeyboardShortcuts`	`bool`	Ctrl+A markér alle, Ctrl+C kopiér valgte rækker, Esc ryd markering, Alt+piletaster skift side.
`Label`	`string`	Synlig etikettekst (diagrammer: tilgængeligt navn; IconButton: tilgængeligt navn og værktøjstip).
`Loading`	`bool`	Viser en fremdriftsbjælke over rækkerne.
`LoadingSkeleton`	`bool`	Viser pladsholderrækker under den første indlæsning.
`LoadMore`	`bool`	Erstatter sideskifteren med en knap Load more, der tilføjer næste side.
`MultiSort`	`bool`	Shift+klik på overskrifter sorterer efter flere kolonner; overskrifterne viser rækkefølgen.
`NewItemFactory`	`Func<TItem>`	Opretter elementet til en ny række; som standard konstruktøren uden parametre.
`NoMatchContent`	`RenderFragment`	Indhold, der vises, når filtre eller søgning ikke levner nogen rækker (som standard: en tekst med Clear filters).
`PageSize`	`int`	Rækker pr. side.
`PageSizeOptions`	`IEnumerable<int>`	Rækkeantal, der tilbydes i en rulleliste under tabellen.
`Paging`	`bool`	Viser sideinddelingslinjen (standard true).
`PastePreview`	`bool`	Batchtilstand: viser, hvad en indsættelse vil ændre, og spørger, før den anvendes (standard til).
`PersistKey`	`string`	Husker position og størrelse (Window), delingen (Splitter) eller layoutet af et DataGrid (sortering, filtre, kolonner, bredder, side) i det lokale lager under dette navn og gendanner dem næste gang.
`Reorderable`	`bool`	Lader brugere flytte kolonner ved at trække overskrifter eller med menuen Columns.
`Resizable`	`bool`	Tilføjer et trækhåndtag (og piletaster) til at ændre hver kolonnes bredde.
`RowClass`	`Func<TItem, string>`	Returnerer en ekstra CSS-klasse for en række.
`RowHeight`	`int`	Rækkehøjde i pixel, når VirtualScroll er slået til (standard 44).
`RowMenu`	`Func<TItem, IEnumerable<MenuCommand>>`	Returnerer kommandoerne i en rækkes genvejsmenu.
`RowReorder`	`bool`	Lader rækker trækkes over hinanden; håndtér RowMoved for at ændre listen.
`RowSeverity`	`Func<TItem, Severity?>`	Returnerer en alvorlighed til at farve en række, eller null.
`RowValidator`	`Func<TItem, IEnumerable<string>>`	Kontrollerer hele rækken, efter redigeringen er anvendt; returnerer fejltekster.
`SelectedItems`	`IEnumerable<TItem>`	Valgte rækker. Brug med @bind-SelectedItems.
`Selection`	`SelectionMode`	None (standard), Single eller Multiple.
`SelectionActions`	`RenderFragment<IReadOnlyList<TItem>>`	Knapper i markeringslinjen; modtager de valgte elementer.
`ServerBulkLimit`	`int`	Med DataProvider: det største antal rækker, gitteret beder om i én anmodning for at markere alle filtrerede rækker eller eksportere dem (standard 10000). Over det bruges kun rækkerne på siden.
`ShowCopy`	`bool`	Viser kopiknappen.
`ShowFilters`	`bool`	Viser et filterfelt under hver filtrérbar kolonneoverskrift.
`ShowPrint`	`bool`	Tilføjer en knap Print, der udskriver tabellen.
`ShowSearch`	`bool`	Tilføjer et søgefelt, der finder tekst i alle kolonner og markerer den i cellerne.
`ShowSelectionBar`	`bool`	Viser bjælken med antal valgte, markér alle rækker og ryd markering (markering Multiple).
`ShowToolbar`	`bool`	Viser værktøjslinjen med kolonnevælgeren og CSV-eksporten.
`Striped`	`bool`	Skraverer hver anden række.
`Style`	`string`	Indlejret typografi, der tilføjes til rodelementet.
`ToolbarContent`	`RenderFragment`	Ekstra indhold i værktøjslinjen på et gitter med ShowToolbar, for eksempel DataGridSpreadsheetButton.
`TypedFilters`	`bool`	Bruger filterfelter til tal, dato og ja/nej efter typen af kolonnens værdier (standard til).
`UndoRedo`	`bool`	Tilføjer Fortryd og Gentag for gemte rækkeændringer, tilføjede og slettede rækker (knapper og Ctrl+Z / Ctrl+Y).
`ValueFilters`	`bool`	Tilføjer et værdilistefilter (søg, markér alle, ryd) til hver filtrérbar overskrift; virker på elementer i hukommelsen.
`VirtualScroll`	`bool`	Tegner kun de synlige rækker (rækker skal have den faste RowHeight).

DataGridColumn

Parameter	Type	Beskrivelse
`Aggregate`	`DataGridAggregate`	Tilføjer en værdi til oversigtsrækken: Sum, Average, Min, Max eller Count.
`Align`	`TextAlign`	Left (standard), Center eller Right.
`BadgeSeverities`	`IReadOnlyDictionary<string, Severity>`	Farve for en Badge-kolonne pr. værdi.
`CellSeverity`	`Func<TItem, Severity?>`	Returnerer en alvorlighed til at farve en celle, eller null.
`ColumnSpan`	`Func<TItem, int>`	Returnerer, hvor mange kolonner et elements celle dækker.
`DataBar`	`bool`	Tegner en bjælke bag tallene i forhold til kolonnens største værdi.
`Editable`	`bool`	Lader brugere redigere kolonnens celler ved at klikke på dem.
`EditOn`	`DataGridEditOn`	Always, Create (kun nye rækker) eller Update (kun eksisterende rækker).
`EditorOptions`	`IEnumerable<KeyValuePair<string, string>>`	Værdi-etiket-par; editoren bliver en liste.
`Field`	`string`	Elementets egenskabsnavn (indlejrede navne som Address.City virker). Den læser cellen, sorterer og filtrerer, når Value ikke er angivet, og sendes til DataProvider som kolonneidentifikator (standard Title).
`Filterable`	`bool`	Viser et filterfelt for denne kolonne (standard true).
`Format`	`string`	Formatstreng til tal og datoer, f.eks. N0 eller d.
`Group`	`string`	Tekst i den stablede overskrift over denne kolonne; naboer med samme tekst deler én celle.
`HelpText`	`string`	Et tip, der vises under feltet i redigeringsdialogen.
`Hidden`	`bool`	Skjuler kolonnen i første omgang; brugere kan vise den fra værktøjslinjen.
`ImageAlt`	`Func<TItem, string>`	Alternativ tekst til en Image-kolonne pr. række.
`ImageHeight`	`int`	Billedets højde i pixel (standard 32).
`LinkHref`	`Func<TItem, string>`	Adresse for en Link-kolonne pr. række (som standard: værdien).
`LinkTarget`	`string`	Linkets mål, for eksempel _blank.
`Max`	`Double?`	Største tilladte værdi (ProgressBar: den værdi, der betyder 100 %; Rating: antal stjerner).
`MaxLength`	`int?`	Største tilladte antal tegn.
`MaxWidth`	`string`	Container: fast maksimal bredde fra et brudpunkt (Xs til Xxl). DataGridColumn: største bredde som CSS-længde; størrelseshåndtaget stopper ved den.
`MergeRows`	`bool`	Fletter lodret nabostillede celler med samme tekst.
`Min`	`Double?`	Mindste tilladte værdi.
`MinLength`	`int?`	Mindste antal tegn, der accepteres ved gemning af en redigering.
`Pattern`	`string`	Regulært udtryk, som den redigerede tekst skal matche.
`PatternMessage`	`string`	Fejltekst, der vises, når Pattern ikke passer.
`ProgressMax`	`Double`	Værdi, der fylder en Progress-kolonne (standard 100).
`Required`	`bool`	Editoren afviser en tom værdi.
`Sortable`	`bool`	Tillader sortering efter denne kolonne (standard true).
`Template`	`RenderFragment<TItem>`	Brugerdefineret celleindhold. Rækken er tilgængelig som kontekst.
`Title`	`string`	Titeltekst (skuffens overskrift, fanens billedtekst, kolonneoverskrift, trinnets billedtekst).
`Type`	`DataGridColumnType`	Hvordan cellen tegnes: Text, Check, Image, Progress, Link, Badge eller Dropdown.
`Validate`	`Func<TItem, Object, string>`	Trin i Stepper: kører, før der gås videre, returnér false for at blive på trinnet. Kolonne i DataGrid: modtager elementet og den fortolkede værdi og returnerer en fejltekst eller null.
`Value`	`Func<TItem, Object>`	Returnerer cellens værdi. Bruges til visning, sortering og filtrering.
`Width`	`string`	Skeleton: en vilkårlig CSS-længde. Charts: tegnebredde i SVG-enheder (diagrammet tilpasses stadig sin beholder).

Hændelser

DataGrid

Hændelse	Type	Beskrivelse
`CardViewChanged`	`EventCallback<bool>`	Udløses, når brugeren skifter mellem tabellen og kortene.
`OnLoadError`	`EventCallback<Exception>`	Udløses med undtagelsen, når DataProvider fejler; gitteret viser så ingen rækker. Uden en håndtering går fejlen til fejlgrænsen.
`OnRowDeleting`	`EventCallback<DataGridRowChange<TItem>>`	Kører efter bekræftelsen; angiv Error på argumentet for at annullere sletningen.
`OnRowSaving`	`EventCallback<DataGridRowChange<TItem>>`	Kører, før en række bevares; angiv Error på argumentet for at annullere og vise teksten.
`PageSizeChanged`	`EventCallback<int>`	Udløses, når en anden sidestørrelse vælges.
`RowAdded`	`EventCallback<TItem>`	Udløses med det nye element, efter det er gemt; tilføj det til listen.
`RowDeleted`	`EventCallback<TItem>`	Udløses med elementet, efter sletningen er bekræftet; fjern det fra listen.
`RowMoved`	`EventCallback<DataGridRowMove<TItem>>`	Udløses, når en række slippes på en anden række: elementet, sideindekserne (FromIndex, ToIndex), indekserne i hele den sorterede og filtrerede liste (AbsoluteFromIndex, AbsoluteToIndex; PageOffset er forskellen) og elementet, der blev sluppet på (TargetItem).
`RowSaved`	`EventCallback<TItem>`	Udløses med elementet, efter en gyldig redigering er anvendt på det.
`RowsPasted`	`EventCallback<int>`	Udløses med antallet af rækker udfyldt af Paste.
`SelectedItemsChanged`	`EventCallback<IEnumerable<TItem>>`	Udløses, når markeringen ændres.
`StateChanged`	`EventCallback<DataGridState>`	Rapporterer DataGridState efter hver ændring af sortering, filtre, kolonner, bredder eller side.

DataGridColumn

Hændelse	Type	Beskrivelse
`Edited`	`EventCallback<DataGridEdit<TItem>>`	Udløses med elementet og den nye tekst, når en redigering bekræftes.

Pakke

DataGrid er en del af RayCraft Complete. Pakke: RayCraft.Blazor.Complete. Den hentes fra RayCrafts private feed og kræver en aktiv licens. Se Kom i gang.

DataGridPdfButtonEn knap, der eksporterer det tilsluttede DataGrid til en PDF-fil.

Send feedbackVersion 1.0.3