lib/roda/plugins/content_for.rb



# frozen-string-literal: true

#
class Roda
  module RodaPlugins
    # The content_for plugin is designed to be used with the
    # render plugin, allowing you to store content inside one
    # template, and retrieve that content inside a separate
    # template.  Most commonly, this is so view templates
    # can set content for the layout template to display outside
    # of the normal content pane.
    #
    # In the template in which you want to store content, call
    # content_for with a block:
    #
    #   <% content_for :foo do %>
    #     Some content here.
    #   <% end %>
    #
    # You can also set the raw content as the second argument,
    # instead of passing a block:
    #
    #   <% content_for :foo, "Some content" %>
    #
    # In the template in which you want to retrieve content,
    # call content_for without the block:
    #
    #   <%= content_for :foo %>
    #
    # If content_for is used multiple times with the same key,
    # by default, the last call will override previous calls.
    # If you want to append to the content, pass the :append
    # option when loading the plugin:
    #
    #   plugin :content_for, :append=>true
    module ContentFor
      # Depend on the render plugin, since this plugin only makes
      # sense when the render plugin is used.
      def self.load_dependencies(app, _opts = {})
        app.plugin :render
      end

      # Configure whether to append or overwrite if content_for
      # is called multiple times to set data. Overwrite is default, use
      # the :append option to append.
      def self.configure(app, opts = {})
        app.opts[:append_content_for] = opts.fetch(:append, false)
      end

      module InstanceMethods
        # If called with a block, store content enclosed by block
        # under the given key.  If called without a block, retrieve
        # stored content with the given key, or return nil if there
        # is no content stored with that key.
        def content_for(key, value=nil, &block)
          append = opts[:append_content_for]

          if block || value
            if block
              outvar = render_opts[:template_opts][:outvar]
              buf_was = instance_variable_get(outvar)

              # Use temporary output buffer for ERB-based rendering systems
              instance_variable_set(outvar, String.new)
              value = Tilt[render_opts[:engine]].new(&block).render
              instance_variable_set(outvar, buf_was)
            end

            @_content_for ||= {}

            if append
              (@_content_for[key] ||= []) << value
            else
              @_content_for[key] = value
            end
          elsif @_content_for && (value = @_content_for[key])
            if append
              value = value.join
            end

            value
          end
        end
      end
    end

    register_plugin(:content_for, ContentFor)
  end
end