class Liquid::Cycle
@liquid_public_docs @liquid_type tag @liquid_category iteration @liquid_name cycle @liquid_summary
Loops through a group of strings and outputs them one at a time for each iteration of a [`for` loop](/api/liquid/tags#for).
@liquid_description
The `cycle` tag must be used inside a `for` loop. > Tip: > Use the `cycle` tag to output text in a predictable pattern. For example, to apply odd/even classes to rows in a table.
@liquid_syntax
{% cycle string, string, ... %}
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 23 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 37 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 62 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