Class: Liquid::Capture

Inherits:
Block show all
Defined in:
lib/liquid/tags/capture.rb

Overview

Capture stores the result of a block into a variable without rendering it inplace.

{% capture heading %}
  Monkeys!
{% endcapture %}
...
<h1>{{ heading }}</h1>

Capture is useful for saving content for use later in your template, such as in a sidebar or footer.

Constant Summary

Syntax =
/(\w+)/

Constants inherited from Block

Block::ContentOfVariable, Block::FullToken, Block::IsTag, Block::IsVariable

Instance Attribute Summary

Attributes inherited from Tag

#nodelist, #options, #warnings

Instance Method Summary collapse

Methods inherited from Block

#block_delimiter, #block_name, #create_variable, #end_tag, #parse, #unknown_tag, #warnings

Methods inherited from Tag

#name, parse, #parse, #parse_with_selected_parser

Constructor Details

#initialize(tag_name, markup, options) ⇒ Capture



17
18
19
20
21
22
23
24
# File 'lib/liquid/tags/capture.rb', line 17

def initialize(tag_name, markup, options)
  super
  if markup =~ Syntax
    @to = $1
  else
    raise SyntaxError.new(options[:locale].t("errors.syntax.capture"))
  end
end

Instance Method Details

#blank?Boolean



33
34
35
# File 'lib/liquid/tags/capture.rb', line 33

def blank?
  true
end

#render(context) ⇒ Object



26
27
28
29
30
31
# File 'lib/liquid/tags/capture.rb', line 26

def render(context)
  output = super
  context.scopes.last[@to] = output
  context.increment_used_resources(:assign_score_current, output)
  ''.freeze
end