Hoppa till innehållet

v1.0.3

sv

På den här sidan

Översikt
Exempel
Parametrar
Händelser
Paket
Relaterade kontroller

DataGrid

Complete

Tabell med sortering (klicka på en rubrik: stigande, fallande, av), filter per kolumn, sidindelning, radmarkering och mallar.

Exempel

Kontrollen DataGrid

Parametrar

DataGrid

Parameter	Typ	Beskrivning
`Adaptive`	`bool`	Visar varje rad som ett kort på smala skärmar.
`AllowAdd`	`bool`	Visar en knapp Add som skapar ett nytt objekt (se NewItemFactory).
`AllowCardView`	`bool`	Lägger till en knapp i verktygsfältet som växlar mellan tabellen och kortvyn.
`AllowDelete`	`bool`	Visar kommandot Delete i kommandokolumnen (frågar efter bekräftelse).
`AllowEdit`	`bool`	Visar kommandot Edit i kommandokolumnen.
`AllowPaste`	`bool`	Batchläge: lägger till en knapp Paste som fyller redigerbara celler från tabbseparerad text i urklipp.
`AllowView`	`bool`	Lägger till ett kommando View som visar raden skrivskyddad i en dialogruta.
`CardView`	`bool`	Visar varje rad som ett kort i stället för en tabellrad. Använd med @bind-CardView.
`CellNavigation`	`bool`	Gör rutnätet till ett tangentbordsrutnät: piltangenter, Home, End, Page Up och Page Down flyttar mellan celler; Enter, F2 eller Mellanslag aktiverar kontrollen i cellen.
`Class`	`string`	Extra CSS-klasser som läggs till på rotelementet.
`ColumnMenu`	`bool`	Lägger till en menyknapp på varje rubrik med kommandon för sortering och dölj kolumn.
`Columns`	`RenderFragment`	Kolumndefinitioner: DataGridColumn-element.
`DataProvider`	`Func<DataGridRequest, ValueTask<DataGridResult<TItem>>>`	Läser in rader från din sida: får start, antal, sortering, filter, sökning, grupper och aggregat samt en avbrottstoken (avbryts när en nyare begäran startar eller rutnätet tas bort) och returnerar ett DataGridResult.
`Dense`	`bool`	Använder tätare cellutfyllnad.
`DetailTemplate`	`RenderFragment<TItem>`	Innehåll som visas under en rad när dess expandera-knapp trycks.
`EditMode`	`DataGridEditMode`	None, Row (inbäddad), Dialog eller Batch (alla rader på en gång).
`EmptyContent`	`RenderFragment`	Visas när det inte finns några rader.
`ExportChoices`	`bool`	Gör Export till en meny: CSV eller JSON, aktuell vy, markerade rader, alla rader, dolda kolumner.
`ExportFileName`	`string`	Filnamn för CSV-exporten, utan filnamnstillägg.
`FilterOperators`	`bool`	Lägger till en operatorlista (innehåller, börjar med, är lika med, större än, är tom...) ovanför varje filterruta.
`FormatRules`	`IEnumerable<DataGridFormatRule>`	Regler som färgar celler eller rader: fält, filteroperator, värde, allvarlighetsgrad och Cell eller Row. Den första matchande regeln gäller.
`FreezeFirstColumn`	`bool`	Håller den första kolumnen synlig vid rullning i sidled.
`FrozenColumns`	`int`	Antal inledande kolumner som stannar i vy medan resten rullar i sidled.
`FrozenEndColumns`	`int`	Antal kolumner i högerkanten som stannar i vy medan tabellen rullar i sidled.
`FrozenRows`	`int`	Antal rader som stannar under rubriken medan brödtexten rullar (kräver Height).
`GroupBy`	`Func<TItem, Object>`	Grupperar rader efter det returnerade värdet; varje grupp har en hopfällbar rubrik.
`GroupPanel`	`bool`	Lägger till en remsa ovanför tabellen där användare grupperar rader genom att dra rubriker eller välja kolumner.
`GroupSummary`	`bool`	Visar kolumnaggregaten i grupprader (beräknas lokalt eller hämtas från DataGridResult.Groups med en DataProvider).
`GroupTitle`	`string`	Text före gruppvärdet i rubriken.
`Height`	`string`	Största höjd för rutnätets brödtext, till exempel 24rem (standard 28rem med VirtualScroll).
`ItemKey`	`Func<TItem, Object>`	Returnerar en stabil nyckel per objekt, så att markering och öppna detaljer överlever omladdning.
`Items`	`IEnumerable<TItem>`	Alternativen att välja bland.
`KeyboardShortcuts`	`bool`	Ctrl+A markera alla, Ctrl+C kopiera markerade rader, Esc rensa markering, Alt+piltangenter byt sida.
`Label`	`string`	Synlig etikettext (diagram: tillgängligt namn; IconButton: tillgängligt namn och verktygstips).
`Loading`	`bool`	Visar ett förloppsfält ovanför raderna.
`LoadingSkeleton`	`bool`	Visar platshållarrader under den första inläsningen.
`LoadMore`	`bool`	Ersätter sidväljaren med en knapp Load more som lägger till nästa sida.
`MultiSort`	`bool`	Shift+klick på rubriker sorterar efter flera kolumner; rubrikerna visar ordningen.
`NewItemFactory`	`Func<TItem>`	Skapar objektet för en ny rad; som standard konstruktorn utan parametrar.
`NoMatchContent`	`RenderFragment`	Innehåll som visas när filter eller sökning inte lämnar några rader (som standard: en text med Clear filters).
`PageSize`	`int`	Rader per sida.
`PageSizeOptions`	`IEnumerable<int>`	Radantal som erbjuds i en listruta under tabellen.
`Paging`	`bool`	Visar sidindelningsfältet (standard true).
`PastePreview`	`bool`	Batchläge: visar vad en inklistring kommer att ändra och frågar innan den tillämpas (standard på).
`PersistKey`	`string`	Minns position och storlek (Window), delningen (Splitter) eller layouten för ett DataGrid (sortering, filter, kolumner, bredder, sida) i den lokala lagringen under det här namnet och återställer dem nästa gång.
`Reorderable`	`bool`	Låter användare flytta kolumner genom att dra rubriker eller med menyn Columns.
`Resizable`	`bool`	Lägger till ett draghandtag (och piltangenter) för att ändra bredden på varje kolumn.
`RowClass`	`Func<TItem, string>`	Returnerar en extra CSS-klass för en rad.
`RowHeight`	`int`	Radhöjd i pixlar när VirtualScroll är på (standard 44).
`RowMenu`	`Func<TItem, IEnumerable<MenuCommand>>`	Returnerar kommandona i en rads snabbmeny.
`RowReorder`	`bool`	Låter rader dras över varandra; hantera RowMoved för att ändra listan.
`RowSeverity`	`Func<TItem, Severity?>`	Returnerar en allvarlighetsgrad för att färga en rad, eller null.
`RowValidator`	`Func<TItem, IEnumerable<string>>`	Kontrollerar hela raden efter att redigeringen har tillämpats; returnerar feltexter.
`SelectedItems`	`IEnumerable<TItem>`	Valda rader. Använd med @bind-SelectedItems.
`Selection`	`SelectionMode`	None (standard), Single eller Multiple.
`SelectionActions`	`RenderFragment<IReadOnlyList<TItem>>`	Knappar i markeringsfältet; får de valda objekten.
`ServerBulkLimit`	`int`	Med DataProvider: det största antal rader som rutnätet ber om i en begäran för att markera alla filtrerade rader eller exportera dem (standard 10000). Över det används bara raderna på sidan.
`ShowCopy`	`bool`	Visar kopieringsknappen.
`ShowFilters`	`bool`	Visar en filterruta under varje filtrerbar kolumnrubrik.
`ShowPrint`	`bool`	Lägger till en knapp Print som skriver ut tabellen.
`ShowSearch`	`bool`	Lägger till en sökruta som hittar text i alla kolumner och markerar den i cellerna.
`ShowSelectionBar`	`bool`	Visar fältet med antal markerade, markera alla rader och rensa markering (markering Multiple).
`ShowToolbar`	`bool`	Visar verktygsfältet med kolumnväljaren och CSV-exporten.
`Striped`	`bool`	Skuggar varannan rad.
`Style`	`string`	Inbäddad stil som läggs till på rotelementet.
`ToolbarContent`	`RenderFragment`	Extra innehåll i verktygsfältet för ett rutnät med ShowToolbar, till exempel DataGridSpreadsheetButton.
`TypedFilters`	`bool`	Använder filterrutor för tal, datum och ja/nej efter typen på kolumnens värden (standard på).
`UndoRedo`	`bool`	Lägger till Ångra och Gör om för sparade radändringar, tillagda och borttagna rader (knappar och Ctrl+Z / Ctrl+Y).
`ValueFilters`	`bool`	Lägger till ett värdelistefilter (sök, markera alla, rensa) på varje filtrerbar rubrik; fungerar på objekt i minnet.
`VirtualScroll`	`bool`	Ritar bara de synliga raderna (raderna måste ha den fasta RowHeight).

