## Properties

Name | Type | Default
--- | --- | ---
allowNull | Boolean | true
Determines whether the widget's value could be null. #### Code example Set the `allowNull` property.
    $('#jqxNumberInput').jqxNumberInput({allowNull: false});
Get the `allowNull` property.
    var allowNull = $('#jqxNumberInput').jqxNumberInput('allowNull');
Try it: allowNull is set to false
decimal | Number | 0
Sets or gets the input's number. #### Code examples Set the `decimal` property.
    $("#jqxNumberInput").jqxNumberInput({ decimal: 5 })
Get the `decimal` property.
    var decimal = $('#jqxNumberInput').jqxNumberInput('decimal');
Try it: decimal is set to 2
disabled | Boolean | false
Determines whether jqxNumberInput is disabled. #### Code examples Set the `disabled` property.
    $("#jqxNumberInput").jqxNumberInput({ disabled: true })
Get the `disabled` property.
    var disabled = $('#jqxNumberInput').jqxNumberInput('disabled');
Try it: disabled is set to true
decimalDigits | Number | 2
Indicates the number of decimal places to use in numeric values. #### Code examples Set the `decimalDigits` property.
    $("#jqxNumberInput").jqxNumberInput({ decimalDigits: 3 })
Get the `decimalDigits` property.
    var decimalDigits = $('#jqxNumberInput').jqxNumberInput('decimalDigits');
Try it: decimalDigits is set to 3
decimalSeparator | Char | '.'
Sets or gets the char to use as the decimal separator in numeric values. #### Code examples Set the `decimalSeparator` property.
    $("#jqxNumberInput").jqxNumberInput({ decimalSeparator: "," })
Get the `decimalSeparator` property.
    var decimalSeparator = $('#jqxNumberInput').jqxNumberInput('decimalSeparator');
Try it: decimalSeparator is set to ','
digits | Number | 8
Sets or gets the digits in the input #### Code examples Set the `digits` property.
    $("#jqxNumberInput").jqxNumberInput({ digits: 8})
Get the `digits` property.
    var digits = $('#jqxNumberInput').jqxNumberInput('digits');
Try it: digits is set to 5
groupSeparator | Char | ','
Sets or gets the string that separates groups of digits to the left of the decimal in numeric values. #### Code examples Set the `groupSeparator` property.
    $("#jqxNumberInput").jqxNumberInput({ groupSeparator: "." })
Get the `groupSeparator` property.
    var groupSeparator = $('#jqxNumberInput').jqxNumberInput('groupSeparator');
Try it: groupSeparator is set to '.'
groupSize | Number | 3
Sets or gets the number of digits in each group to the left of the decimal in numeric values. #### Code examples Set the `groupSize` property.
    $("#jqxNumberInput").jqxNumberInput({ groupSize: 5 })
Get the `groupSize` property.
    var groupSize = $('#jqxNumberInput').jqxNumberInput('groupSize');
Try it: groupSize is set to 2
height | Number/String | null
Sets or gets the height of the input in pixels. #### Code examples Set the `height` property.
    $("#jqxNumberInput").jqxNumberInput({ height: '50px' })
Get the `height` property.
    var height = $('#jqxNumberInput').jqxNumberInput('height');
Try it: height is set to '25px'
inputMode | String | 'advanced'
Sets or gets the input's mode. Possible Values:
    'advanced'- the number input behavior resembles a masked input with numeric mask
    'simple'-the  widget works as a normal textbox, but restricts the user's input to numbers
#### Code examples Set the `inputMode` property.
    $("#jqxNumberInput").jqxNumberInput({ inputMode: 'simple' });
Get the `inputMode` property.
    var inputMode = $('#jqxNumberInput').jqxNumberInput('inputMode');
Try it: inputMode is set to 'simple'
min | Number | -99999999
Sets or gets the input's minimum value. #### Code examples Set the `min` property.
    $("#jqxNumberInput").jqxNumberInput({ min: 5 })
Get the `min` property.
    var min = $('#jqxNumberInput').jqxNumberInput('min');
Try it: min is set to 2
max | Number | 99999999
Sets or gets the input's maximum value. #### Code examples Set the `max` property.
    $("#jqxNumberInput").jqxNumberInput({ max: 50 })
Get the `max` property.
    var max = $('#jqxNumberInput').jqxNumberInput('max');
Try it: max is set to 50
negativeSymbol | String | '-'
Sets or gets the string to use as negative symbol. #### Code examples Set the `negativeSymbol` property.
    $("#jqxNumberInput").jqxNumberInput({ negativeSymbol: '-'})
