class Liquid::Cycle

Cycle is usually used within a loop to alternate between values, like colors or DOM classes.

{% for item in items %}
  <div class="{% cycle 'red', 'green', 'blue' %}"> {{ item }} </div>
{% end %}

 <div class="red"> Item one </div>
 <div class="green"> Item two </div>
 <div class="blue"> Item three </div>
 <div class="red"> Item four </div>
 <div class="green"> Item five</div>

Constants

NamedSyntax
SimpleSyntax

Attributes

variables[R]

Public Class Methods

new(tag_name, markup, options) click to toggle source
Calls superclass method Liquid::Tag::new
# File lib/liquid/tags/cycle.rb, line 22
def initialize(tag_name, markup, options)
  super
  case markup
  when NamedSyntax
    @variables = variables_from_string(Regexp.last_match(2))
    @name      = parse_expression(Regexp.last_match(1))
  when SimpleSyntax
    @variables = variables_from_string(markup)
    @name      = @variables.to_s
  else
    raise SyntaxError, options[:locale].t("errors.syntax.cycle")
  end
end

Public Instance Methods

render_to_output_buffer(context, output) click to toggle source
# File lib/liquid/tags/cycle.rb, line 36
def render_to_output_buffer(context, output)
  context.registers[:cycle] ||= {}

  key       = context.evaluate(@name)
  iteration = context.registers[:cycle][key].to_i

  val = context.evaluate(@variables[iteration])

  if val.is_a?(Array)
    val = val.join
  elsif !val.is_a?(String)
    val = val.to_s
  end

  output << val

  iteration += 1
  iteration = 0 if iteration >= @variables.size

  context.registers[:cycle][key] = iteration
  output
end

Private Instance Methods

variables_from_string(markup) click to toggle source
# File lib/liquid/tags/cycle.rb, line 61
def variables_from_string(markup)
  markup.split(',').collect do |var|
    var =~ /\s*(#{QuotedFragment})\s*/o
    Regexp.last_match(1) ? parse_expression(Regexp.last_match(1)) : nil
  end.compact
end