Laf-Widget - documentation
Author: laf-widget.dev.java.net
Description: Laf-Widget
Keywords: java, look, feel, skins, plaf, swing, ui, pluggable, widget

# Laf-Widget client properties

View all client properties.

Client property name | LafWidget.PASSWORD_STRENGTH_CHECKER
Description | Client property name for specifying password strength checker for a password field. The value should be an instance of `PasswordStrengthChecker`, otherwise will be ignored. This property must be set on a specific `JPasswordField`.
See also |
Sample code | `import java.awt.BorderLayout; import java.awt.FlowLayout; import java.awt.event.ActionEvent; import java.awt.event.ActionListener; import javax.swing.*; import org.jvnet.lafwidget.LafWidget; import org.jvnet.lafwidget.text.PasswordStrengthChecker; import org.jvnet.lafwidget.utils.LafConstants.PasswordStrength; import org.jvnet.substance.SubstanceLookAndFeel; /** * Test application that shows the use of the * {@link LafWidget#PASSWORD_STRENGTH_CHECKER} client property. * * @author Kirill Grouchnikov * @see LafWidget#PASSWORD_STRENGTH_CHECKER */ public class PasswordStrengthCheckerProperty extends JFrame { /** * Creates the main frame for <code>this</code> sample. */ public PasswordStrengthCheckerProperty() { super("Password strength checker"); this.setLayout(new BorderLayout()); final JPanel panel = new JPanel(new FlowLayout()); this.add(panel, BorderLayout.CENTER); final JPasswordField jpf = new JPasswordField(); jpf.setColumns(20); panel.add(new JLabel("Start typing password")); panel.add(jpf); JPanel controls = new JPanel(new FlowLayout(FlowLayout.RIGHT)); final JCheckBox hasPasswordStrengthChecker = new JCheckBox( "Has password strength checker"); hasPasswordStrengthChecker.addActionListener(new ActionListener() { public void actionPerformed(ActionEvent e) { if (hasPasswordStrengthChecker.isSelected()) { jpf.putClientProperty(LafWidget.PASSWORD_STRENGTH_CHECKER, new PasswordStrengthChecker() { public PasswordStrength getStrength( char[] password) { if (password == null) return PasswordStrength.WEAK; int length = password.length; if (length < 3) return PasswordStrength.WEAK; if (length < 6) return PasswordStrength.MEDIUM; return PasswordStrength.STRONG; } public String getDescription( PasswordStrength strength) { if (strength == PasswordStrength.WEAK) return "<html>This password is <b>way</b> too weak</html>"; if (strength == PasswordStrength.MEDIUM) return "<html>Come on, you can do<br> a little better than that</html>"; if (strength == PasswordStrength.STRONG) return "OK"; return null; } }); } else { jpf.putClientProperty(LafWidget.PASSWORD_STRENGTH_CHECKER, null); } } }); controls.add(hasPasswordStrengthChecker); this.add(controls, BorderLayout.SOUTH); this.setSize(400, 200); this.setLocationRelativeTo(null); this.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); } /** * The main method for <code>this</code> sample. The arguments are * ignored. * * @param args * Ignored. * @throws Exception * If some exception occured. Note that there is no special * treatment of exception conditions in <code>this</code> * sample code. */ public static void main(String[] args) throws Exception { UIManager.setLookAndFeel(new SubstanceLookAndFeel()); JFrame.setDefaultLookAndFeelDecorated(true); SwingUtilities.invokeLater(new Runnable() { public void run() { new PasswordStrengthCheckerProperty().setVisible(true); } }); } }` The screenshot below shows a password field with few typed characters when this property is not installed: After installing this property on the password field, it has the password strength indication ribbon and the corresponding tooltip (the mouse is over the password field):