Get the `negativeSymbol` property.
    var negativeSymbol = $('#jqxNumberInput').jqxNumberInput('negativeSymbol');
Try it: symbolPosition is set to '-'
placeHolder | String | ""
Determines the widget's place holder displayed when the widget's value is null. #### Code example Set the `placeHolder` property.
    $('#jqxNumberInput').jqxNumberInput({placeHolder: "Null Value"});
Get the `placeHolder` property.
    var placeHolder = $('#jqxNumberInput').jqxNumberInput('placeHolder');
Try it: placeHolder is set to "Null Value"
promptChar | Char | -
Sets or gets the prompt char displayed when an editable char is empty. Possible Values:
    '_'
    '?'
    ';'
    '#'
#### Code examples Set the `promptChar` property.
    $("#jqxNumberInput").jqxNumberInput({ promptChar: "#" })
Get the `promptChar` property.
    var promptChar = $('#jqxNumberInput').jqxNumberInput('promptChar');
Try it: promptChar is set to '#'
rtl | Boolean | false
Sets or gets a value indicating whether widget's elements are aligned to support locales using right-to-left fonts. #### Code example Set the `rtl` property.
    $('#jqxNumberInput').jqxNumberInput({rtl : true});
Get the `rtl` property.
    var rtl = $('#jqxNumberInput').jqxNumberInput('rtl');
Try it: rtl is set to true
readOnly | Boolean | false
Sets or gets the readOnly state of the input. #### Code examples Set the `readOnly` property.
    $("#jqxNumberInput").jqxNumberInput({ readOnly: true })
Get the `readOnly` property.
    var readOnly = $('#jqxNumberInput').jqxNumberInput('readOnly');
Try it: readOnly is set to true
spinMode | String | 'advanced'
Sets or gets the spin mode. Possible Values:
    'advanced'- the value is increased depending on the caret's position
    'simple'-pecifies that the spin behavior is disabled
#### Code examples Set the `spinMode` property.
    $("#jqxNumberInput").jqxNumberInput({ spinMode: 'simple' });
Get the `spinMode` property.
    var spinMode = $('#jqxNumberInput').jqxNumberInput('spinMode');
Try it: spinMode is set to 'simple'
spinButtons | Boolean | false
Shows or hides the spin buttons. #### Code examples Set the `spinButtons` property.
    $("#jqxNumberInput").jqxNumberInput({ spinButtons: true });
Get the `spinButtons` property.
    var spinButtons = $('#jqxNumberInput').jqxNumberInput('spinButtons');
Try it: spinButtons is set to true
spinButtonsWidth | Number | 18
Sets or gets the width of the spin buttons. #### Code examples Set the `spinButtonsWidth` property.
    $("#jqxNumberInput").jqxNumberInput({ spinButtonsWidth: 20 });
Get the `spinButtonsWidth` property.
    var spinButtonsWidth = $('#jqxNumberInput').jqxNumberInput('spinButtonsWidth');
Try it: spinButtonsWidth is set to 30
spinButtonsStep | Number | 1
Sets or gets the increase/decrease step. #### Code examples Set the `spinButtonsStep` property.
    $("#jqxNumberInput").jqxNumberInput({ spinButtonsStep: 1 });
Get the `spinButtonsStep` property.
    var spinButtonsStep = $('#jqxNumberInput').jqxNumberInput('spinButtonsStep');
Try it: spinButtonsStep is set to 10
symbol | String | ''
Sets or gets the string to use as currency or percentage symbol. #### Code examples Set the `symbol` property.
    $("#jqxNumberInput").jqxNumberInput({ symbol: '$' })
Get the `symbol` property.
    var symbol = $('#jqxNumberInput').jqxNumberInput('symbol');
Try it: symbol is set to '$'
symbolPosition | String | 'left'
Sets or gets the position of the symbol in the input. Possible Values:
    'left'
    'right'
#### Code examples Set the `symbolPosition` property.
    $("#jqxNumberInput").jqxNumberInput({ symbolPosition: 'right'})
Get the `symbolPosition` property.
    var symbolPosition = $('#jqxNumberInput').jqxNumberInput('symbolPosition');
Try it: symbolPosition is set to 'right'
textAlign | String | 'right'
Sets or gets the alignment. #### Code examples Set the `textAlign` property.
    $("#jqxNumberInput").jqxNumberInput({ textAlign: "left" });
Get the `textAlign` property.
    var textAlign = $('#jqxNumberInput').jqxNumberInput('textAlign');
