ruby-on-rails - 在 Rails 中记录部分参数

Question

是否有任何标准或新兴标准来记录可以传递到 Rails partial 的参数？

当 _my_partial.html.erb 需要 title 和 elements 局部变量时， render 'my_partial', title: t, elements: e 必须有一种通用的方法来记录它们的名称、预期类型和角色，而无需阅读整个部分代码。类似于 RDoc 或 Tomdoc 的方法和类。不是吗？

编辑:我发现 a post 其作者主张在部分的第一行中使用 <% var ||= 'default_val' %> 初始化参数，这确实是一种安全的做法和一种代码内文档。真的没有评论/参数声明解决方案吗？

Answer 1

在部分开始时，只需调用所有引用的变量。

# _my_partial.html.erb
<% title %>            <---  first line of file
<% elements[0] %>

<h3><%= title %></h3>
<% elements.each do |element| %>
   <p> etc ... </p>

这对您的项目有益的原因:

它不依赖于注释或非代码文件

项目中的任何开发人员都可以通过查看相关文件的顶部来快速找出需要哪些变量

通过调用变量，您可以确保丢失的变量会导致异常。

元素是用方括号调用的，因为如果它不是可枚举的，我们也希望它爆炸，对吗？

使用实践<% var ||= 'default_val' %>实际上是 不安全 因为它允许隐藏错误。您希望您的代码在某些地方做得不对时立即炸毁。如果应该传递这些变量，那么您希望代码在它们不存在时爆炸。