Rangeslider

From Documentation
Revision as of 10:19, 12 November 2019 by Jameschu (talk | contribs) (→‎Disabled)

Rangeslider

Employment/Purpose

A rangeslider component represents a slider with a range value. It can be used to let user select a start value and end value. A rangeslider accepts a range of value starting from 0 to certain maximum value. The default maximum value of rangeslider scale is 100. You could change the maximum allowed value by the max property. Notice that the value of max property is always larger than the value of min property.

Example

<zk xmlns:ca="client/attribute">
  <rangeslider startValue="10" endValue="90"/>
</zk>

Properties

Disabled

If the rangeslider is disabled, then users can not drag the slider buttons.

Orient

Sets the orient either "horizontal" or "vertical" to display rangslider.

Marks

Sets the marks information for displaying value marks. (Default: "20") If there is only a number value, for example: 20. The value marks would be displayed every 20 start from the minimum value. (if min is 0, then display "0 20 40 ...") Another options for the marks can be specified as follows:

<rangeslider marks="10:10%, 20:20%, 50:50%, 80:80%" />

It means that each value mark could be displayed in different text.

Max

Rangeslider supports maximal position, which can be changed by the max property as follows. (Default: 100)

Min

Rangeslider supports minimal position, which can be changed by the min property as follows. (Default: 0)

StartValue, EndValue

Represent the range value of Rangeslider. (Default: 0)

Step

By default, the rangeslider will scroll to the position continuously when an user drags it. If you prefer to scroll a discrete fixed amount on each step, you can set the amount of value of the step property.

TooltipVisible

The tooltip displays the value of slider buttons in rangeslider. If the tooltipvisible is true, the tooltips of the slider buttons would be always visible. (Default: false)

Supported Events

Name
Event Type
onScroll
Event: ScrollEvent

Denotes the content of a scrollable component has been scrolled by the user.

onScrolling
Event: ScrollEvent

Denotes that the user is scrolling a scrollable component. Notice that the component's content (at the server) won't be changed until onScroll is received. Thus, you have to invoke the getPos method in the ScrollEvent class to retrieve the temporary position.


Supported Children

*None

Use Cases

Version Description Example Location
     

Version History

Last Update : 2019/11/12


Version Date Content
9.0.0 November, 2019 Rangeslider was introduced.



Last Update : 2019/11/12

Copyright © Potix Corporation. This article is licensed under GNU Free Documentation License.