RayCraftDocs
v1.0.3
nl
raycraft.dev
Op deze pagina

DataGrid

Complete

Tabel met sortering (klik op een kop: oplopend, aflopend, uit), filters per kolom, paginering, rijselectie en sjablonen.

Voorbeeld

Besturingselement DataGrid

Parameters

DataGrid

ParameterTypeBeschrijving
AdaptiveboolToont elke rij als kaart op smalle schermen.
AllowAddboolToont een knop Add die een nieuw item maakt (zie NewItemFactory).
AllowCardViewboolVoegt aan de werkbalk een knop toe die wisselt tussen de tabel en de kaartweergave.
AllowDeleteboolToont de opdracht Delete in de opdrachtenkolom (vraagt om bevestiging).
AllowEditboolToont de opdracht Edit in de opdrachtenkolom.
AllowPasteboolBatchmodus: voegt een knop Paste toe die bewerkbare cellen vult met door tabs gescheiden tekst van het klembord.
AllowViewboolVoegt een opdracht View toe die de rij alleen-lezen in een dialoogvenster toont.
CardViewboolToont elke rij als kaart in plaats van als tabelrij. Gebruik met @bind-CardView.
CellNavigationboolMaakt van het raster een toetsenbordraster: pijltoetsen, Home, End, Page Up en Page Down verplaatsen tussen cellen; Enter, F2 of Spatie activeren het besturingselement in de cel.
ClassstringExtra CSS-klassen die aan het hoofdelement worden toegevoegd.
ColumnMenuboolVoegt aan elke kop een menuknop toe met opdrachten voor sorteren en kolom verbergen.
ColumnsRenderFragmentKolomdefinities: DataGridColumn-elementen.
DataProviderFunc<DataGridRequest, ValueTask<DataGridResult<TItem>>>Laadt rijen van uw kant: ontvangt de start, het aantal, de sortering, filters, zoekopdracht, groepen en aggregaten en een annuleringstoken (geannuleerd wanneer een nieuwere aanvraag begint of het raster wordt verwijderd) en geeft een DataGridResult terug.
DenseboolGebruikt krappere celopvulling.
DetailTemplateRenderFragment<TItem>Inhoud die onder een rij wordt getoond als op de uitvouwknop wordt gedrukt.
EditModeDataGridEditModeNone, Row (inline), Dialog of Batch (alle rijen tegelijk).
EmptyContentRenderFragmentGetoond als er geen rijen zijn.
ExportChoicesboolMaakt van Export een menu: CSV of JSON, huidige weergave, geselecteerde rijen, alle rijen, verborgen kolommen.
ExportFileNamestringBestandsnaam van de CSV-export, zonder extensie.
FilterOperatorsboolVoegt boven elk filtervak een lijst met operatoren toe (bevat, begint met, is gelijk aan, groter dan, is leeg...).
FormatRulesIEnumerable<DataGridFormatRule>Regels die cellen of rijen kleuren: veld, filteroperator, waarde, ernst en Cell of Row. De eerste overeenkomende regel wint.
FreezeFirstColumnboolHoudt de eerste kolom zichtbaar tijdens zijwaarts scrollen.
FrozenColumnsintAantal voorste kolommen dat in beeld blijft terwijl de rest zijwaarts scrolt.
FrozenEndColumnsintAantal kolommen aan de rechterrand dat in beeld blijft terwijl de tabel zijwaarts scrolt.
FrozenRowsintAantal rijen dat onder de kop blijft terwijl de body scrolt (vereist Height).
GroupByFunc<TItem, Object>Groepeert rijen op de teruggegeven waarde; elke groep heeft een inklapbare kop.
GroupPanelboolVoegt boven de tabel een strook toe waarin gebruikers rijen groeperen door koppen te slepen of kolommen te kiezen.
GroupSummaryboolToont de kolomaggregaten in de groepsrijen (lokaal berekend, of met een DataProvider overgenomen uit DataGridResult.Groups).
GroupTitlestringTekst vóór de groepswaarde in de kop.
HeightstringMaximale hoogte van de rasterbody, bijvoorbeeld 24rem (standaard 28rem met VirtualScroll).
ItemKeyFunc<TItem, Object>Geeft per item een stabiele sleutel terug, zodat selectie en geopende details herladen overleven.
ItemsIEnumerable<TItem>De opties waaruit kan worden gekozen.
KeyboardShortcutsboolCtrl+A alles selecteren, Ctrl+C geselecteerde rijen kopiëren, Esc selectie wissen, Alt+pijlen pagina wisselen.
LabelstringZichtbare labeltekst (grafieken: toegankelijke naam; IconButton: toegankelijke naam en knopinfo).
LoadingboolToont een voortgangsbalk boven de rijen.
LoadingSkeletonboolToont plaatshouderrijen tijdens de eerste lading.
LoadMoreboolVervangt de paginering door een knop Load more die de volgende pagina toevoegt.
MultiSortboolShift+klik op koppen sorteert op meerdere kolommen; de koppen tonen de volgorde.
NewItemFactoryFunc<TItem>Maakt het item voor een nieuwe rij; standaard de parameterloze constructor.
NoMatchContentRenderFragmentInhoud die wordt getoond als filters of zoeken geen rijen overlaten (standaard: een tekst met Clear filters).
PageSizeintRijen per pagina.
PageSizeOptionsIEnumerable<int>Rijaantallen die in een keuzelijst onder de tabel worden aangeboden.
PagingboolToont de pagineringsbalk (standaard true).
PastePreviewboolBatchmodus: toont wat een plakactie zal wijzigen en vraagt bevestiging voordat die wordt toegepast (standaard aan).
PersistKeystringOnthoudt de positie en grootte (Window), de splitsing (Splitter) of de indeling van een DataGrid (sortering, filters, kolommen, breedten, pagina) onder deze naam in de lokale opslag en herstelt ze de volgende keer.
ReorderableboolLaat gebruikers kolommen verplaatsen door koppen te slepen of met het menu Columns.
ResizableboolVoegt een sleephandvat (en pijltoetsen) toe om de breedte van elke kolom te wijzigen.
RowClassFunc<TItem, string>Geeft een extra CSS-klasse voor een rij terug.
RowHeightintRijhoogte in pixels als VirtualScroll aan staat (standaard 44).
RowMenuFunc<TItem, IEnumerable<MenuCommand>>Geeft de opdrachten van het contextmenu van een rij terug.
RowReorderboolLaat rijen op elkaar slepen; behandel RowMoved om uw lijst te wijzigen.
RowSeverityFunc<TItem, Severity?>Geeft een ernst terug om een rij te kleuren, of null.
RowValidatorFunc<TItem, IEnumerable<string>>Controleert de hele rij nadat de bewerking is toegepast; geeft fouttekst terug.
SelectedItemsIEnumerable<TItem>Geselecteerde rijen. Gebruik met @bind-SelectedItems.
SelectionSelectionModeNone (standaard), Single of Multiple.
SelectionActionsRenderFragment<IReadOnlyList<TItem>>Knoppen in de selectiebalk; ontvangt de geselecteerde items.
ServerBulkLimitintMet DataProvider: het grootste aantal rijen dat het raster in één aanvraag opvraagt om alle gefilterde rijen te selecteren of te exporteren (standaard 10000). Daarboven worden alleen de rijen van de pagina gebruikt.
ShowCopyboolToont de kopieerknop.
ShowFiltersboolToont een filtervak onder elke filterbare kolomkop.
ShowPrintboolVoegt een knop Print toe die de tabel afdrukt.
ShowSearchboolVoegt een zoekvak toe dat tekst in alle kolommen vindt en in de cellen markeert.
ShowSelectionBarboolToont de balk met het aantal geselecteerde rijen, alle rijen selecteren en selectie wissen (selectie Multiple).
ShowToolbarboolToont de werkbalk met de kolomkiezer en CSV-export.
StripedboolArceert elke tweede rij.
StylestringInline stijl die aan het hoofdelement wordt toegevoegd.
ToolbarContentRenderFragmentExtra inhoud in de werkbalk van een raster met ShowToolbar, bijvoorbeeld DataGridSpreadsheetButton.
TypedFiltersboolGebruikt filtervakken voor getal, datum en ja/nee naar het type van de kolomwaarden (standaard aan).
UndoRedoboolVoegt Ongedaan maken en Opnieuw toe voor opgeslagen rijwijzigingen, toegevoegde en verwijderde rijen (knoppen en Ctrl+Z / Ctrl+Y).
ValueFiltersboolVoegt aan elke filterbare kop een filter met waardelijst toe (zoeken, alles selecteren, wissen); werkt op items in het geheugen.
VirtualScrollboolTekent alleen de zichtbare rijen (rijen moeten de vaste RowHeight hebben).

DataGridColumn

ParameterTypeBeschrijving
AggregateDataGridAggregateVoegt een waarde aan de samenvattingsrij toe: Sum, Average, Min, Max of Count.
AlignTextAlignLeft (standaard), Center of Right.
BadgeSeveritiesIReadOnlyDictionary<string, Severity>Kleur van een Badge-kolom per waarde.
CellSeverityFunc<TItem, Severity?>Geeft een ernst terug om een cel te kleuren, of null.
ColumnSpanFunc<TItem, int>Geeft terug hoeveel kolommen de cel van een item beslaat.
DataBarboolTekent een balk achter getallen ten opzichte van de grootste waarde van de kolom.
EditableboolLaat gebruikers de cellen van de kolom bewerken door erop te klikken.
EditOnDataGridEditOnAlways, Create (alleen nieuwe rijen) of Update (alleen bestaande rijen).
EditorOptionsIEnumerable<KeyValuePair<string, string>>Waarde-labelparen; de editor wordt een lijst.
FieldstringEigenschapsnaam van het item (geneste namen zoals Address.City werken). Het leest de cel, sorteert en filtert als Value niet is ingesteld en wordt als kolomidentificatie naar DataProvider gestuurd (standaard Title).
FilterableboolToont een filtervak voor deze kolom (standaard true).
FormatstringOpmaaktekenreeks voor getallen en datums, bijv. N0 of d.
GroupstringTekst van de gestapelde kop boven deze kolom; buren met dezelfde tekst delen één cel.
HelpTextstringEen hint onder het veld in het bewerkingsdialoogvenster.
HiddenboolVerbergt de kolom eerst; gebruikers kunnen hem via de werkbalk tonen.
ImageAltFunc<TItem, string>Alternatieve tekst van een Image-kolom per rij.
ImageHeightintHoogte van de afbeelding in pixels (standaard 32).
LinkHrefFunc<TItem, string>Adres van een Link-kolom per rij (standaard: de waarde).
LinkTargetstringDoel van de koppeling, bijvoorbeeld _blank.
MaxDouble?Grootste toegestane waarde (ProgressBar: de waarde die 100% betekent; Rating: aantal sterren).
MaxLengthint?Grootste toegestane aantal tekens.
MaxWidthstringContainer: vaste maximale breedte vanaf een breekpunt (Xs tot Xxl). DataGridColumn: grootste breedte als CSS-lengte; het vergrotingshandvat stopt erbij.
MergeRowsboolVoegt verticaal aangrenzende cellen met dezelfde tekst samen.
MinDouble?Kleinste toegestane waarde.
MinLengthint?Kleinste aantal tekens dat bij het opslaan van een bewerking wordt geaccepteerd.
PatternstringReguliere expressie waaraan de bewerkte tekst moet voldoen.
PatternMessagestringFouttekst die wordt getoond als Pattern niet overeenkomt.
ProgressMaxDoubleWaarde die een Progress-kolom vult (standaard 100).
RequiredboolDe editor weigert een lege waarde.
SortableboolStaat sorteren op deze kolom toe (standaard true).
TemplateRenderFragment<TItem>Eigen celinhoud. De rij is beschikbaar als context.
TitlestringTiteltekst (kop van de lade, tabbladbijschrift, kolomkop, stapbijschrift).
TypeDataGridColumnTypeHoe de cel wordt getekend: Text, Check, Image, Progress, Link, Badge of Dropdown.
ValidateFunc<TItem, Object, string>Stap van Stepper: draait voordat wordt doorgegaan, geef false terug om op de stap te blijven. Kolom van DataGrid: ontvangt het item en de ingelezen waarde en geeft een fouttekst of null terug.
ValueFunc<TItem, Object>Geeft de celwaarde terug. Gebruikt voor weergave, sortering en filtering.
WidthstringSkeleton: elke CSS-lengte. Charts: tekenbreedte in SVG-eenheden (de grafiek schaalt nog steeds mee met zijn container).

