ListView

Hiển thị list record với render tự do (card, kanban). Là base cho GridView.

Source: Core/Components/ListView.cs ComponentType trong DB: ListView. Khi GroupBy field set, Core tự pick GroupListView thay thế.

Cấu hình

ComType:           ListView
Reference:         Customer
DataSourceFilter:  ?$filter=Active eq true     # bắt buộc đủ "?$filter="
LocalRender:       true                         # render custom thay vì grid

Field DB dùng

Field	Vai trò
`Reference`	Type entity nguồn (vd `Customer`).
`RefName`	Tên entity dạng string.
`ReferenceId`	ID reference (cho join phức tạp).
`FieldName`	(Khi bind navigation collection của entity cha) — vd `"Lines"`.
`DataSourceFilter`	OData filter đủ `?$filter=...` load list.
`JoinTable`	Tên bảng join SQL custom.
`SqlSelect`	SQL custom thay cho OData (mạnh hơn).
`SqlSearch`	SQL search tùy biến (cho VirtualGrid).
`LocalData`	Inline data list — bypass API.
`LocalHeader`	Cấu hình cột local (thay vì GridPolicy).
`LocalRender`	True → render custom (card, kanban) thay vì grid mặc định.
`CanAdd`	True → hiển thị button thêm row mới.
`CanSearch`	True → hiển thị ô search.
`CanCache`	True → cache data trong session.
`IsRealtime`	True → push update qua WebSocket.
`LiteGrid`	True → render lightweight (ít feature, nhanh hơn).
`IgnoreSync`	True → không sync qua WS với grid khác.
`IgnoreConfirmHardDelete`	True → skip dialog confirm khi delete.
`HideHistory`	True → không track audit history.
`Label`	Tiêu đề grid (header).
`Focus`	True → auto focus grid khi render.
`BodyItemHeight`	Chiều cao mỗi row body (px).
`HeaderHeight`	Chiều cao header (px).
`FooterHeight`	Chiều cao footer (px).
`ScrollHeight`	Chiều cao container scroll.
`Row`	Số dòng hiển thị (rare cho list).
`DateTimeField`	Field datetime dùng cho range search.
`TopEmpty`	True → thêm row trống đầu list.
`FilterLocal`	True → filter ở client thay vì server.
`IdField`	Tên field ID (default `"Id"`).
`GroupReferenceId`	Reference ID cho group.
`Migration`	Script migration nội bộ.
`Precision`	Số chữ số thập phân (cho summary).
`Events`	JSON map event → method C#. Xem mục Events ở trên.
`Id`, `ComponentGroup`, `ComponentType`	Định danh / wiring nội bộ.

Events kích hoạt

Event	Method signature
`change`	`(rowData)` — row patched thành công.
`BeforeCreated`	`(rowData)`
`AfterCreated`	`(rowData)`
`BeforeCreatedList`	`(rows)` — bulk insert.
`AfterCreatedList`	`(rows)`
`BeforeDeleted`	`(deletedItems)`
`AfterDeleted`	`(deletedItems)`
`BeforePasted`	`(originRows, copiedRows)`
`AfterPasted`	`(originRows, copiedRows)`
`BeforeCopied`	`(originRows, copiedRows)`
`AfterCopied`	`(originRows, copiedRows)`
`Deactivated`	`(entity)`
`UpdateHeader`	`(columns)` — sau khi reload column.
`AfterWebsocket`	`(updatedData, listViewItem)`
`SaveAs`	`(this, editForm)`

Khi nào dùng

✅ Render custom (card, kanban, free layout) — set LocalRender = true. ❌ Cần grid cột chuẩn → dùng GridView.