CodeSpirit-CrudDialogOperation 配置与使用指南
内容提要
CrudDialogOperationAttribute 是 CodeSpirit.Amis 框架中的特性，旨在简化弹窗列表数据的显示。它支持自动生成 CRUD 对话框，提供类型安全和灵活配置，允许自定义列和行操作，从而提高开发效率。
关键要点
-
CrudDialogOperationAttribute 是 CodeSpirit.Amis 框架中的特性，用于简化弹窗列表数据的显示。
-
该特性支持自动生成 CRUD 对话框，简化开发流程，提供类型安全和灵活配置。
-
特性继承自 OperationAttribute，使用所有基础属性，如 Icon、DialogSize、VisibleOn 等。
-
核心属性包括 DataApi、DataType、EnablePagination、PerPage、EnableSearch、EnableExport、RowActions 和 CustomColumns。
-
使用示例展示了如何指定数据 API 和数据类型以生成 CRUD 对话框。
-
完整配置示例展示了如何使用所有配置选项，包括分页、搜索、导出和行操作按钮。
-
列生成机制根据 DataType 自动生成列配置，支持自定义列配置以满足特定需求。
-
GenerateCrudDialogSchema 方法简化了 schema 生成，支持模板变量替换。
-
数据 API 必须返回标准的 ApiResponse<PageList<T>> 格式，支持查询参数。
-
配置选项详解包括分页配置、工具栏配置和行操作配置。
-
最佳实践包括优先使用基类方法、分离 Schema 和数据接口、使用 DTO 类型和合理使用自定义列。
-
注意事项包括列名匹配、权限检查、模板变量提供和数据格式要求。
-
常见问题解答涉及列名不匹配、自定义列类型、添加行操作按钮和支持排序等问题。
延伸解读
特性优势与开发效率
CrudDialogOperationAttribute 通过自动生成 CRUD 对话框，显著提高了开发效率。开发者无需手动编写复杂的 AMIS schema，只需简单配置即可实现功能，降低了出错的可能性，适合快速迭代的项目需求。
配置灵活性与注意事项
该特性支持多种配置选项，如分页、搜索和自定义列，开发者可以根据具体需求灵活调整。然而，需注意列名匹配和权限检查，确保生成的列与 API 返回的数据一致，以避免运行时错误。
最佳实践与性能考虑
在使用 CrudDialogOperationAttribute 时，建议优先使用基类方法生成 schema，并将 schema 与数据接口分离。这不仅提高了代码的可维护性，还能有效提升性能，尤其是在处理大量数据时，启用分页功能是一个明智的选择。
延伸问答
CrudDialogOperationAttribute 的主要功能是什么？
CrudDialogOperationAttribute 是 CodeSpirit.Amis 框架中的特性，旨在简化弹窗列表数据的显示，支持自动生成 CRUD 对话框。
如何使用 CrudDialogOperationAttribute 生成 CRUD 对话框？
只需指定数据 API 和数据类型，通过 CrudDialogOperationAttribute 特性即可自动生成 CRUD 对话框。
CrudDialogOperationAttribute 支持哪些核心配置选项？
核心配置选项包括 DataApi、DataType、EnablePagination、PerPage、EnableSearch、EnableExport、RowActions 和 CustomColumns。
如何自定义 CRUD 对话框中的列？
可以使用 CustomColumns 属性提供自定义列配置，或者在 DTO 属性上使用 AmisColumnAttribute 特性。
CrudDialogOperationAttribute 的列生成机制是怎样的？
列生成机制根据 DataType 自动生成列配置，优先使用 CustomColumns，其次检查 AmisColumnAttribute 特性，最后基于属性类型自动生成列名。
使用 CrudDialogOperationAttribute 时需要注意哪些事项？
注意事项包括列名匹配、权限检查、模板变量提供和数据格式要求。
