Към съдържанието

v1.0.3

bg

На тази страница

Начало
Пример
Параметри
Събития
Пакет
Свързани контроли

DataGrid

Complete

Таблица със сортиране (щракване върху заглавие: възходящо, низходящо, изключено), филтри по колони, страниране, избор на редове и шаблони.

Пример

Контрола DataGrid

Параметри

DataGrid

Параметър	Тип	Описание
`Adaptive`	`bool`	Показва всеки ред като карта на тесни екрани.
`AllowAdd`	`bool`	Показва бутон Add, който създава нов елемент (вижте NewItemFactory).
`AllowCardView`	`bool`	Добавя бутон в лентата, който превключва между таблицата и изгледа с карти.
`AllowDelete`	`bool`	Показва командата Delete в колоната с команди (пита за потвърждение).
`AllowEdit`	`bool`	Показва командата Edit в колоната с команди.
`AllowPaste`	`bool`	Пакетен режим: добавя бутон Paste, който попълва редактируемите клетки от текст от клипборда, разделен с табулации.
`AllowView`	`bool`	Добавя команда View, която показва реда само за четене в диалог.
`CardView`	`bool`	Показва всеки ред като карта вместо ред на таблица. Ползвайте с @bind-CardView.
`CellNavigation`	`bool`	Прави решетката клавиатурна решетка: стрелките, Home, End, Page Up и Page Down се движат между клетките; Enter, F2 или Space активират контролата в клетката.
`Class`	`string`	Допълнителни CSS класове, добавени към коренния елемент.
`ColumnMenu`	`bool`	Добавя бутон-меню към всяко заглавие с команди за сортиране и скриване на колона.
`Columns`	`RenderFragment`	Дефиниции на колони: елементи DataGridColumn.
`DataProvider`	`Func<DataGridRequest, ValueTask<DataGridResult<TItem>>>`	Зарежда редове от вашата страна: получава началото, броя, сортирането, филтрите, търсенето, групите и агрегатите и токен за отказ (отказва се, когато започне по-нова заявка или решетката бъде премахната), връща DataGridResult.
`Dense`	`bool`	Ползва по-тесен вътрешен отстъп на клетките.
`DetailTemplate`	`RenderFragment<TItem>`	Съдържание, показвано под реда, когато се натисне бутонът му за разгъване.
`EditMode`	`DataGridEditMode`	None, Row (в реда), Dialog или Batch (всички редове наведнъж).
`EmptyContent`	`RenderFragment`	Показва се, когато няма редове.
`ExportChoices`	`bool`	Превръща Export в меню: CSV или JSON, текущ изглед, избрани редове, всички редове, скрити колони.
`ExportFileName`	`string`	Име на файла за CSV експорта, без разширението.
`FilterOperators`	`bool`	Добавя списък с оператори (съдържа, започва с, е равно на, по-голямо от, е празно...) над всяко поле на филтъра.
`FormatRules`	`IEnumerable<DataGridFormatRule>`	Правила, които оцветяват клетки или редове: поле, оператор на филтъра, стойност, важност и Cell или Row. Първото съвпадащо правило печели.
`FreezeFirstColumn`	`bool`	Държи първата колона видима при превъртане настрани.
`FrozenColumns`	`int`	Брой водещи колони, които остават видими, докато останалите се превъртат настрани.
`FrozenEndColumns`	`int`	Брой колони в десния край, които остават видими, докато таблицата се превърта настрани.
`FrozenRows`	`int`	Брой редове, които остават под заглавието, докато тялото се превърта (нужен е Height).
`GroupBy`	`Func<TItem, Object>`	Групира редовете по върнатата стойност; всяка група има сгъваем заглавен ред.
`GroupPanel`	`bool`	Добавя лента над таблицата, където потребителите групират редове чрез влачене на заглавия или избор на колони.
`GroupSummary`	`bool`	Показва агрегатите на колоните в редовете на групите (изчисляват се локално или се вземат от DataGridResult.Groups с DataProvider).
`GroupTitle`	`string`	Текст пред стойността на групата в заглавието.
`Height`	`string`	Най-голяма височина на тялото на решетката, например 24rem (по подразбиране 28rem с VirtualScroll).
`ItemKey`	`Func<TItem, Object>`	Връща стабилен ключ за всеки елемент, така че изборът и отворените подробности да оцелеят при презареждане.
`Items`	`IEnumerable<TItem>`	Опциите за избор.
`KeyboardShortcuts`	`bool`	Ctrl+A избира всички, Ctrl+C копира избраните редове, Esc изчиства избора, Alt+стрелки сменят страницата.
`Label`	`string`	Видим текст на етикета (графики: достъпно име; IconButton: достъпно име и подсказка).
`Loading`	`bool`	Показва лента за напредък над редовете.
`LoadingSkeleton`	`bool`	Показва запълващи редове при първото зареждане.
`LoadMore`	`bool`	Замества страницирането с бутон Load more, който добавя следващата страница.
`MultiSort`	`bool`	Shift+щракване върху заглавията сортира по няколко колони; заглавията показват реда.
`NewItemFactory`	`Func<TItem>`	Създава елемента за нов ред; по подразбиране е конструкторът без параметри.
`NoMatchContent`	`RenderFragment`	Съдържание, показвано, когато филтрите или търсенето не оставят редове (по подразбиране: текст с Clear filters).
`PageSize`	`int`	Редове на страница.
`PageSizeOptions`	`IEnumerable<int>`	Брой редове, предлагани в падащ списък под таблицата.
`Paging`	`bool`	Показва лентата за страниране (по подразбиране true).
`PastePreview`	`bool`	Пакетен режим: показва какво ще промени поставянето и пита преди да го приложи (по подразбиране включено).
`PersistKey`	`string`	Запомня позицията и размера (Window), разделянето (Splitter) или оформлението на DataGrid (сортиране, филтри, колони, ширини, страница) в локалното хранилище под това име и ги възстановява следващия път.
`Reorderable`	`bool`	Позволява на потребителите да местят колони с влачене на заглавията или от менюто Columns.
`Resizable`	`bool`	Добавя дръжка за влачене (и стрелки) за промяна на ширината на всяка колона.
`RowClass`	`Func<TItem, string>`	Връща допълнителен CSS клас за ред.
`RowHeight`	`int`	Височина на ред в пиксели, когато VirtualScroll е включено (по подразбиране 44).
`RowMenu`	`Func<TItem, IEnumerable<MenuCommand>>`	Връща командите на контекстното меню на ред.
`RowReorder`	`bool`	Позволява редове да се влачат един върху друг; обработете RowMoved, за да промените списъка си.
`RowSeverity`	`Func<TItem, Severity?>`	Връща важност, за да оцвети ред, или null.
`RowValidator`	`Func<TItem, IEnumerable<string>>`	Проверява целия ред след прилагане на редакцията; връща текстове на грешки.
`SelectedItems`	`IEnumerable<TItem>`	Избрани редове. Ползвайте с @bind-SelectedItems.
`Selection`	`SelectionMode`	None (по подразбиране), Single или Multiple.
`SelectionActions`	`RenderFragment<IReadOnlyList<TItem>>`	Бутони в лентата за избор; получава избраните елементи.
`ServerBulkLimit`	`int`	С DataProvider: най-големият брой редове, които решетката иска с една заявка, за да избере всички филтрирани редове или да ги експортира (по подразбиране 10000). Над него се ползват само редовете на страницата.
`ShowCopy`	`bool`	Показва бутона за копиране.
`ShowFilters`	`bool`	Показва поле за филтър под заглавието на всяка филтруема колона.
`ShowPrint`	`bool`	Добавя бутон Print, който отпечатва таблицата.
`ShowSearch`	`bool`	Добавя поле за търсене, което намира текст във всички колони и го маркира в клетките.
`ShowSelectionBar`	`bool`	Показва лентата с брой избрани, избор на всички редове и изчистване на избора (избор Multiple).
`ShowToolbar`	`bool`	Показва лентата с избирача на колони и CSV експорта.
`Striped`	`bool`	Засенчва всеки втори ред.
`Style`	`string`	Вграден стил, добавен към коренния елемент.
`ToolbarContent`	`RenderFragment`	Допълнително съдържание в лентата на решетка с ShowToolbar, например DataGridSpreadsheetButton.
`TypedFilters`	`bool`	Ползва полета за филтър за число, дата и да/не според типа на стойностите на колоната (по подразбиране включено).
`UndoRedo`	`bool`	Добавя Undo и Redo за записани редакции на редове, добавени и изтрити редове (бутони и Ctrl+Z / Ctrl+Y).
`ValueFilters`	`bool`	Добавя филтър по списък със стойности (търсене, избери всички, изчисти) към всяко филтруемо заглавие; работи с елементи в паметта.
`VirtualScroll`	`bool`	Рисува само видимите редове (редовете трябва да имат фиксиран RowHeight).

