## Licensed to the Apache Software Foundation (ASF) under one
## or more contributor license agreements.  See the NOTICE file
## distributed with this work for additional information
## regarding copyright ownership.  The ASF licenses this file
## to you under the Apache License, Version 2.0 (the
## "License"); you may not use this file except in compliance
## with the License.  You may obtain a copy of the License at
##
##   http://www.apache.org/licenses/LICENSE-2.0
##
## Unless required by applicable law or agreed to in writing,
## software distributed under the License is distributed on an
## "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
## KIND, either express or implied.  See the License for the
## specific language governing permissions and limitations
## under the License.
#title( 'AlternatorTool' )
<p>
This page demonstrates functions of the #doclink( 'AlternatorTool' true ).
The <a href="#fullDemo">example</a> at the bottom is a good demonstration of the
difference between an automatic #doclink( 'Alternator' true ) and a manual one.
</p>

#demoTableStart()

#set( $quote = '' )

#set( $desc = "Returns <code>true</code> if #doclink( 'Alternator' true )s created by this tool will auto-alternate by default." )
#demo( 'alternator' 'autoAlternateDefault'  $desc )

#set( $desc = "Returns a new, default #doclink( 'Alternator' true ) that alternates over the specified List or Object array of values." )
#demo1( 'alternator' 'make' 5 $desc)

#set( $desc = "Return a new, default #doclink( 'Alternator' true ) that alternates between the two specified values." )
#demo2( 'alternator' 'make' 5 $desc )

#set( $desc = "Returns a new, automatically alternating #doclink( 'Alternator' true ) that alternates over the specified List or Object array of values." )
#demo1( 'alternator' 'auto' 5 $desc)

#set( $desc = "Return a new, automatically alternating #doclink( 'Alternator' true ) that alternates between the two specified values." )
#demo2( 'alternator' 'auto' 5 $desc )

#set( $desc = "Returns a new, manually alternating #doclink( 'Alternator' true ) that alternates over the specified List or Object array of values." )
#demo1( 'alternator' 'manual' 5 $desc)

#set( $desc = "Return a new, manually alternating #doclink( 'Alternator' true ) that alternates between the two specified values." )
#demo2( 'alternator' 'manual' 5 $desc )

#demoCustom( "alternator.make(['b','c','a'])" )
</table>

<div align="center">
  <a name="fullDemo"><h3>Example Display</h3></a>
<form method="post" action="$link.self.anchor('fullDemo')">
<textarea name="demo" rows="6" cols="65">##
#if( $params.demo )##
$params.demo##
#else##
${esc.h}set( ${esc.d}color = ${esc.d}alternator.auto('red', 'blue') )
${esc.h}${esc.h} use manual alternation for this one
${esc.h}set( ${esc.d}style = ${esc.d}alternator.manual(['hip','fly','groovy']) )
${esc.h}foreach( ${esc.d}i in [1..5] )
 Number ${esc.d}i is ${esc.d}color and ${esc.d}style. I dig $style.next numbers.
${esc.h}end##
#end##
</textarea>
  <br>
  <input type="submit" value="Try it!">
  #if( $params.layout )
  <input type="hidden" name="layout" value="$params.layout">
  #end
</form>

#if( $params.demo )
Your code returned the following results:
<pre>
  $render.eval($params.demo)
</pre>
#end
</div>