Taiga-UI 项目中的事件插件升级指南

在 Angular 生态系统中，随着框架的不断演进，一些 API 会经历重构和优化。Taiga-UI 作为 Angular 组件库，其文档中关于事件插件的配置方式也需要同步更新。

事件插件的演进

在早期版本的 Angular 中，开发者通过 NG_EVENT_PLUGINS 这个注入令牌来注册事件插件。这种方式虽然有效，但在 Angular 的持续优化过程中，开发团队引入了更符合现代 Angular 实践的函数式提供方式。

新旧配置对比

旧版配置方式：

providers: [
  NG_EVENT_PLUGINS
]

新版推荐方式：

providers: [
  provideEventPlugins()
]

为什么需要升级

1. 更好的类型安全：函数式提供方式能提供更完善的类型推断
2. 更清晰的意图表达：provideEventPlugins() 更直观地表达了其功能
3. 未来兼容性：旧版注入令牌已被标记为废弃，未来版本可能会移除

升级注意事项

1. 确保项目中使用的 Angular 版本支持函数式提供器
2. 检查是否有自定义事件插件需要特殊处理
3. 升级后应进行全面测试，特别是涉及自定义事件处理的部分

最佳实践

对于 Taiga-UI 项目的新用户，建议直接采用新的 provideEventPlugins() 方式。对于现有项目，可以在下次主要版本升级时同步更新这一配置。

这种变化体现了 Angular 生态向更现代化、更函数式编程风格的演进，虽然只是简单的 API 变更，但背后反映了框架设计理念的进步。