Laf-Widget client properties

View all client properties.

Client property name



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.JCheckBox;
import javax.swing.JFrame;
import javax.swing.JLabel;
import javax.swing.JPanel;
import javax.swing.JPasswordField;
import javax.swing.SwingUtilities;

import org.pushingpixels.lafwidget.LafWidget;
import org.pushingpixels.lafwidget.text.PasswordStrengthChecker;
import org.pushingpixels.lafwidget.utils.LafConstants.PasswordStrength;
import org.pushingpixels.substance.api.SubstanceLookAndFeel;

 * Test application that shows the use of the
 {@link LafWidget#PASSWORD_STRENGTH_CHECKER} client property.
 @author Kirill Grouchnikov
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();
    panel.add(new JLabel("Start typing password"));

    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()) {
              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 {

    this.add(controls, BorderLayout.SOUTH);


   * The main method for <code>this</code> sample. The arguments are ignored.
   @param args
   *            Ignored.
  public static void main(String[] args) {
    SwingUtilities.invokeLater(new Runnable() {
      public void run() {
        SubstanceLookAndFeel.setSkin(new BusinessBlackSteelSkin());
        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):