examples

GUI 模块示例代码

本目录包含GUI模块的各种示例代码，按复杂度和功能分类组织。

📚 示例分类

🚀 基础示例 (basic/)

适合初学者的简单示例，展示基本功能的使用：

• 边框组件示例 - BorderFillComponent的各种用法
• 增强物品示例 - ItemBuilder的高级功能
• 头颅物品示例 - 各种头颅创建方式

🔧 高级示例 (advanced/)

展示复杂功能和高级技巧的示例：

• 事件处理示例 - 复杂事件处理模式
• 分页组件高级用法 - 无限滚动和数据提供器
• 自定义组件开发 - 创建自定义组件

🌟 实际项目 (real-world/)

真实插件中的GUI实现，展示最佳实践：

• TPA插件示例 - 完整的TPA插件GUI实现
• 商店插件示例 - 商店系统的GUI设计
• 管理面板示例 - 管理员工具的GUI界面

🎯 按功能查找示例

组件使用

• 单槽组件: 基础示例
• 边框组件: 边框组件示例
• 分页组件: TPA插件示例
• 滚动组件: 高级分页示例

事件处理

• 基础事件: 事件处理示例
• 事件冒泡: 事件处理示例
• 自定义事件: 事件处理示例

i18n集成

• 基础i18n: TPA插件示例
• 参数替换: 商店插件示例
• 多语言支持: 管理面板示例

数据处理

• 静态数据: 基础示例
• 动态数据: TPA插件示例
• API数据: 高级分页示例

🚀 快速开始

1. 选择合适的示例

• 新手: 从 基础示例 开始
• 有经验: 直接查看 高级示例
• 实际应用: 参考 实际项目

2. 复制和修改

所有示例都可以直接复制到你的项目中，然后根据需要进行修改。

3. 理解原理

每个示例都包含详细的注释和说明，帮助你理解实现原理。

📋 示例代码约定

代码风格

• 使用Kotlin语言
• 遵循项目编码规范
• 包含详细注释
• 提供完整的使用示例

文档格式

• 包含功能描述
• 提供完整代码
• 解释关键概念
• 给出使用建议

依赖说明

• 明确前置条件
• 列出必需依赖
• 说明配置要求

💡 贡献示例

如果你有好的示例代码，欢迎贡献：

1. 确保代码质量和可读性
2. 添加详细的文档说明
3. 遵循现有的目录结构
4. 包含完整的测试用例

🔗 相关链接

• 快速入门 - 开始使用GUI模块
• 教程指南 - 系统学习GUI开发
• API文档 - 查阅详细API
• 最佳实践 - 编码规范和建议

📝 示例索引

按难度排序

1. 入门级: 边框组件, 物品创建
2. 进阶级: 事件处理, 分页组件
3. 专家级: TPA插件, 商店系统

按功能排序

• 界面布局: 边框组件, TPA插件
• 数据展示: 分页组件, 商店系统
• 用户交互: 事件处理, 管理面板

---

选择一个示例开始你的GUI开发之旅吧！ 🎉