CFSLIDER  
Description

Puts a slider control, for selecting a numeric value from a range, in a ColdFusion form. The slider moves over the slider groove. As the user moves the slider, the current value displays. Used within a cfform tag. Not supported with Flash forms.

 
Category

Forms tags

 
Syntax
<cfslider 
name = "name"
   label = "text"
   range = "min_value, max_value"
   scale = "uinteger"
   value = "integer"
   onValidate = "script_name"
   message = "text"
   onError = "text"
   height = "integer"
   width = "integer"
   vSpace = "integer"
   hSpace = "integer"
   align = "alignment"
   lookAndFeel = "motif" or "windows" or "metal"
   vertical = "yes" or "no"
   bgColor = "color"
   textColor = "color"
   font = "font_name"
   fontSize = "integer"
   italic = "yes" or "no"
   bold = "yes" or "no"
   notSupported = "text">
 
See also

cfapplet, cfcalendar, cfform, cfformgroup, cfformitem, cfgrid, cfinput, cfselect, cftextarea, cftree; Chapter 26, "Introduction to Retrieving and Formatting Data," and Chapter 27, "Building Dynamic Forms with cfform Tags,"in ColdFusion MX Developer's Guide

 
History

ColdFusion MX: Deprecated the img, imgStyle, grooveColor, refreshLabel, tickmarklabels, tickmarkmajor, tickmarkminor, and tickmarkimages attributes. They might not work, and might cause an error, in later releases.

 
Usage

This tag requires the client to download a Java applet. Using this tag may be slightly slower than using an HTML form element to display the same information. Also, if the client does not have an up-to-date Java plugin installed, the system might also have to download an updated Java plugin to display the tag.

For this tag to work properly, the browser must be JavaScript-enabled.

If the following conditions are true, a user's selection from query data that populates this tag's options continues to display after the user submits the form:

  • The cfform preserveData attribute is set to "Yes".
  • The cfform action attribute posts to the same page as the form itself (this is the default), or the action page has a form that contains controls with the same names as corresponding controls on the user entry form.

For more information, see the cfform tag entry.

 
Example
<!--- This example shows how to use cfslider within cfform. --->
<h3>cfslider Example</h3>
<p>cfslider, used within a cfform, can provide functionality 
   to Java-enabled browsers.
<p>Try moving the slider back and forth to see the real-time value change. 
   Then, submit the form to show how cfslider passes its value on to a new page.
<cfif isdefined("form.mySlider") is true>
   <h3>You slid to a value of    <cfoutput>#mySlider#</cfoutput></h3>
   Try again!
</cfif>
<cfform action = "cfslider.cfm">
   <cfslider name = "mySlider" value = "12" 
      label = "Actual Slider Value "
      range = "1,100" align = "BASELINE" 
      message = "Slide the bar to get a value between 1 and 100" 
      height = "50"       width = "150" font = "Verdana" 
      bgColor = "Silver" bold = "No" 
      italic = "Yes" refreshLabel = "Yes"> 100
<p><input type = "Submit" name = "" value = "Show the Result">
</cfform>
NAME  
  Required
 

Name of cfslider control.
LABEL  
  Optional
 

Label to display with control; for example, "Volume" This displays: "Volume %value%"

To reference the value, use "%value%". If %% is omitted, slider value displays directly after label.
RANGE  
  Optional
 
Default value: ""0,100""

Numeric slider range values.

Separate values with a comma.
SCALE  
  Optional
 

Unsigned integer. Defines slider scale, within range. For example, if range = "0,1000" and scale = "100", the display values are:0, 100, 200, 300, ...

Signed and unsigned integers in ColdFusion are in the range -2,147,483,648 to 2,147,483,647.

VALUE  
  Optional
 
Default value: "Minimum in range"

Starting slider setting. Must be within the range values.
ONVALIDATE  
  Optional
 

Custom JavaScript function to validate user input; in this case, a change to the default slider value.

Specify only the function name.
MESSAGE  
  Optional
 

Message text to appear if validation fails.
ONERROR  
  Optional
 

Custom JavaScript function to execute if validation fails.

Specify only the function name.
HEIGHT  
  Optional
 
Default value: "40"

Slider control height, in pixels.
WIDTH  
  Optional
 

Slider control width, in pixels.

VSPACE  
  Optional
 

Vertical spacing above and below slider, in pixels.
HSPACE  
  Optional
 

Horizontal spacing to left and right of slider, in pixels.
ALIGN  
  Optional
 

Alignment of slider:

  • top
  • left
  • bottom
  • baseline
  • texttop
  • absbottom
  • middle
  • absmiddle
  • right
LOOKANDFEEL  
  Optional
 
Default value: "Windows"
  • motif: renders slider using Motif style.
  • windows: renders slider using Windows style.
  • metal: renders slider using Java Swing style.

If platform does not support choice, the tag defaults to the platform's default style.

VERTICAL  
  Optional
 
Default value: "No"
  • Yes: renders slider in browser vertically. You must set width and height attributes; ColdFusion does not automatically swap width and height values.
  • No: renders slider horizontally.
BGCOLOR  
  Optional
 

Background color of slider label.

For a hexadecimal value, use the form: bgColor = "##xxxxxx", where x = 0-9 or A-F; use two number signs or none.

  • Any color, in hexadecimal format
  • black
  • red
  • blue
  • magenta
  • cyan
  • orange
  • darkgray
  • pink
  • gray
  • white
  • lightgray
  • yellow
TEXTCOLOR  
  Optional
 

Options: same as for bgcolor attribute.
FONT  
  Optional
 

Font name for label text.
FONTSIZE  
  Optional
 

Font size for label text, in points.
ITALIC  
  Optional
 
Default value: "No"
  • Yes: label text in italics.
  • No: normal text.
BOLD  
  Optional
 
Default value: "No"
  • Yes: label text in bold.
  • No: medium text.
NOTSUPPORTED  
  Optional
 

Text to display if a page that contains a Java applet-based cfform control is opened by a browser that does not support Java or has Java support disabled. For example:

"<b> Browser must support Java to view ColdFusion Java Applets</b>"

Default message:

<b>Browser must support Java to <br>view ColdFusion Java Applets!</b>