# This tag builder is used both for inline controller turbo actions (see Turbo::Streams::TurboStreamsTagBuilder) and for
# turbo stream templates. This object plays together with any normal Ruby you'd run in an ERB template, so you can iterate, like:
#
# <% # app/views/postings/destroy.turbo_stream.erb %>
# <% @postings.each do |posting| %>
# <%= turbo_stream.remove posting %>
# <% end %>
#
# Or string several separate updates together:
#
# <% # app/views/entries/_entry.turbo_stream.erb %>
# <%= turbo_stream.remove entry %>
#
# <%= turbo_stream.append "entries" do %>
# <% # format is automatically switched, such that _entry.html.erb partial is rendered, not _entry.turbo_stream.erb %>
# <%= render partial: "entries/entry", locals: { entry: entry } %>
# <% end %>
#
# Or you can render the HTML that should be part of the update inline:
#
# <% # app/views/topics/merges/_merge.turbo_stream.erb %>
# <%= turbo_stream.append dom_id(topic_merge) do %>
# <%= link_to topic_merge.topic.name, topic_path(topic_merge.topic) %>
# <% end %>
class Turbo::Streams::TagBuilder
include Turbo::Streams::ActionHelper
def initialize(view_context)
@view_context = view_context
@view_context.formats |= [:html]
end
# Removes the target from the dom. The target can either be a dom id string or an object that responds to
# to_key, which is then called and passed through ActionView::RecordIdentifier.dom_id (all Active Records
# do). Examples:
#
# <%= turbo_stream.remove "clearance_5" %>
# <%= turbo_stream.remove clearance %>
def remove(target)
action :remove, target, allow_inferred_rendering: false
end
# Removes the targets from the dom. The targets can either be a CSS selector string or an object that responds to
# to_key, which is then called and passed through ActionView::RecordIdentifier.dom_id (all Active Records
# do). Examples:
#
# <%= turbo_stream.remove_all ".clearance_item" %>
# <%= turbo_stream.remove_all clearance %>
def remove_all(targets)
action_all :remove, targets, allow_inferred_rendering: false
end
# Replace the target in the dom with either the content passed in, a rendering result determined
# by the rendering keyword arguments, the content in the block, or the rendering of the target as a record. Examples:
#
# <%= turbo_stream.replace "clearance_5", "Replace the dom target identified by clearance_5
" %>
# <%= turbo_stream.replace clearance %>
# <%= turbo_stream.replace clearance, partial: "clearances/clearance", locals: { title: "Hello" } %>
# <%= turbo_stream.replace "clearance_5" do %>
# Replace the dom target identified by clearance_5
# <% end %>
def replace(target, content = nil, **rendering, &block)
action :replace, target, content, **rendering, &block
end
# Replace the targets in the dom with either the content passed in, a rendering result determined
# by the rendering keyword arguments, the content in the block, or the rendering of the target as a record. Examples:
#
# <%= turbo_stream.replace_all ".clearance_item", "Replace the dom target identified by the class clearance_item
" %>
# <%= turbo_stream.replace_all clearance %>
# <%= turbo_stream.replace_all clearance, partial: "clearances/clearance", locals: { title: "Hello" } %>
# <%= turbo_stream.replace_all ".clearance_item" do %>
# Replace the dom target identified by the class clearance_item
# <% end %>
def replace_all(targets, content = nil, **rendering, &block)
action_all :replace, targets, content, **rendering, &block
end
# Insert the content passed in, a rendering result determined by the rendering keyword arguments,
# the content in the block, or the rendering of the target as a record before the target in the dom. Examples:
#
# <%= turbo_stream.before "clearance_5", "Insert before the dom target identified by clearance_5
" %>
# <%= turbo_stream.before clearance %>
# <%= turbo_stream.before clearance, partial: "clearances/clearance", locals: { title: "Hello" } %>
# <%= turbo_stream.before "clearance_5" do %>
# Insert before the dom target identified by clearance_5
# <% end %>
def before(target, content = nil, **rendering, &block)
action :before, target, content, **rendering, &block
end
# Insert the content passed in, a rendering result determined by the rendering keyword arguments,
# the content in the block, or the rendering of the target as a record before the targets in the dom. Examples:
#
# <%= turbo_stream.before_all ".clearance_item", "Insert before the dom target identified by the class clearance_item
" %>
# <%= turbo_stream.before_all clearance %>
# <%= turbo_stream.before_all clearance, partial: "clearances/clearance", locals: { title: "Hello" } %>
# <%= turbo_stream.before_all ".clearance_item" do %>
# Insert before the dom target identified by clearance_item
# <% end %>
def before_all(targets, content = nil, **rendering, &block)
action_all :before, targets, content, **rendering, &block
end
# Insert the content passed in, a rendering result determined by the rendering keyword arguments,
# the content in the block, or the rendering of the target as a record after the target in the dom. Examples:
#
# <%= turbo_stream.after "clearance_5", "Insert after the dom target identified by clearance_5
" %>
# <%= turbo_stream.after clearance %>
# <%= turbo_stream.after clearance, partial: "clearances/clearance", locals: { title: "Hello" } %>
# <%= turbo_stream.after "clearance_5" do %>
# Insert after the dom target identified by clearance_5
# <% end %>
def after(target, content = nil, **rendering, &block)
action :after, target, content, **rendering, &block
end
# Insert the content passed in, a rendering result determined by the rendering keyword arguments,
# the content in the block, or the rendering of the target as a record after the targets in the dom. Examples:
#
# <%= turbo_stream.after_all ".clearance_item", "Insert after the dom target identified by the class clearance_item
" %>
# <%= turbo_stream.after_all clearance %>
# <%= turbo_stream.after_all clearance, partial: "clearances/clearance", locals: { title: "Hello" } %>
# <%= turbo_stream.after_all "clearance_item" do %>
# Insert after the dom target identified by the class clearance_item
# <% end %>
def after_all(targets, content = nil, **rendering, &block)
action_all :after, targets, content, **rendering, &block
end
# Update the target in the dom with either the content passed in or a rendering result determined
# by the rendering keyword arguments, the content in the block, or the rendering of the target as a record. Examples:
#
# <%= turbo_stream.update "clearance_5", "Update the content of the dom target identified by clearance_5" %>
# <%= turbo_stream.update clearance %>
# <%= turbo_stream.update clearance, partial: "clearances/unique_clearance", locals: { title: "Hello" } %>
# <%= turbo_stream.update "clearance_5" do %>
# Update the content of the dom target identified by clearance_5
# <% end %>
def update(target, content = nil, **rendering, &block)
action :update, target, content, **rendering, &block
end
# Update the targets in the dom with either the content passed in or a rendering result determined
# by the rendering keyword arguments, the content in the block, or the rendering of the targets as a record. Examples:
#
# <%= turbo_stream.update_all "clearance_item", "Update the content of the dom target identified by the class clearance_item" %>
# <%= turbo_stream.update_all clearance %>
# <%= turbo_stream.update_all clearance, partial: "clearances/new_clearance", locals: { title: "Hello" } %>
# <%= turbo_stream.update_all "clearance_item" do %>
# Update the content of the dom target identified by the class clearance_item
# <% end %>
def update_all(targets, content = nil, **rendering, &block)
action_all :update, targets, content, **rendering, &block
end
# Append to the target in the dom identified with target either the content passed in or a
# rendering result determined by the rendering keyword arguments, the content in the block,
# or the rendering of the content as a record. Examples:
#
# <%= turbo_stream.append "clearances", "Append this to .clearances
" %>
# <%= turbo_stream.append "clearances", clearance %>
# <%= turbo_stream.append "clearances", partial: "clearances/unique_clearance", locals: { clearance: clearance } %>
# <%= turbo_stream.append "clearances" do %>
# Append this to .clearances
# <% end %>
def append(target, content = nil, **rendering, &block)
action :append, target, content, **rendering, &block
end
# Append to the targets in the dom identified with targets either the content passed in or a
# rendering result determined by the rendering keyword arguments, the content in the block,
# or the rendering of the content as a record. Examples:
#
# <%= turbo_stream.append_all ".clearances", "Append this to .clearance_group
" %>
# <%= turbo_stream.append_all ".clearances", clearance %>
# <%= turbo_stream.append_all ".clearances", partial: "clearances/new_clearance", locals: { clearance: clearance } %>
# <%= turbo_stream.append_all ".clearances" do %>
# Append this to .clearances
# <% end %>
def append_all(targets, content = nil, **rendering, &block)
action_all :append, targets, content, **rendering, &block
end
# Prepend to the target in the dom identified with target either the content passed in or a
# rendering result determined by the rendering keyword arguments or the content in the block,
# or the rendering of the content as a record. Examples:
#
# <%= turbo_stream.prepend "clearances", "Prepend this to .clearances
" %>
# <%= turbo_stream.prepend "clearances", clearance %>
# <%= turbo_stream.prepend "clearances", partial: "clearances/unique_clearance", locals: { clearance: clearance } %>
# <%= turbo_stream.prepend "clearances" do %>
# Prepend this to .clearances
# <% end %>
def prepend(target, content = nil, **rendering, &block)
action :prepend, target, content, **rendering, &block
end
# Prepend to the targets in the dom identified with targets either the content passed in or a
# rendering result determined by the rendering keyword arguments or the content in the block,
# or the rendering of the content as a record. Examples:
#
# <%= turbo_stream.prepend_all ".clearances", "Prepend this to .clearances
" %>
# <%= turbo_stream.prepend_all ".clearances", clearance %>
# <%= turbo_stream.prepend_all ".clearances", partial: "clearances/new_clearance", locals: { clearance: clearance } %>
# <%= turbo_stream.prepend_all ".clearances" do %>
# Prepend this to .clearances
# <% end %>
def prepend_all(targets, content = nil, **rendering, &block)
action_all :prepend, targets, content, **rendering, &block
end
# Send an action of the type name to target. Options described in the concrete methods.
def action(name, target, content = nil, allow_inferred_rendering: true, **rendering, &block)
template = render_template(target, content, allow_inferred_rendering: allow_inferred_rendering, **rendering, &block)
turbo_stream_action_tag name, target: target, template: template
end
# Send an action of the type name to targets. Options described in the concrete methods.
def action_all(name, targets, content = nil, allow_inferred_rendering: true, **rendering, &block)
template = render_template(targets, content, allow_inferred_rendering: allow_inferred_rendering, **rendering, &block)
turbo_stream_action_tag name, targets: targets, template: template
end
private
def render_template(target, content = nil, allow_inferred_rendering: true, **rendering, &block)
case
when content
allow_inferred_rendering ? (render_record(content) || content) : content
when block_given?
@view_context.capture(&block)
when rendering.any?
@view_context.render(formats: [ :html ], **rendering)
else
render_record(target) if allow_inferred_rendering
end
end
def render_record(possible_record)
if possible_record.respond_to?(:to_partial_path)
record = possible_record
@view_context.render(partial: record, formats: :html)
end
end
end