jQuery UI spinner widgets are used to add a up/down arrow to the input box thus allowing the user to increase and decrease the value in the input box. It facilitates the users to type a value directly, or modify an existing value by spinning with the keyboard, mouse or scrollwheel.
It has also some extended features like:
- It facilitates you to skip values.
- It also enables globalized formatting options (i.e. currency, decimals, thousand separators etc.)
Syntax:
You can use spinner () method in two forms:
First Method
The spinner (options) method specifies that an HTML element and its contents should be treated and managed as spinner. Here ?options? parameter is an object that specifies the appearance and behavior of the spinner elements involved.
You can use one or more options at a time using JavaScript object. In the case of more than one option, you have to separate them using a comma as follows:
Following is a list of different options that can be used with this method:
Option | Description |
---|---|
culture | This option sets the culture to use for parsing and formatting the value. By default its value is null which means the currently set culture in globalize is used. |
disabled | If you set this option to true, it disables spinner. By default its value is false. |
icons | This option is used to set icons to use for buttons, matching an icon provided by the jQueryUI CSS framework. By default its value is { down: "ui-icon-triangle-1-s", up: "ui-icon-triangle-1-n" } . |
incremental | This option controls the number of steps taken when holding down a spin button. By default its value is true. |
max | This option is used to identify the maximum allowed value. By default its value is null which means there is no maximum enforced. |
min | This option is used to identify the minimum allowed value. By default its value is null which means there is no minimum enforced. |
numberFormat | This option specifies a format of numbers passed to globalize, if available. Most common are "n" for a decimal number and "c" for a currency value. By default its value is null. |
page | This option indicates the number of steps to take when paging via the pageup/pagedown methods. By default its value is 10. |
step | This option specifies the size of the step to take when spinning via buttons or via the stepup()/stepdown() methods. The element's step attribute is used if it exists and the option is not explicitly set. |
jQuery UI spinner example 1
With no parameter to the spinner() method:
Let's take a simple example to demonstrate spinner widget functionality, passing no parameter to the spinner() method.
jQuery UI spinner example 2
Use of min, max and step options:
Let's take an example to demonstrate the usage of options min, max and step in the spinner widget of jQueryUI.
Second Method
The spinner ("action", params) method is used to perform an action on spinner elements, such as enabling/disabling the spinner. The action is specified as a string in the first argument (e.g., "disable" disables the spinner).
Following is a list of different actions that can be used with this method:
Action | Description |
---|---|
destroy | This action is used to destroy the spinner functionality of an element completely and the elements return to their pre-init state. This method does not accept any arguments. |
disable | This action is used to disable the spinner functionality. This method does not accept any arguments. |
enable | This action is used to enable the spinner functionality. This method does not accept any arguments. |
option( optionName ) | This action gets the value currently associated with the specified optionName. Here optionName is the name of the option to get. |
option | This action gets an object containing key/value pairs representing the current spinner options hash. This method does not accept any arguments. |
option(optionName, value) | This action sets the value of the spinner option associated with the specified optionName. |
option(options) | this action sets one or more options for the spinner. |
pageDown( [pages ] ) | This action decrements the value by the specified number of pages, as defined by the page option. |
pageUp( [pages ] ) | This action increments the value by the specified number of pages, as defined by the page option. |
stepDown( [steps ] ) | This action is used to decrement the value by the specified number of steps. |
stepUp( [steps ] ) | This action increments the value by the specified number of steps. |
value | This action gets the current value as a number. The value is parsed based on the numberFormat and culture options. This method does not accept any arguments. |
value(value) | This action is used to set the value. |
widget | This action is used to return the spinner widget element; the one annotated with the UI-spinner class name. |
jQueryUI spinner() example 3
Use of stepUp, stepDown, pageUp and pageDown:
Let's take an example to demonstrate the use of stepUp, stepDown, pageUp and pageDown method:
jQueryUI spinner() example 4
Use of action enable and disable:
Let's take an example to demonstrate the use of action enable and disable:
No comments:
Post a Comment