# `m-password-input`

A password input is a specialized input field used to securely enter and manage passwords. It typically masks the characters entered to protect sensitive information from being seen. It includes a toggle button to show or hide the password, improving usability while maintaining security. Password inputs are commonly used in login forms, account creation, and authentication flows.

## Props

| Name | Description | Type | Default |
|------|-------------|------|---------|
| `id*` | A unique identifier for the password input element, used to associate the label with the form element. | `string` |   |
| `name` | The name attribute for the password input element, typically used for form submission. | `string` |   |
| `value` | The current value of the password input field. | `string` `number` | `$bindable()` |
| `placeholder` | A placeholder text to show in the password input when it is empty. | `string` |   |
| `isinvalid` | If `true`, applies an invalid state to the password input. | `boolean` |   |
| `disabled` | If `true`, disables the password input, making it non-interactive. | `boolean` |   |
| `readonly` | If `true`, the password input is read-only (cannot be edited). | `boolean` |   |
| `isclearable` | If `true`, a clear button will appear when the password input has a value. | `boolean` |   |
| `clearlabel` | The label text for the clear button. | `string` | `Clear content` |
| `buttonlabel` | Labels of the button displayed when showing or hiding the password. | `{ show: string; hide: string; }` | `{ show: 'Show', hide: 'Hide' }` |

