在 Ruby on Rails 应用中优雅地嵌入 PDF 文件-html教程-PHP中文网

在 Ruby on Rails 应用中优雅地嵌入 PDF 文件

碧海醫心

发布： 2025-09-30 16:01:01

原创

189人浏览过

在 Ruby on Rails 应用中优雅地嵌入 PDF 文件

本文将详细介绍如何在 Ruby on Rails 应用程序中将 PDF 文件嵌入到 HTML 视图中。主要方法包括利用 HTML 的 <embed> 标签，结合 Rails 的 asset_path 辅助方法处理资产管道，以及在特定情况下直接硬编码文件路径并配置静态文件服务。通过这些方法，开发者可以灵活地在网页中展示 PDF 内容，而非仅仅提供下载。

1. 理解嵌入 PDF 与发送 PDF 的区别

在 rails 开发中，将 pdf 文件呈现在浏览器中有两种主要方式：一种是作为文件下载或直接在浏览器中打开（通过 send_file 等方法），另一种是将其嵌入到现有的 html 页面中，作为页面内容的一部分。本文主要关注后者，即如何在 html 视图中无缝地嵌入 pdf。

2. 使用 HTML <embed> 标签嵌入 PDF

最直接且推荐的方法是利用标准的 HTML <embed> 标签。这个标签允许在 HTML 文档中嵌入外部内容，包括 PDF 文件。

2.1 基本语法

<embed src="http://example.com/the.pdf" width="500" height="375" type="application/pdf">

登录后复制

在 Rails 应用中，PDF 文件的路径管理是关键。根据文件存放位置和是否使用资产管道，有不同的处理方式。

3. 结合 Rails 资产管道与 asset_path 辅助方法

如果您的 PDF 文件存放在 Rails 资产管道（Asset Pipeline）管理的目录中（例如 app/assets/files/），那么使用 asset_path 辅助方法是最佳实践。

3.1 asset_path 的优势

Rails 的资产管道在生产环境中会对静态文件进行预编译，这通常包括文件名哈希处理（例如 menulq2.pdf 可能变为 menulq2-60aa4fdc5cea14baf5400fba1abf4f2a46a5166bad4772b1effe341570f07de9.pdf）。直接硬编码文件名将导致链接失效。asset_path 辅助方法会自动处理这些变化，确保链接始终指向正确的文件，而开发者只需提供原始文件名。

3.2 示例代码

假设您的 PDF 文件位于 app/assets/files/menulq2.pdf：

<!-- app/views/your_controller/your_action.html.erb -->
<div class="pdf-container">
  <embed src="<%= asset_path('menulq2.pdf') %>" 
         width="100%" 
         height="600px" 
         type="application/pdf">
</div>

登录后复制

注意事项：

width 和 height 可以根据您的布局需求进行调整，例如使用百分比实现响应式布局。
确保您的 PDF 文件确实被资产管道识别和处理。通常，放在 app/assets/ 下的文件会自动被处理。

4. 直接硬编码文件路径与静态文件服务

在某些特定场景下，如果您的 PDF 文件不通过资产管道处理，或者您希望直接从公共目录提供文件，可以直接硬编码文件路径。但这需要额外的服务器配置。

AppMall应用商店

AI应用商店，提供即时交付、按需付费的人工智能应用服务

查看详情

4.1 适用场景

PDF 文件存放在 public 目录下（例如 public/files/menulq2.pdf）。
您确定该文件不会经过资产管道的预编译处理。

4.2 配置要求

为了让 Rails 服务器能够直接提供 public 目录下的静态文件，您需要在对应的环境配置文件（例如 config/environments/development.rb 或 config/environments/production.rb）中启用静态文件服务。

对于 Rails 4.x 版本：
```
config.serve_static_files = true
```
登录后复制
对于 Rails 5.x 及更高版本：
```
config.public_file_server.enabled = true
```
登录后复制

4.3 示例代码

假设您的 PDF 文件位于 public/files/menulq2.pdf：

<!-- app/views/your_controller/your_action.html.erb -->
<div class="pdf-container">
  <embed src="/files/menulq2.pdf" 
         width="100%" 
         height="600px" 
         type="application/pdf">
</div>

登录后复制

注意事项：

硬编码路径时，请确保路径是相对于您的应用根目录的正确 URL。
在生产环境中，通常由 Nginx 或 Apache 等 Web 服务器直接提供静态文件，而不是由 Rails 应用本身提供，以提高性能。但对于开发环境或简单的部署，启用 Rails 的静态文件服务是可行的。

5. 总结与最佳实践

首选 asset_path 辅助方法： 当 PDF 文件作为应用程序的静态资源存在于 app/assets/ 目录下时，始终优先使用 asset_path 结合 <embed> 标签。这能够充分利用 Rails 资产管道的优势，简化文件管理，并确保在生产环境中的兼容性。
理解 send_file 与 <embed> 的差异： send_file 用于将文件作为 HTTP 响应发送给客户端（通常触发下载或在浏览器新标签页打开），而 <embed> 标签则是在当前 HTML 页面内部展示文件内容。
考虑浏览器兼容性： 现代浏览器通常内置了 PDF 阅读器，可以很好地支持 <embed> 标签。但在一些旧版本或特定配置的浏览器中，用户可能需要安装插件才能查看。
用户体验： 确保嵌入的 PDF 区域有合适的尺寸，并且页面布局合理，以提供良好的用户体验。对于移动设备，可能需要考虑更复杂的响应式设计或提供下载选项作为备用。

通过上述方法，您可以在 Ruby on Rails 应用程序中灵活且专业地嵌入 PDF 文件，提升用户体验和内容呈现的丰富性。

以上就是在 Ruby on Rails 应用中优雅地嵌入 PDF 文件的详细内容，更多请关注php中文网其它相关文章！