4

是否有任何标准或新兴标准来记录可以传递给 Rails 部分的参数?

_my_partial.html.erb期望 atitleelements通过 传递的本地 var 时render 'my_partial', title: t, elements: e,必须有一种通用的方法来记录它们的名称、期望的类型和角色,而无需阅读整个部分代码。诸如 RDoc 或 Tomdoc 之类的方法和类。没有吗?

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

4

1 回答 1

3

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

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

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

这对您的项目有好处的原因:

  • 它不依赖于注释或非代码文件
  • 项目中的任何开发人员都可以通过查看相关文件的顶部来快速找出需要哪些变量
  • 通过调用变量,您可以确保缺少的变量会导致异常。
  • 用方括号调用元素是因为如果它不是可枚举的,我们也希望它爆炸,对吗?

使用的做法<% var ||= 'default_val' %>实际上是不安全的,因为它允许隐藏错误。您希望您的代码在某些事情没有正确完成时立即崩溃。如果应该传递这些变量,那么您希望代码在它们不存在时爆炸。

于 2012-10-19T14:46:47.157 回答