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.

  $('#jqxPasswordInput').jqxPasswordInput({ theme: "energyblue" });

Gets or sets the widget's width. The value may be "auto", a number or a string like "Npx", where N is a number.

Code example

Initialize a jqxPasswordInput with the width property specified.

$('#jqxPasswordInput').jqxPasswordInput({ width: "150px" }); 

Gets or sets the widget's height. The value may be "auto", a number or a string like "Npx", where N is a number.

Code example

Initialize a jqxPasswordInput with the height property specified.

$('#jqxPasswordInput').jqxPasswordInput({ height: 25 }); 

Gets or sets whether the widget is disabled.

Code example

Initialize a jqxPasswordInput with the disabled property specified.

$('#jqxPasswordInput').jqxPasswordInput({ disabled: true }); 

Gets or sets the password input's placeholder text.

Code example

Initialize the widget with the placeHolder property specified.

$('#jqxPasswordInput').jqxPasswordInput({ placeHolder: "Enter password:" });

Gets or sets the maximal number of characters in the password.

Code example

Initialize a jqxPasswordInput with the maxLength property specified.

$('#jqxPasswordInput').jqxPasswordInput({ maxLength: "none" }); 

Gets or sets whether the Show/Hide password icon will appear.

Code example

Initialize a jqxPasswordInput with the showPasswordIcon property specified.

$('#jqxPasswordInput').jqxPasswordInput({ showPasswordIcon: false }); 

(Requires jqxtooltip.js.)

Gets or sets whether a tooltip which shows the password's strength will be shown.

Code example

Initialize a jqxPasswordInput with the showStrength property specified.

$('#jqxPasswordInput').jqxPasswordInput({ showStrength: true }); 

(Requires jqxtooltip.js.)

Gets or sets the position of the tooltip which shows the password strength.
Possible values:

• "top"
• "bottom"
• "left"
• "right"

Note: The property showStrength should be set to true for showStrengthPosition to have an effect.

Code example

Initialize a jqxNavigationBar with the showStrengthPosition property specified.

$('#jqxPasswordInput').jqxPasswordInput({ showStrengthPosition: "none" });
                        

(Requires jqxtooltip.js.)

A callback function for defining a custom strength rule. The function has three parameters:

• First parameter - the value of the password.
• Second parameter - an object containing the numbers of different types of characters - letters, numbers and special keys.
• Third parameter - the default strength value, based on the built-in rule.

Note: The property showStrength should be set to true for passwordStrength to have an effect.

Code example

Initialize a jqxPasswordInput with the passwordStrength property specified.

$("#jqxPasswordInput").jqxPasswordInput({ showStrength: true, passwordStrength: function (password, characters, defaultStrength) {
                var length = password.length;
                var letters = characters.letters;
                var numbers = characters.numbers;
                var specialKeys = characters.specialKeys;
                var strengthCoefficient = letters + numbers + 2 * specialKeys + letters * numbers * specialKeys;
                var strengthValue;
                if (length < 4) {
                    strengthValue = "Too short";
                } else if (strengthCoefficient < 10) {
                    strengthValue = "Weak";
                } else if (strengthCoefficient < 20) {
                    strengthValue = "Fair";
                } else if (strengthCoefficient < 30) {
                    strengthValue = "Good";
                } else {
                    strengthValue = "Strong";
                };
                return strengthValue;
            }
            });

(Requires jqxtooltip.js.)

A callback function for custom rendering of the tooltip which shows the password strength. The function has three parameters:

• First parameter - the value of the password.
• Second parameter - an object containing the numbers of different types of characters - letters, numbers and special keys.
• Third parameter - the default strength value, based on the built-in rule.

Note: The property showStrength should be set to true for strengthTypeRenderer to have an effect.

Code example

Initialize a jqxPasswordInput with the strengthTypeRenderer property specified.

$("#jqxPasswordInput").jqxPasswordInput({ showStrength: true, strengthTypeRenderer: function (password, characters, defaultStrength) {
                var length = password.length;
                var letters = characters.letters;
                var numbers = characters.numbers;
                var specialKeys = characters.specialKeys;
                var strengthCoefficient = letters + numbers + 2 * specialKeys + letters * numbers / 2 + length;
                var strengthValue;
                var color;
                if (length < 8) {
                    strengthValue = "Too short";
                    color = "rgb(170, 0, 51)";
                } else if (strengthCoefficient < 20) {
                    strengthValue = "Weak";
                    color = "rgb(170, 0, 51)";
                } else if (strengthCoefficient < 30) {
                    strengthValue = "Fair";
                    color = "rgb(255, 204, 51)";
                } else if (strengthCoefficient < 40) {
                    strengthValue = "Good";
                    color = "rgb(45, 152, 243)";
                } else {
                    strengthValue = "Strong";
                    color = "rgb(118, 194, 97)";
                };
                return "<div style='color: " + color + ";'>" + strengthValue + "</div>";
            }
            });

Determines whether the right-to-left support is enabled.

Code example

Initialize a jqxPasswordInput with the rtl property specified.

$('#jqxPasswordInput').jqxPasswordInput({ rtl: true }); 

Sets the various text values used in the widget. Useful for localization.

Default value:

{ passwordStrengthString: "Password strength", tooShort: "Too short", weak: "Weak", fair: "Fair", good: "Good", strong: "Strong" }

Code example

Initialize a jqxPasswordInput with the localization property specified.

$('#jqxPasswordInput').jqxPasswordInput({ localization: { passwordStrengthString: "חוזק סיסמא", tooShort: "קצר מדי", weak: "חלש", fair: "הוגן", good: "טוב", strong: "חזק"} });
                        

Sets the the colors used in the tooltip which shows the strength.

Default value:

{ tooShort: "rgb(170, 0, 51)", weak: "rgb(170, 0, 51)", fair: "rgb(255, 204, 51)", good: "rgb(45, 152, 243)", strong: "rgb(118, 194, 97)" }

Code example

Initialize a jqxPasswordInput with the strengthColors property specified.

$('#jqxPasswordInput').jqxPasswordInput({ strengthColors: { tooShort: "Red", weak: "Red", fair: "Yellow", good: "Blue", strong: "Green" } }); 

This event is triggered when the value in the input is changed.

Code example

Bind to the change event by type: jqxPasswordInput.

$('#jqxPasswordInput').on('change', function () { // Some code here.}); 

Renders the widget.

Code example

Invoke the render method.

$('#jqxPasswordInput').jqxPasswordInput('render'); 

Refreshes the widget.

Code example

Invoke the refresh method.

$('#jqxPasswordInput').jqxPasswordInput('refresh'); 

Gets or sets the password. If the parameter is set, sets the value of the password in the input. If there is no parameter set, returns the string value of the password.

Code example

Invoke the val method.

// @param String. The new value of the password.
$('#jqxPasswordInput').jqxPasswordInput('val', "New password");

or

var password = $('#jqxPasswordInput').jqxPasswordInput('val');