ICEfaces-EE ACE Components
Tag sliderEntry


The Slider Entry is a component that 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.

For more information, see the SliderEntry Wiki Documentation.


Client Events
NameDescriptionSupported classes for argument
slideStartFired when a drag operation on the slider control is initiated.javax.faces.event.AjaxBehaviorEvent
slideFired each time the the slider control is moved during a drag operation.javax.faces.event.AjaxBehaviorEvent
slideEndFired when a drag operation is completed by releasing the slider control (default event).javax.faces.event.AjaxBehaviorEvent
Client events can be used with Client Behaviors and the ace:ajax tag.


Tag Information
Tag Classorg.icefaces.ace.component.sliderentry.SliderEntryTag
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

Attributes
NameRequiredRequest-timeTypeDescription
animatenotruebooleanDefines whether or not the slider control will use an animated transition to move to a new location when the user clicks outside handle on the slider rail. Default = 'true'.
axisnotruejava.lang.StringThe orientation that the slider is rendered in, either vertical ('y'), or horizontal ('x'). Default = 'x'.
bindingnotruejavax.el.ValueExpressionUsing an EL expression, bind the component reference to a bean property, so that the component may be accessed in the bean.
clickableRailnotruebooleanDefines whether or not a mouse-click at a location along the slider rail should reposition the slider control to that location (and adjust the value accordingly). Default = 'true'.
disablednotruebooleanDefines whether or not the component is disabled. When disabled='true', this component is unable to receive focus and cannot be interacted with by the user. Default = 'false'.
idnotruejava.lang.StringThe component identifier for this component. This value must be unique within the closest parent component that is a naming container.
immediatenotruebooleanDefines whether or not conversion and validation of this component's value should occur during Apply Request Values phase instead of Process Validations phase. Default = 'false'.
lengthnotruejava.lang.StringThe length of slider bar.Note: If the range of the slider (max-min) is greater than the length, then the slider can not accurately represent every value in the range. If the discrepancy is too great, then arrow key stepping may not precisely reflect the stepPercent property. Default = '150px'.
maxnotrueintThe maximum int value that can be selected in the value-entry range represented by the slider bar. Default = '100'.
minnotrueintThe minimum int value that can be selected in the value-entry range represented by the slider bar. Default = '0'.
onSlidenotruejava.lang.StringThis event is fired each time the the slider control is moved during a drag operation.
onSlideEndnotruejava.lang.StringThis event is fired when a drag operation is completed by releasing the slider control.
onSlideStartnotruejava.lang.StringThis event is fired when a drag operation on the slider control is initiated.
renderednotruebooleanReturn true if this component (and its children) should be rendered during the Render Response phase of the request processing lifecycle. Default = 'true'.
showLabelsnotruebooleanDefines whether or not labels for the min and max values should be rendered at the ends of the rail. Default = 'false'.
stepPercentnotruefloatThe amount to move the slider position in response to keyboard arrow-key input. This float value represents a percentage of the value-entry range defined by the min and max attributes. For example, with min='0', max='50', and stepPercent='10', each arrow keypress will increment/decrement the slider value by 5 (10% of 50). Default = '1f'.
stylenotruejava.lang.StringCustom inline CSS styles to use for this component. These styles are generally applied to the root DOM element of the component. This is intended for per-component basic style customizations. Note that due to browser CSS precedence rules, CSS rendered on a DOM element will take precedence over the external stylesheets used to provide the ThemeRoller theme on this component. If the CSS properties applied with this attribute do not affect the DOM element you want to style, you may need to create a custom theme styleClass for the theme CSS class that targets the particular DOM elements you wish to customize.
styleClassnotruejava.lang.StringCustom CSS style class(es) to use for this component. These style classes can be defined in your page or in a theme CSS file.
tabindexnotruejava.lang.IntegerThe browser tabindex (int) of the component.
valuenotrueintThe value of the slider control. Default = '0'.
valueChangeListenernotruejavax.el.MethodExpressionMethodExpression representing a value change listener method that will be notified when a new value has been set for this input component. The expression must evaluate to a public method that takes a ValueChangeEvent parameter, with a return type of void, or to a public method that takes no arguments with a return type of void. In the latter case, the method has no way of easily knowing what the new value is, but this can be useful in cases where a notification is needed that "this value changed".
widgetVarnotruejava.lang.StringThe JavaScript object name that implements the client-side JavaScript API for this component.

Variables
No Variables Defined.


Output Generated by Tag Library Documentation Generator. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-4 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.