Hotwire for Rails 快速入门指南
项目地址: https://gitcode.com/gh_mirrors/ho/hotwire-rails Hotwire 是一种现代的 Web 开发方法论，它通过结合 Turbo 和 Stimulus 让你可以利用现有的 HTML 来构建动态且响应式的网页应用。此教程将引导您了解如何在 Rails 项目中设置和使用 Hotwire，特别是基于 hotwired/hotwire-rails 这个开源项目。
1. 项目目录结构及介绍
当您通过官方推荐的方式安装 Hotwire 到您的 Rails 应用后，一些关键的目录和文件会被添加或修改：
-
app/assets/javascripts:
stimulus_controller.js: Stimulus 控制器的基础模板文件。
-
app/views/layouts:
application.html.erb: 主布局文件，这里通常会包含引入 Hotwire 必要的 JavaScript 文件的标签。
-
config/application.rb:
- 会包含对 Hotwire 的配置代码，如默认启用 Turbo 和必要的 gem 添加。
-
Gemfile:
- 将自动包含
hotwire-railsgem，使得 Rails 可以集成 Hotwire 的功能。
- 将自动包含
-
package.json (如果已由Webpacker管理):
- 确保包含了相应的前端依赖，虽然 Hotwire 倾向于减少这种依赖性。
2. 项目的启动文件介绍
application.html.erb
这是你的应用程序的主布局文件，对于 Hotwire 来说至关重要。在这个文件里，你需要确保包含以下两行来启用 Hotwire：
<!-- 引入 Turbo 链接转换 -->
<%= turbo_frame_tag "turbo-stream" %>
<!-- 或者，如果你的应用完全基于 Stimulus 和没有传统页面刷新 -->
<%= javascript_pack_tag 'app' %> <!-- 假定这是一个 Stimulus 控制器包 -->
以及在 <head> 部分加入以下脚本标签（这通常由安装过程自动生成）:
<script src="https://cdn.jsdelivr.net/npm/@hotwired/turbo@7.x.x/dist/turbo.min.js"></script>
stimulus_controller.js
尽管不是一个“启动”文件，但它是 Stimulus 控制器的入口点，在这里可以定义全局的行为或者被其他具体控制器继承。
3. 项目的配置文件介绍
config/application.rb
在这里，您可能会遇到这样的配置行，表明 Rails 已经知道如何集成 Hotwire：
config.load_defaults 6.0 # 对应的 Rails 版本可能不同
config.turbo.link_enabled = true
这意味着 Rails 已启用了 Turbo，并允许 Turbo 替换传统的页面加载方式，使用更快的 AJAX 请求和流式更新。
package.json (如果有Webpacker)
如果你的项目使用了 Webpacker，那这里可能不会直接看到关于 Hotwire 的配置。但重要的是要注意到，通过 yarn add 或 npm install 添加的任何前端库，包括 Hotwire 相关的包，将会在此文件中有记录。WebPack的配置文件（如 webpack.config.js 或相关环境配置），也可能包含处理 Hotwire 所需的编译规则。
以上就是使用 Hotwire for Rails 时涉及到的基本目录结构、启动文件和配置文件的简介。理解这些部分将帮助您更有效地进行开发和维护基于 Hotwire 的Rails应用程序。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
