Create new RichFaces Documentation Jira issue

This will launch the RichFaces Jira page - to complete your feedback please login if needed, and submit the Jira.

JBoss.orgCommunity Documentation

6.11.8.  < rich:inputNumberSlider > available since 3.0.0

expand all
6.11.8.1. Description
6.11.8.2. Key Features
6.11.8.3. Details of Usage
6.11.8.4. Reference Data
6.11.8.5. Relevant Resources Links

The <rich:inputNumberSlider> component is a slider component. A handler's position corresponds to a definite value on the slider track. In order to change the value you can slide a handler or set the necessary value into the input field. You can dispose it horizontally or vertically on the page.


<rich:inputNumberSlider> is used to facilitate your data input with rich UI Controls.

Here is the simplest variant of a slider definition with "minValue" , "maxValue" and "step" (by default is "1") attributes, which define the beginning and the end of a numerical area and a slider property step.

Example:


<rich:inputNumberSlider></rich:inputNumberSlider>

Here is a component generated on a page:


Using "showInput" (default value is "true") and "enableManualInput" (default value is "true") attributes, it's possible to output the input area near the slider, and make it read-only or editable.

To remove input area use showInput = "false" :

Example:


<rich:inputNumberSlider minValue="1"  maxValue="100" showInput="false"/>

It's displayed on a page like this:


It's also possible to switch off displaying of "boundary values" and a toolTip showing on a handle drawing. This could be performed with the help of the component defined attributes: "showBoundaryValues" which is responsible for "boundary values" displaying (default value is "true") and "showToolTip" which is responsible for tooltTip displaying (default value is "true").

Moreover, to add e.g. some JavaScript effects, events defined on it are used.

  • "onchange"

  • "onmouseover"

  • "onclick"

  • "onfocus"

  • "onmouseout"

  • etc.

The "label" attribute is a generic attribute. The "label" attribute provides an association between the component and the message that the component (indirectly) produced. This attribute defines the parameters of a localized error and informational messages that occur as a result of conversion, validation, or other application actions during the request processing lifecycle. With the help of this attribute you can replace the last parameter substitution token shown in the messages. For example, {1} for "DoubleRangeValidator.MAXIMUM" , {2} for "ShortConverter.SHORT".

The "showArrows" boolean attribute when set to "true" enables additional controls for increasing and decreasing slider value. The controls (arrows by default) are placed in the beginning and in the end of a slider track:


Clicking an arrow changes the driven value on the amount defined with "step" attribute. Keepeng an arrow control pressed changes the value continuous. Time that value takes to change from one step to another is definded with "delay" attribute.

Table of <rich:inputNumberSlider> attributes.




You can find all necessary information about style classes redefinition in Definition of Custom Style Classes section.

On the component Live Demo page you can see the example of <rich:inputNumberSlider> usage and sources for the given example.