Overview

A widget that allows users to securely input a password with customizable placeholder, validation messages, and actions triggered on value change.

Documentation

Typical Usage Scenario

The Password Input Widget is designed to securely capture user passwords in Mendix applications. It can be used in login forms, registration pages, or any scenario requiring secure password entry. By providing a customizable placeholder, validation messages, and change actions, this widget enhances user experience and ensures data integrity.

Problems Solved:

• Secure password entry: Hides the input to protect sensitive information.
• Validation: Ensures users do not submit empty passwords.
• Customizability: Allows developers to set placeholders, captions, and validation messages tailored to their application's needs.

Use Cases:

• User authentication forms
• Password change or reset forms
• Any form requiring secure user input

Features and Limitations

Features

• Secure Input: Masks the password input to protect sensitive information.
• Customizable Placeholder: Guides users with a placeholder text when the field is empty.
• Caption: Adds a caption above the input field for better context.
• Validation Message: Displays a custom validation message when the password field is left empty.
• On Change Action: Triggers specified actions when the input value changes, enhancing interactivity and data handling.
• Styling Options: Customizable appearance to match the application's design.

Limitations

• Fixed Validation Logic: Validation logic is limited to checking for non-empty values; complex validation rules need additional custom logic.

Installation [Optional]

1. Download the Widget:
   • Obtain the Password Input Widget from the Mendix Marketplace.
2. Import the Widget:
   • Open your Mendix project.
   • Go to the App Explorer, right-click on Widgets, and select Import widget.
   • Navigate to the downloaded widget file and import it.
3. Add to Page:
   • Drag and drop the Password Input Widget onto the desired page in your Mendix project.

Configuration [Optional]

1. Set Placeholder:
   • Click on the widget and set the placeholder text in the properties panel.
2. Bind Attribute:
   • Select the attribute where the password will be stored.
3. Set Caption:
   • Enter the desired caption text.
4. Configure Validation Message:
   • Enter the validation message to be displayed if the field is empty.
5. Define On Change Action:
   • Select the action to be triggered when the password input changes (e.g., call a Nanoflow or Microflow).

Known Bugs [Optional]

• Validation Message Display: In some rare cases, the validation message may not display correctly if the placeholder text is too long. Ensure the placeholder is concise.

Frequently Asked Questions [Optional]

Q: Can I use this widget for fields other than passwords? A: While it's designed for passwords, you can use it for any text input that requires masking.

Q: How do I handle complex validation rules? A: For complex validation, use a custom Nanoflow or Microflow triggered by the On Change action.

Q: Can I style the widget to match my application’s theme? A: Yes, you can use the Appearance tab to customize the widget's look and feel.

This documentation provides a comprehensive guide for integrating and using the Password Input Widget in Mendix applications, ensuring a smooth and secure user experience.