actionview

Conventions and helpers for building web pages on Rails.

Create a Topic

Topics

captureを使ってform_withのようにblockを活用したヘルパーメソッドを作る

883 views Post
wakairo @wakairo
Last edited

背景

Railsのactionviewのヘルパー関数には、form_withのように、blockを活用して入れ子のHTML要素を記述できる便利なヘルパーメソッドがあります。 具体的には、以下のような記述(Railsガイドより引用)が出来るヘルパーメソッドです。

<%= form_with url: "/search", method: :get do |form| %>
  <%= form.label :query, "Search for:" %>
  <%= form.text_field :query %>
  <%= form.submit "Search" %>
<% end %>

blockを用いてHTML要素の入れ子を出力できるこのようなヘルパーメソッドの自作に関する話です。

作り方

actionviewのcaptureというヘルパーメソッドを用いると、form_withのように、blockを使ってHTML要素の入れ子を記述できるヘルパーメソッドを自作できます。

ちなみに、このcaptureは、Railsガイドを読んでも、RailsのAPIドキュメントを読んでも、いまいち使い道が分かっていなかったのですが、このような自作ヘルパーで使うというのが1つの使い道のようです。

自作ヘルパーメソッドの実装例

def some_helper(content=nil, &block)
  object_passed_to_block = 'hello, capture'
  content = capture(object_passed_to_block, &block) if block
  tag.div(content, class: 'some-class')
end

自作ヘルパーメソッドの利用例

ERBから利用
<%= some_helper do |object| %>
  <p><%= object %></p>
<% end %>
出力結果
<div class="some-class">
  <p>hello, capture</p>
</div>
Rubyのコード内から利用
some_helper do |object|
  tag.p(object)
end
出力結果
<div class="some-class"><p>hello, capture</p></div>
Rubyのコード内からblockなしで利用
some_helper('123')
出力結果
<div class="some-class">123</div>
0
Raw
https://www.techtips.page/en/comments/281
🔧1
💡1