instance method `turbo_frame_tag`

Ruby on Rails 1.5.0

Since v1.3.3 Last seen in v2.0.23

Available in: v1.3.3 v1.4.0 v1.5.0 v2.0.23

Compare with:

turbo_frame_tag(*ids, src: nil, target: nil, **attributes, &block)

Returns a frame tag that can either be used simply to encapsulate frame content or as a lazy-loading container that starts empty but fetches the URL supplied in the src attribute.

Examples

<%= turbo_frame_tag "tray", src: tray_path(tray) %>
# => <turbo-frame id="tray" src="http://example.com/trays/1"></turbo-frame>

<%= turbo_frame_tag tray, src: tray_path(tray) %>
# => <turbo-frame id="tray_1" src="http://example.com/trays/1"></turbo-frame>

<%= turbo_frame_tag "tray", src: tray_path(tray), target: "_top" %>
# => <turbo-frame id="tray" target="_top" src="http://example.com/trays/1"></turbo-frame>

<%= turbo_frame_tag "tray", target: "other_tray" %>
# => <turbo-frame id="tray" target="other_tray"></turbo-frame>

<%= turbo_frame_tag "tray", src: tray_path(tray), loading: "lazy" %>
# => <turbo-frame id="tray" src="http://example.com/trays/1" loading="lazy"></turbo-frame>

<%= turbo_frame_tag "tray" do %>
  <div>My tray frame!</div>
<% end %>
# => <turbo-frame id="tray"><div>My tray frame!</div></turbo-frame>

The turbo_frame_tag helper will convert the arguments it receives to their dom_id if applicable to easily generate unique ids for Turbo Frames:

<%= turbo_frame_tag(Article.find(1)) %>
# => <turbo-frame id="article_1"></turbo-frame>

<%= turbo_frame_tag(Article.find(1), "comments") %>
# => <turbo-frame id="article_1_comments"></turbo-frame>

<%= turbo_frame_tag(Article.find(1), Comment.new) %>
# => <turbo-frame id="article_1_new_comment"></turbo-frame>

Parameters

ids rest
src key = nil
target key = nil
attributes keyrest
block block

Source

# File app/helpers/turbo/frames_helper.rb, line 38
  def turbo_frame_tag(*ids, src: nil, target: nil, **attributes, &block)
    id = ids.first.respond_to?(:to_key) ? ActionView::RecordIdentifier.dom_id(*ids) : ids.first
    src = url_for(src) if src.present?

    tag.turbo_frame(**attributes.merge(id: id, src: src, target: target).compact, &block)
  end

Defined in app/helpers/turbo/frames_helper.rb line 38 · View on GitHub · Improve this page · Find usages on GitHub

Defined in Turbo::FramesHelper

Signature

Examples

Parameters