DataGridColumn

Параметър	Тип	Описание
`Aggregate`	`DataGridAggregate`	Добавя стойност в обобщаващия ред: Sum, Average, Min, Max или Count.
`Align`	`TextAlign`	Left (по подразбиране), Center или Right.
`BadgeSeverities`	`IReadOnlyDictionary<string, Severity>`	Цвят на колона Badge за всяка стойност.
`CellSeverity`	`Func<TItem, Severity?>`	Връща важност, за да оцвети клетка, или null.
`ColumnSpan`	`Func<TItem, int>`	Връща колко колони покрива клетката на елемент.
`DataBar`	`bool`	Рисува лента зад числата спрямо най-голямата стойност на колоната.
`Editable`	`bool`	Позволява на потребителите да редактират клетките на колоната с щракване.
`EditOn`	`DataGridEditOn`	Always, Create (само нови редове) или Update (само съществуващи редове).
`EditorOptions`	`IEnumerable<KeyValuePair<string, string>>`	Двойки стойност и етикет; редакторът става списък.
`Field`	`string`	Име на свойство на елемента (работят и вложени имена като Address.City). Чете клетката, сортира и филтрира, когато Value не е зададено, и се изпраща на DataProvider като идентификатор на колоната (по подразбиране Title).
`Filterable`	`bool`	Показва поле за филтър за тази колона (по подразбиране true).
`Format`	`string`	Форматиращ низ за числа и дати, напр. N0 или d.
`Group`	`string`	Текст на подредено заглавие над тази колона; съседите с еднакъв текст споделят една клетка.
`HelpText`	`string`	Подсказка, показана под полето в диалога за редакция.
`Hidden`	`bool`	Първоначално скрива колоната; потребителите могат да я покажат от лентата.
`ImageAlt`	`Func<TItem, string>`	Алтернативен текст на колона Image за всеки ред.
`ImageHeight`	`int`	Височина на картината в пиксели (по подразбиране 32).
`LinkHref`	`Func<TItem, string>`	Адрес на колона Link за всеки ред (по подразбиране: стойността).
`LinkTarget`	`string`	Цел на връзката, например _blank.
`Max`	`Double?`	Най-голяма допустима стойност (ProgressBar: стойността, която означава 100%; Rating: брой звезди).
`MaxLength`	`int?`	Най-голям допустим брой знаци.
`MaxWidth`	`string`	Container: фиксирана максимална ширина от точка на прекъсване (от Xs до Xxl). DataGridColumn: най-голяма ширина като CSS дължина; дръжката за оразмеряване спира при нея.
`MergeRows`	`bool`	Обединява вертикално съседни клетки с еднакъв текст.
`Min`	`Double?`	Най-малка допустима стойност.
`MinLength`	`int?`	Най-малък брой знаци, приемани при запис на редакция.
`Pattern`	`string`	Регулярен израз, на който редактираният текст трябва да съответства.
`PatternMessage`	`string`	Текст на грешка, показван, когато Pattern не съвпада.
`ProgressMax`	`Double`	Стойност, която запълва колона Progress (по подразбиране 100).
`Required`	`bool`	Редакторът отказва празна стойност.
`Sortable`	`bool`	Позволява сортиране по тази колона (по подразбиране true).
`Template`	`RenderFragment<TItem>`	Собствено съдържание на клетката. Редът е наличен като контекст.
`Title`	`string`	Текст на заглавие (заглавие на чекмедже, надпис на раздел, заглавие на колона, надпис на стъпка).
`Type`	`DataGridColumnType`	Как се рисува клетката: Text, Check, Image, Progress, Link, Badge или Dropdown.
`Validate`	`Func<TItem, Object, string>`	Стъпка на Stepper: изпълнява се преди преминаване нататък, върнете false, за да останете на стъпката. Колона на DataGrid: получава елемента и разчетената стойност и връща текст на грешка или null.
`Value`	`Func<TItem, Object>`	Връща стойността на клетката. Ползва се за показване, сортиране и филтриране.
`Width`	`string`	Skeleton: всяка CSS дължина. Charts: ширина на рисунката в единици SVG (графиката пак се мащабира спрямо контейнера си).

