Bullet Train项目v1.21.0版本发布：移除rails-ujs的重大变更解析

Bullet Train是一个基于Ruby on Rails的全栈开发框架，它为开发者提供了构建现代化Web应用所需的各种工具和组件。该框架特别注重开发效率和最佳实践，整合了Turbo、Stimulus等现代前端技术栈。

版本核心变更：移除rails-ujs

v1.21.0版本最重要的变更是移除了对rails-ujs的依赖，转而全面采用Turbo来处理前端交互。这一变更可能会影响现有应用中使用了特定特性的部分，特别是涉及以下两种场景：

1. 使用了双因素认证的应用：如果不进行相应调整，登录流程将会中断
2. 使用了特定数据属性的链接和按钮：包括method和confirm等特性

迁移指南

link_to标签的更新

在旧版本中，开发者通常会这样使用link_to标签：

<%= link_to "删除项目", project_path(@project), method: :delete, data: { confirm: "确定删除吗？" } %>

在新版本中，需要调整为Turbo兼容的格式：

<%= link_to "删除项目", project_path(@project), data: { turbo_method: :delete, turbo_confirm: "确定删除吗？" } %>

主要变更点：

• method参数改为turbo_method并移至data哈希中
• confirm参数改为turbo_confirm

button_to标签的更新

对于button_to标签，主要需要调整confirm参数的命名：

旧版本写法：

<%= button_to "注销账户", user_path(@user), method: :delete, data: { confirm: "确定要注销吗？" } %>

新版本写法：

<%= button_to "注销账户", user_path(@user), method: :delete, data: { turbo_confirm: "确定要注销吗？" } %>

注意：button_to的method参数保持不变，只需修改confirm为turbo_confirm。

兼容性处理

如果暂时无法完成迁移，开发者可以选择回退到使用rails-ujs：

1. 添加rails-ujs包：

yarn add @rails/ujs

2. 在application.js中添加：

import Rails from "@rails/ujs"
Rails.start()

其他改进

除了主要的rails-ujs变更外，本次版本还包含：

1. 解决了Stimulus清单文件在生成新控制器时被覆盖的问题
2. 常规的依赖项更新，包括Ruby和JavaScript依赖

升级建议

对于正在使用Bullet Train框架的开发者，建议：

1. 首先检查应用中是否使用了受影响的功能
2. 使用提供的grep命令查找需要修改的地方
3. 考虑直接升级到v1.21.1版本，该版本修复了双因素认证的问题
4. 全面测试应用中的交互功能，特别是涉及数据修改的操作

这一变更虽然需要一定的迁移工作，但将使应用更加符合现代Rails开发的最佳实践，为未来的功能扩展打下更好的基础。