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. |
|
Category
Forms tags | |
Syntax<cfslider name = "name" label = "text" refreshLabel = "Yes" or "No" 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" tickMarkMajor = "Yes" or "No" tickMarkMinor = "Yes" or "No" tickMarkImages = "URL1, URL2, URLn" tickMarkLabels = "Yes" or "No" or "list" 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, cfinput, cfform, cfselect, cftextinput, cftree, cftreeitem |
|
History
New in ColdFusion MX: The img, imgStyle, and grooveColor attributes are deprecated. Do not use them in new applications. 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. 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. |
REFRESHLABEL | |
Optional | |
Default value: "Yes"
|
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
|
TICKMARKMAJOR | |
Optional | |
Default value: "No"
Major tick marks display at intervals specified by scale. |
TICKMARKMINOR | |
Optional | |
Default value: "No"
Minor tickmarks display between major tickmarks. |
TICKMARKIMAGES | |
Optional | |
Comma-delimited list of URLs specifying images in slider tickmark scale. If you do not specify enough values, the last value is repeated for remaining tickmarks. If you specify too many values, extra values are ignored. |
TICKMARKLABELS | |
Optional | |
Default value: "No"
If you do not specify enough values, the last value is repeated for remaining tickmarks. If you specify too many values, extra values are ignored. |
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 hex value, use the form: bgColor = "##xxxxxx", where x = 0-9 or A-F; use two pound 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> |