Gebeurtenissen

DataGrid

GebeurtenisTypeBeschrijving
CardViewChangedEventCallback<bool>Geactiveerd wanneer de gebruiker wisselt tussen de tabel en de kaarten.
OnLoadErrorEventCallback<Exception>Geactiveerd met de uitzondering wanneer DataProvider mislukt; het raster toont dan geen rijen. Zonder handler gaat de fout naar de foutgrens.
OnRowDeletingEventCallback<DataGridRowChange<TItem>>Draait na de bevestiging; stel Error op het argument in om het verwijderen te annuleren.
OnRowSavingEventCallback<DataGridRowChange<TItem>>Draait voordat een rij wordt behouden; stel Error op het argument in om te annuleren en de tekst te tonen.
PageSizeChangedEventCallback<int>Geactiveerd wanneer een andere paginagrootte wordt gekozen.
RowAddedEventCallback<TItem>Geactiveerd met het nieuwe item nadat het is opgeslagen; voeg het toe aan uw lijst.
RowDeletedEventCallback<TItem>Geactiveerd met het item nadat het verwijderen is bevestigd; verwijder het uit uw lijst.
RowMovedEventCallback<DataGridRowMove<TItem>>Geactiveerd wanneer een rij op een andere rij wordt neergezet: het item, de pagina-indexen (FromIndex, ToIndex), de indexen in de hele gesorteerde en gefilterde lijst (AbsoluteFromIndex, AbsoluteToIndex; PageOffset is het verschil) en het item waarop is neergezet (TargetItem).
RowSavedEventCallback<TItem>Geactiveerd met het item nadat een geldige bewerking erop is toegepast.
RowsPastedEventCallback<int>Geactiveerd met het aantal rijen dat door Paste is gevuld.
SelectedItemsChangedEventCallback<IEnumerable<TItem>>Geactiveerd wanneer de selectie verandert.
StateChangedEventCallback<DataGridState>Meldt de DataGridState na elke wijziging van sortering, filters, kolommen, breedten of pagina.

DataGridColumn

GebeurtenisTypeBeschrijving
EditedEventCallback<DataGridEdit<TItem>>Geactiveerd met het item en de nieuwe tekst wanneer een bewerking wordt bevestigd.

Pakket

DataGrid maakt deel uit van RayCraft Complete. Pakket: RayCraft.Blazor.Complete. Het komt uit de privéfeed van RayCraft en vereist een actieve licentie. Zie Aan de slag.