| 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:
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:
|
|
| LOOKANDFEEL | |
| Optional | |
Default value: "Windows"
If platform does not support choice, the tag defaults to the platform's default style. |
|
| VERTICAL | |
| Optional | |
Default value: "No"
|
|
| 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.
|
|
| 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"
|
|
| BOLD | |
| Optional | |
Default value: "No"
|
|
| 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> |
|