DataGridColumn

Parameter	Typ	Beskrivning
`Aggregate`	`DataGridAggregate`	Lägger till ett värde i sammanfattningsraden: Sum, Average, Min, Max eller Count.
`Align`	`TextAlign`	Left (standard), Center eller Right.
`BadgeSeverities`	`IReadOnlyDictionary<string, Severity>`	Färg för en Badge-kolumn per värde.
`CellSeverity`	`Func<TItem, Severity?>`	Returnerar en allvarlighetsgrad för att färga en cell, eller null.
`ColumnSpan`	`Func<TItem, int>`	Returnerar hur många kolumner ett objekts cell täcker.
`DataBar`	`bool`	Ritar en stapel bakom talen i förhållande till kolumnens största värde.
`Editable`	`bool`	Låter användare redigera kolumnens celler genom att klicka på dem.
`EditOn`	`DataGridEditOn`	Always, Create (endast nya rader) eller Update (endast befintliga rader).
`EditorOptions`	`IEnumerable<KeyValuePair<string, string>>`	Värde-etikett-par; redigeraren blir en lista.
`Field`	`string`	Objektets egenskapsnamn (kapslade namn som Address.City fungerar). Den läser cellen, sorterar och filtrerar när Value inte är angivet och skickas till DataProvider som kolumnidentifierare (standard Title).
`Filterable`	`bool`	Visar en filterruta för den här kolumnen (standard true).
`Format`	`string`	Formatsträng för tal och datum, t.ex. N0 eller d.
`Group`	`string`	Text i den staplade rubriken ovanför den här kolumnen; grannar med samma text delar en cell.
`HelpText`	`string`	En ledtråd som visas under fältet i redigeringsdialogen.
`Hidden`	`bool`	Döljer kolumnen från början; användare kan visa den från verktygsfältet.
`ImageAlt`	`Func<TItem, string>`	Alternativ text för en Image-kolumn per rad.
`ImageHeight`	`int`	Bildens höjd i pixlar (standard 32).
`LinkHref`	`Func<TItem, string>`	Adress för en Link-kolumn per rad (som standard: värdet).
`LinkTarget`	`string`	Länkens mål, till exempel _blank.
`Max`	`Double?`	Största tillåtna värde (ProgressBar: det värde som betyder 100 %; Rating: antal stjärnor).
`MaxLength`	`int?`	Största tillåtna antal tecken.
`MaxWidth`	`string`	Container: fast maximal bredd från en brytpunkt (Xs till Xxl). DataGridColumn: största bredd som CSS-längd; storlekshandtaget stannar vid den.
`MergeRows`	`bool`	Slår ihop vertikalt angränsande celler med samma text.
`Min`	`Double?`	Minsta tillåtna värde.
`MinLength`	`int?`	Minsta antal tecken som accepteras när en redigering sparas.
`Pattern`	`string`	Reguljärt uttryck som den redigerade texten måste stämma med.
`PatternMessage`	`string`	Feltext som visas när Pattern inte stämmer.
`ProgressMax`	`Double`	Värde som fyller en Progress-kolumn (standard 100).
`Required`	`bool`	Redigeraren avvisar ett tomt värde.
`Sortable`	`bool`	Tillåter sortering efter den här kolumnen (standard true).
`Template`	`RenderFragment<TItem>`	Eget cellinnehåll. Raden är tillgänglig som kontext.
`Title`	`string`	Rubriktext (lådans rubrik, flikens bildtext, kolumnrubrik, stegets bildtext).
`Type`	`DataGridColumnType`	Hur cellen ritas: Text, Check, Image, Progress, Link, Badge eller Dropdown.
`Validate`	`Func<TItem, Object, string>`	Steg i Stepper: körs innan man går vidare, returnera false för att stanna på steget. Kolumn i DataGrid: får objektet och det tolkade värdet och returnerar en feltext eller null.
`Value`	`Func<TItem, Object>`	Returnerar cellens värde. Används för visning, sortering och filtrering.
`Width`	`string`	Skeleton: vilken CSS-längd som helst. Charts: ritbredd i SVG-enheter (diagrammet anpassas fortfarande efter sin behållare).

