Rails ViewComponent中如何根据参数动态渲染不同模板？

方法一：用render_template指定正确路径 #

你碰到的找不到模板问题，大概率是路径写错了。ViewComponent的模板默认放在app/components/下，和组件类对应。比如SectionComponent的默认模板是app/components/section_component.html.erb，如果要切换到其他模板，得指定相对于app/components的完整路径。

正确重写render方法的示例：

class SectionComponent < ViewComponent::Base
  def initialize(special: false)
    @special = special
  end

  def render
    if @special
      render_template("section_component_special")
    else
      super # 渲染默认模板
    end
  end
end

注意：要把目标模板放在默认模板同一目录下，比如app/components/section_component_special.html.erb。如果模板在子目录，比如app/components/section/special.html.erb，路径就要写成"section/special"。

方法二：动态设置template属性 #

更简洁的方式是初始化时直接改组件的template属性，不用重写render方法：

class SectionComponent < ViewComponent::Base
  def initialize(special: false)
    @special = special
    self.template = @special ? "section_component_special" : "section_component"
  end
end

这种方式会让组件自动加载指定模板，不用手动调用render_template。

方法三：用局部模板拆分逻辑 #

如果只是部分内容不同，没必要切换整个模板，可以在默认模板里通过条件渲染局部模板：

<!-- app/components/section_component.html.erb -->
<div class="section">
  <% if @special %>
    <%= render partial: "section_component_special_content" %>
  <% else %>
    <%= render partial: "section_component_default_content" %>
  <% end %>
</div>

对应的局部模板要放在同一目录下，命名格式是_section_component_special_content.html.erb和_section_component_default_content.html.erb。

常见排查点 #

• 模板文件名要和指定路径一致，注意蛇形命名和大小写（Rails默认遵循蛇形命名规则）。
• 模板必须放在app/components/目录或其子目录下，引擎组件要对应引擎的组件目录。
• 不要在render方法里提前return或终止逻辑，确保代码能正常执行到渲染步骤。

内容的提问来源于stack exchange，提问作者Maxence