Rangeslider

From Documentation
Revision as of 13:11, 7 January 2022 by Hawk (talk | contribs) ((via JWB))

Rangeslider

  • Available for ZK:
  • http://www.zkoss.org/product/zkhttp://www.zkoss.org/whyzk/zkeeVersion pe-ee.png
since 9.0.0

Employment/Purpose

A rangeslider component represents a slider with a start and an end value. A rangeslider accepts a range of value starting from 0 to a certain maximum value. The default maximum value of rangeslider is 100. You can change the maximum allowed value by setting the max property. Notice that the value of max property is always larger than the value of min property.

Example

ZKComRef Rangeslider.png

<zk>
  <rangeslider startValue="10" endValue="90"/>
  <separator />
  <rangeslider orient="vertical" startValue="20" endValue="80" markScale="20" />
</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 map for displaying value marks. (Default: null) In this map, the key represents the number value of slider, and the value represents the displayed scale text.

MarkScale

Sets the marks information for displaying value marks (Default: "20").

By default, the value marks will be displayed every 20 starting from the minimum value. (if min is 0, then it displays "0 20 40 ...")


If the MarkScale is 0 and there is no Map information in Marks (see above), the marks will be empty.

ZKComRef RangesliderNoMarks.png

Max

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

Min

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

StartValue, EndValue

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

Step

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

TooltipVisible

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

Supported Events

Name
Event Type
onRangeValueChange
Event: RangeValueChangeEvent

Denotes the range value of a component has been changed by the user.

Supported Children

*None

Use Cases

Version Description Example Location
     

Version History

Last Update : 2022/01/07


Version Date Content
9.0.0 November, 2019 Rangeslider was introduced.



Last Update : 2022/01/07

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