The ace:sliderEntry component enables the user to adjust values in a finite range along a horizontal or vertical axis via dragging the slider control along the slider bar, or pressing the arrow-keys.
It can be used as a visual replacement for an input box that takes a number as input.
To use the slider component, first the ace component name-space has to be added in your page.
Now you ready to use slider component, here is the basic example:
By now page should look like this:
This section covers attributes involved in the typical use-cases for this component. For reference, the complete taglib documentation for this component is available here.
|valueChangeListener||Used to define a server-side valueChangeListener which will be notified each time the slider value is changed. The valueChangeEvent is fired whenever the "slideEnd" client event fires.|
|slideBegin||Fired when a drag operation on the slider control is initiated.|
|slide||Fired each time the the slider control is moved during a drag operation.|
|slideEnd||Fired when a drag operation is completed by releasing the slider control (default event).|
The client side dialog object is exposed through the global variable name specified in the widgetVar attribute. When widgetVar is not explicitly specified, it is derived algorithmically from the clientId. You can use the getValue() and setValue() methods to get and set the slider value:
|Left Arrow or Down Arrow||Decrease the value of the slider.|
|Right Arrow or Up Arrow||Increase the value of the slider.|
|Home key||Move to the minimum value of the slider.|
|End key||Move to the maximum value of the slider.|
The following known issues exist for the sliderEntry:
- The 'showLabels' attribute is not functional in ICEfaces 3.0.0. It does work correctly in 2.0.x and again in ICEfaces-3.3.0
The sliderEntry component appears in the following ICEfaces sample applications:
- Slider Demo
- Located under /icefaces/samples/showcase.
The sliderEntry component appears in the following ICEfaces tutorials: