README.md

🔒🔍 strengthify

Combine jQuery and zxcvbn to create a password strength meter.

How to use

As of 0.5.0, the wrapper will be automatically added beneath the target input field

Add jquery (tested with 1.10.0), jquery.strengthify.js and strengthify.css to your document.

If using the message option, include bootstrap.

If using the titles option, include bootstrap's tooltip.js,

<script src="jquery-1.10.0.min.js"></script>
<script src="tooltip.js"></script>
<script src="jquery.strengthify.js"></script>
<link rel="stylesheet" href="bootstrap.min.css" type="text/css">
<link rel="stylesheet" href="strengthify.css" type="text/css">

Because zxcvbn is really heavyweight, it will be loaded asynchronously from zxcvbn/zxcvbn.js. This can however be configured with an optional parameter.

Then call .strengthify on the password input field.

$('#password-field').strengthify()

That's it. Now the password strength meter will be updated after each keystroke.

Configuration

The path and the title of the different strength categories can be configured with the first parameter of .strengthify.

drawTitles

pop-up text (above)

drawMessage

detailed message beneath input

drawBars

password strength color progression bars beneath input

Default:

{
  "zxcvbn": "zxcvbn/zxcvbn.js",
  "titles": [
    "Weakest",
    "Weak",
    "So-so",
    "Good",
    "Perfect"
  ],
  "drawTitles": false,
  "drawMessage": false,
  "drawBars": true
}

Overwrite example:

$('#password-field').strengthify({zxcvbn: 'my/path/to/zxcvbn.js'})

Versions

0.5.0

fairly substantial changes:

• added feedback message
• $.each(...) functionality
• restructuring wrapping
• feature flags

"strengthify-wrapper" added automatically beneath target input

0.4.1

hotfix for missing ;

0.4

syntax and performance cleanups

0.3

some fixes:

• migrate from "display" to "opacity"
• fix pasting to input field
• add tipsy with strength

0.2

solve mimetype issues

0.1

Initial version