CodeSpirit-CrudDialogOperation 配置与使用指南
💡
原文中文，约7600字，阅读约需19分钟。
📝
内容提要
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 的主要功能是什么？
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 时需要注意哪些事项？
注意事项包括列名匹配、权限检查、模板变量提供和数据格式要求。
➡️
