CFLib.org – Common Function Library Project

Description:
Returns color from list of colors based on row number sent. Useful for alternating row colors in a table, but is not limited to two colors. Also see EvenOddColor.

Return Values:
Returns a string.

Example:

<cfset colorList=("blue,##ff0000,white")>
<cfoutput>
<table>
<cfloop from="1" to="10" index="i">
<tr bgcolor="#RowColor(colorList,i,",")#">
<td>Row Number: #i#</td>
</tr>
</cfloop>
</table>
</cfoutput>

Parameters:

Full UDF Source:

/**
 * Returns alternating color based on list of colors.
 * 
 * @param colorList      List of colors. (Required)
 * @param currentRow      Current row number. (Required)
 * @param delimiter      List delimiter for colorList. Defaults to a comma. (Optional)
 * @return Returns a string. 
 * @author Al Everett (everett.al@gmail.com) 
 * @version 1, December 21, 2011 
 */
function rowColor(colorList,currentRow) {
    var delimiter=",";
    var rowColor="";
    var colorIndex=1;

    if (ArrayLen(arguments) GT 2) delimiter = arguments[3];
    
    colorIndex=currentRow MOD ListLen(colorList,delimiter) + 1;
    
    rowColor=ListGetAt(colorList,colorIndex,delimiter);
    
    return rowColor;
}