Събития

DataGrid

Събитие	Тип	Описание
`CardViewChanged`	`EventCallback<bool>`	Вдига се, когато потребителят превключи между таблицата и картите.
`OnLoadError`	`EventCallback<Exception>`	Вдига се с изключението, когато DataProvider се провали; решетката тогава не показва редове. Без обработчик грешката отива към границата за грешки.
`OnRowDeleting`	`EventCallback<DataGridRowChange<TItem>>`	Изпълнява се след потвърждението; задайте Error на аргумента, за да откажете изтриването.
`OnRowSaving`	`EventCallback<DataGridRowChange<TItem>>`	Изпълнява се, преди ред да бъде запазен; задайте Error на аргумента, за да откажете и покажете текста.
`PageSizeChanged`	`EventCallback<int>`	Вдига се, когато се избере друг размер на страница.
`RowAdded`	`EventCallback<TItem>`	Вдига се с новия елемент, след като е записан; добавете го към списъка си.
`RowDeleted`	`EventCallback<TItem>`	Вдига се с елемента, след като изтриването е потвърдено; премахнете го от списъка си.
`RowMoved`	`EventCallback<DataGridRowMove<TItem>>`	Вдига се, когато ред се пусне върху друг ред: елементът, индексите на страницата (FromIndex, ToIndex), индексите в целия сортиран и филтриран списък (AbsoluteFromIndex, AbsoluteToIndex; PageOffset е разликата) и елементът, върху който е пуснат (TargetItem).
`RowSaved`	`EventCallback<TItem>`	Вдига се с елемента, след като валидна редакция е приложена към него.
`RowsPasted`	`EventCallback<int>`	Вдига се с броя редове, попълнени от Paste.
`SelectedItemsChanged`	`EventCallback<IEnumerable<TItem>>`	Вдига се, когато изборът се промени.
`StateChanged`	`EventCallback<DataGridState>`	Съобщава DataGridState след всяка промяна на сортирането, филтрите, колоните, ширините или страницата.

DataGridColumn

Събитие	Тип	Описание
`Edited`	`EventCallback<DataGridEdit<TItem>>`	Вдига се с елемента и новия текст, когато редакцията е потвърдена.

Пакет

DataGrid е част от RayCraft Complete. Пакет: RayCraft.Blazor.Complete. Тя се тегли от частния feed на RayCraft и изисква активен лиценз. Вижте Първи стъпки.

DataGridPdfButtonБутон, който експортира свързания DataGrid в PDF файл.

Изпратете обратна връзкаВерсия 1.0.3