用途:面向使用 FineUI 的开发者,帮助在正确部署栈与开发模式下配置和扩展 Grid(表格)组件,涵盖列定义、行选择、数据加载、编辑、排序、过滤、合计、分组、树表格、布局与高级功能,并说明各栈属性名与数据绑定差异。
主要能力:按目标栈给出写法——F.js 用 F.create({...}) 纯前端配置;Pro(WebForms)用 <f:Grid runat="server"> 服务端控件;Core-MVC 用 Fluent API Html.F().Grid()...;Core-RazorForms 与 Core-RazorPages 共用 TagHelper <f:Grid>;FineUI.Java 用 Thymeleaf 方言 <f:grid>(标签与属性全 kebab-case)。覆盖列类型与格式化、自定义渲染、固定列、分页工具栏、内存/数据库分页、单元格编辑、复选框多选与单选、排序、合计行、表头过滤、行分组、树表格、列锁定、拖拽排序、单元格合并与大数据表格等,并提供按需求拆分的 13 个参考文件与概念到各写法属性名的对照。
使用方式:先判定目标模式(.aspx 为 Pro;Controllers/Views 且用 Html.F() 为 Core-MVC;Pages/*.cshtml 用 <f:Grid> 且无 .designer.cs 为 RazorPages,有则为 RazorForms;纯前端 .html 为 F.js;带 xmlns:f="http://fineui.com/java" 与页面类 .java 为 Java),再确认数据来源、是否需要编辑与选择,然后按对应写法定制。Pro 数据绑定在 !IsPostBack 内 DataSource/DataBind;Core-MVC 由 Controller 设 ViewBag、View 内 .DataSource;RazorForms 后台 Page_Load 绑定、标签不写 DataSource;RazorPages 标签内联 DataSource;Java 页面类 Page_Load 用 setDataSource/dataBind。
适用场景:需要在多栈下统一实现表格展示、分页、选择、编辑、排序过滤与树形层级等业务的 .NET 或 Spring Boot 项目。
限制:一个页面只用一种模式写法,不混用 Fluent API 与 TagHelper、不跨栈套用属性名;文本默认 HTML 编码,需可信 HTML 时按栈使用 RawHtml / raw-html 机制;行选择统一使用稳定行 ID(DataIDField 等),SelectedRowIndex 系列已废弃;合并与拖拽为客户端方法,无服务端属性;不确定属性应查官方 API,不编造;官方资料未提供收费、价格与效果相关说明。