Try it: textAlign is set to 'left'
template | String | 'default'
Determines the template as an alternative of the default styles. Possible Values:
    'default' - the default template. The style depends only on the "theme" property value.
    'primary' - dark blue style for extra visual weight.
    'success' - green style for successful or positive action.
    'warning' - orange style which indicates caution.
    'danger' - red style which indicates a dangerous or negative action.
    'info' - blue button, not tied to a semantic action or use.
#### Code examples Set the `template` property.
    $("#jqxNumberInput").jqxNumberInput({ template: 'primary'});
Get the `template` property.
    var template = $('#jqxNumberInput').jqxNumberInput('template');
Try it: template is set to 'success'
theme | String | ''
- Sets the widget's theme. jQWidgets uses a pair of css files - jqx.base.css and jqx.[theme name].css. The base stylesheet creates the styles related to the widget's layout like margin, padding, border-width, position. The second css file applies the widget's colors and backgrounds. The jqx.base.css should be included before the second CSS file. In order to set a theme, you need to do the following: Include the theme's CSS file after jqx.base.css. The following code example adds the 'energyblue' theme.

      <link rel="stylesheet" href="../../../../jqwidgets/styles/jqx.base.css" type="text/css" />
      <link rel="stylesheet" href="../../../../jqwidgets/styles/jqx.energyblue.css" type="text/css" />
Set the widget's theme property to 'energyblue' when you initialize it. Try it: theme is set to 'energyblue'
width | Number/String | null
Sets or gets the width of the input in pixels. Only positive values have effect. #### Code examples Set the `width` property.
    $("#jqxNumberInput").jqxNumberInput({ width: '250px' })
Get the `width` property.
    var width = $('#jqxNumberInput').jqxNumberInput('width');
Try it: width is set to '250px'
## Events
change | Event |
This event is triggered when the value is changed and the control's focus is lost. #### Code examples Bind to the `change` event by type: jqxNumberInput.
    $('#jqxNumberInput').on('change', function (event)
    {
        var value = event.args.value;
        var type = event.args.type; // keyboard, mouse or null depending on how the value was changed.
    });
Try it: Bind to the change event by type: jqxNumberInput.
textchanged | Event |
This event is triggered when the user entered entered a text. #### Code examples Bind to the `textchanged` event by type: jqxNumberInput.
    $('#jqxNumberInput').on('textchanged', function (event)
    {
        var text = event.args.text;
    });
Try it: Bind to the textchanged event by type: jqxNumberInput.
valueChanged | Event |
This event is triggered after value is changed. #### Code examples Bind to the `valueChanged` event by type: jqxNumberInput.
    $('#jqxNumberInput').on('valueChanged', function (event)
    {
        var value = event.args.value;
    });
Try it: Bind to the valueChanged event by type: jqxNumberInput.
## Methods
clear | Method |
Clears the value.
Parameter | Type | Description
--- | --- | ---
None |  |
Return Value None #### Code examples Invoke the `clear` method.
    $('#jqxNumberInput').jqxNumberInput('clear');
Try it: clears the value in the jqxNumberInput.
destroy | Method |
Destroys the widget.
Parameter | Type | Description
--- | --- | ---
None |  |
Return Value None #### Code examples Invoke the `destroy` method.
    $('#jqxNumberInput').jqxNumberInput('destroy');
Try it: destroys the jqxNumberInput.
focus | Method |
Focuses the widget.
Parameter | Type | Description
--- | --- | ---
None |  |
Return Value None #### Code examples Invoke the `focus` method.
    $('#jqxNumberInput').jqxNumberInput('focus');
Try it: focuses the jqxNumberInput.
getDecimal | Method |
Gets the value.
Parameter | Type | Description
--- | --- | ---
None |  |
Return Value Number #### Code examples Invoke the `getDecimal` method.
    var value = $('#jqxNumberInput').jqxNumberInput('getDecimal');
Try it: gets the decimal in the jqxNumberInput.
setDecimal | Method |
Sets the value.
Parameter | Type | Description
--- | --- | ---
index | Number |
Return Value None #### Code examples Invoke the `setDecimal` method.
    $('#jqxNumberInput').jqxNumberInput('setDecimal', 555);
Try it: sets the decimal in the jqxNumberInput.
val | Method |
Sets or gets the value.
Parameter | Type | Description
--- | --- | ---
value | String |
Return Value String #### Code examples Get the value using the `val` method.
    var value = $('#jqxNumberInput').jqxNumberInput('val');
// Get the value using jQuery's val.
    var value = $('#jqxMaskedInput').val();
Set the value using the `val` method.
    $('#jqxNumberInput').jqxNumberInput('val', 561.23);
// Set the value using jQuery's val.
    $('#jqxNumberInput').val(1242);
Try it: sets the value in the jqxNumberInput.