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 20
def initialize(tag_name, markup, options)
  super
  case markup
  when NamedSyntax
    @variables = variables_from_string($2)
    @name = Expression.parse($1)
  when SimpleSyntax
    @variables = variables_from_string(markup)
    @name = @variables.to_s
  else
    raise SyntaxError.new(options[:locale].t("errors.syntax.cycle".freeze))
  end
end

Public Instance Methods

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

  context.stack do
    key = context.evaluate(@name)
    iteration = context.registers[:cycle][key].to_i
    result = context.evaluate(@variables[iteration])
    iteration += 1
    iteration  = 0 if iteration >= @variables.size
    context.registers[:cycle][key] = iteration
    result
  end
end

Private Instance Methods

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