Spinner
Guide for using Spinner in your applications
Last updated
Was this helpful?
Guide for using Spinner in your applications
Last updated
Was this helpful?
This guide will show how to use a Spinner in your applications. A spinner can be used to select a value from a predefined set of values, which are usually presented in a valuelist. See how easy it is to drag and drop spinners onto your forms and connect them to your business logic. Spinner can be modified, styled and even changed at runtime.
To see a live sample of the component you can go .
In the , drag the Spinner component from the Pallet onto the form.
Spinners, like all components, have properties which can be modified at design-time to set the appearance and behavior of the component. Select the spinner in the to see a list of properties in the . Below are some common properties and how to set them at design-time.
The possible values of the spinner are the ones in the valuelist that is related to the component To select the valuelist just enter the name of the desired valuelist on the valuelist property of the spinner. More information about valuelists can be found .
Spinner, like many components, can display tooltip messages when a user hovers their cursor. Most often, this will just be plain text that describes what will happen on-click. In this case, just enter the value into the editor. For more options open the .
Like all components, a spinner can be styled using themes, variants and raw CSS. To apply any available style class, simply enter one or more space-delimited values for the styleClass property.
Like most components, spinners have events, which allow you to execute some logic when something happens in the UI. Of course, the most common event for a spinners is the onDataChange event, which is triggered when the value is changed.
Spinner, like many components, can be modified at runtime through code. Below are a few examples of controlling a spinner from code.
You can easily change the enabled state of a spinner at runtime.
You can easily change the visible state of a spinner at runtime.
Like most components, a spinner has API methods which can be called from code. Below is an example of common API calls.
You can easily add a style class to a spinner using the addStyleClass method.
The following articles are recommended for additional reading:
Remember that text can also be dynamic, data-driven or localized. For more options, you can open edit the text property in the .
To Handle the event, double-click the value for the onDataChange property in the . You will see the . You'll have the option select an existing Method or create a new Method. The method will be called when the button's onDataChange event is fired and the object will be passed to it.
See the for comprehensive list of
You can easily give keyboard focus to a spinner using the method.