Händelser

DataGrid

Händelse	Typ	Beskrivning
`CardViewChanged`	`EventCallback<bool>`	Utlöses när användaren växlar mellan tabellen och korten.
`OnLoadError`	`EventCallback<Exception>`	Utlöses med undantaget när DataProvider misslyckas; rutnätet visar då inga rader. Utan en hanterare går felet till felgränsen.
`OnRowDeleting`	`EventCallback<DataGridRowChange<TItem>>`	Körs efter bekräftelsen; ange Error på argumentet för att avbryta borttagningen.
`OnRowSaving`	`EventCallback<DataGridRowChange<TItem>>`	Körs innan en rad behålls; ange Error på argumentet för att avbryta och visa texten.
`PageSizeChanged`	`EventCallback<int>`	Utlöses när en annan sidstorlek väljs.
`RowAdded`	`EventCallback<TItem>`	Utlöses med det nya objektet efter att det sparats; lägg till det i listan.
`RowDeleted`	`EventCallback<TItem>`	Utlöses med objektet efter att borttagningen bekräftats; ta bort det ur listan.
`RowMoved`	`EventCallback<DataGridRowMove<TItem>>`	Utlöses när en rad släpps på en annan rad: objektet, sidindexen (FromIndex, ToIndex), indexen i hela den sorterade och filtrerade listan (AbsoluteFromIndex, AbsoluteToIndex; PageOffset är skillnaden) och objektet som den släpptes på (TargetItem).
`RowSaved`	`EventCallback<TItem>`	Utlöses med objektet efter att en giltig redigering har tillämpats på det.
`RowsPasted`	`EventCallback<int>`	Utlöses med antalet rader som fyllts av Paste.
`SelectedItemsChanged`	`EventCallback<IEnumerable<TItem>>`	Utlöses när markeringen ändras.
`StateChanged`	`EventCallback<DataGridState>`	Rapporterar DataGridState efter varje ändring av sortering, filter, kolumner, bredder eller sida.

DataGridColumn

Händelse	Typ	Beskrivning
`Edited`	`EventCallback<DataGridEdit<TItem>>`	Utlöses med objektet och den nya texten när en redigering bekräftas.

Paket

DataGrid ingår i RayCraft Complete. Paket: RayCraft.Blazor.Complete. Den hämtas från RayCrafts privata flöde och kräver en aktiv licens. Se Kom igång.

DataGridPdfButtonEn knapp som exporterar det anslutna DataGrid till en PDF-fil.

Skicka synpunkterVersion 1.0.3