PasswordTextBox — Smart UI JavaScript API
On this page + Quick start
Quick start · JavaScript
Complete starter source per framework. Run the scaffold/install command first, then replace the listed files with the full code below.
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>PasswordTextBox - JavaScript Quick Start</title>
<link rel="stylesheet" href="./node_modules/smart-webcomponents/source/styles/smart.default.css" />
</head>
<body>
<smart-password-text-box id="demo-passwordtextbox"></smart-password-text-box>
<script type="module">
import './node_modules/smart-webcomponents/source/modules/smart.passwordtextbox.js';
const el = document.getElementById('demo-passwordtextbox');
if (el) {
el.placeholder = 'Your password';
el.showPasswordIcon = true;
el.value = 'P@ssw0rd!';
el.addEventListener('change', (event) => console.log('change:', event.detail || event));
}
</script>
</body>
</html>
For AI tooling
Developer Quick Reference
Component: PasswordTextBox Framework: JavaScript Selector: smart-password-text-box
API counts: 28 properties, 2 methods, 2 events
Common properties: 0, 1, 2, 3, 4, 5
Common methods: focus(), reset()
Common events: change, changing
Module hint: smart-webcomponents/source/modules/smart.passwordtextbox.js
PasswordTextBox lets the user enter a password with the text hidden.
Class
PasswordTextBox
PasswordTextBox lets the user enter a password with the text hidden.
Selector
smart-password-text-box
Properties
AanimationSpecifies or retrieves the current animation mode. When set to 'none', all animations are disabled. If set to any other supported value, animations will be enabled according to the specified mode.
AautoFocusIndicates that the element will automatically receive keyboard focus as soon as the page is loaded, allowing users to interact with it immediately without clicking or tabbing to it. This is often used to improve accessibility and streamline user interaction with form fields or interactive elements.
DdisabledDetermines whether the element is interactive or inactive. When enabled, users can interact with the element; when disabled, the element becomes unresponsive to user actions such as clicks or input.
EenterKeyBehaviorDefines the action that occurs when the "Enter" key is pressed within the input field. By default, the mode is set to "submit", meaning pressing "Enter" will attempt to submit the associated form. You can customize this behavior by specifying alternative modes, such as preventing form submission or triggering a custom handler.
FformSpecifies the form element with which this element is associated (referred to as its "form owner"). The value of this attribute should be the id of a
HhintDisplays supplemental helper text beneath the element, visible only while the element is focused. This text provides additional guidance or context to users during interaction.
LlabelDisplays a label positioned above the input element. This label remains persistently visible, providing a clear and accessible description of the input’s purpose at all times.
LlocaleSpecifies or retrieves the current language setting. This property determines which set of localized text strings from the messages property is used for display. When you set the language, the corresponding messages are shown to users in that language. When you get the language, it returns the currently active language code.
LlocalizeFormatFunctionCallback function that allows you to customize the formatting of messages returned by the Localization Module. This enables you to modify or enhance localized message strings—such as adding dynamic data, adjusting placeholders, or changing text structure—before they are displayed to users.
MmaxLengthSpecifies or retrieves the maximum number of characters allowed in the input field. If set, the user cannot enter more characters than this limit. This constraint helps enforce data validation and control the input length.
MmessagesDefines an object where each property corresponds to a specific password strength state, with associated string values that describe or label each state (e.g., "weak," "moderate," "strong"). This object is typically used to display feedback messages or labels reflecting the current strength of a user's password during input.
MminLengthSpecifies or retrieves the minimum number of characters required for user input. When set, the user must enter at least this many characters for the input to be considered valid.
NnameSets or retrieves the value of the element's name attribute. The name attribute is used to identify form fields when submitting HTML forms, allowing the data entered in the element to be included in the form's submission with the specified name as the key. This is essential for server-side processing of form data.
PpasswordStrengthWith this property, you can specify a custom callback function that evaluates the strength of a password. The function should accept the current password as input and return a string representing the assessed strength level. The returned string must be one of the following predefined values: 'short', 'weak', 'far', 'good', or 'strong'. This value will be used by the component to indicate how secure the entered password is according to your custom logic.
PplaceholderThis is the text that appears within the element when it is empty, serving as a prompt or hint to the user about the expected input. Once the user enters a value, this placeholder text disappears.
RrequiredEnhances the requirement that the user must provide a value for this element before the form can be submitted. If this field is left empty, the form submission will be blocked and the user will be prompted to enter a value. This ensures that the input is mandatory, helping maintain data completeness and integrity.
RrightToLeftSets or retrieves a value specifying whether the element’s alignment is adjusted to support right-to-left (RTL) languages, such as Arabic or Hebrew. When enabled, the element’s content and layout are adapted for proper display in locales that use right-to-left text direction.
SselectAllOnFocusDetermines if the entire content of the input field should be automatically highlighted (selected) when the input receives focus, making it easier for users to quickly replace or copy the content.
SshowPasswordIconSpecifies whether the password icon (such as an eye symbol to show or hide password text) is displayed in the input field.
SshowPasswordStrengthSpecifies whether a tooltip displaying the password strength indicator will be visible to the user during password entry. When enabled, this tooltip provides real-time feedback on the strength of the entered password.
TthemeSpecifies the visual theme to be applied. The theme controls the overall appearance and style—including colors, fonts, and backgrounds—of the element for a consistent look and feel.
TtooltipArrowSpecifies whether the Tooltip component should display an arrow pointing to the target element. Setting this option to true will show the arrow, while false will hide it.
TtooltipDelaySpecifies the amount of time, in milliseconds, to wait before displaying the tooltip after a user interaction (such as hovering or focusing on an element).
TtooltipPositionSpecifies the placement of the tooltip relative to the target element, such as "top", "bottom", "left", or "right". This controls where the tooltip will appear when it is displayed.
TtooltipTemplateSpecifies a custom template for rendering the tooltip’s content, allowing you to define the layout, formatting, and dynamic data within the tooltip. This enables greater control over the appearance and behavior of the tooltip beyond the default content.
UunfocusableIndicates whether the element should be excluded from keyboard navigation and cannot receive focus. If set to true, users will not be able to focus on the element using the keyboard or mouse interactions.
UunlockKeyGets or sets the unlockKey, a unique key required to activate and access the product. Use this property to retrieve the current unlock key or assign a new one to enable product unlocking functionality.
VvalueSets a new value for the element or retrieves its current value, depending on whether an argument is provided. Useful for updating or accessing the element’s data within a form or component.
Events
CchangeThis event is triggered whenever the value of the element is modified by the user or through programmatic changes. It occurs after the change has been committed, allowing you to respond to updates in the element’s value.
CchangingThis event is triggered whenever a key is released (key up) within the TextBox, but only if the TextBox's value has changed as a result of the key press. This ensures that the event fires solely when user input modifies the content, preventing unnecessary triggers when the value remains unchanged.
Methods
FfocusSets keyboard focus to the specified element, making it the active element on the page and enabling user input or interaction through the keyboard. This is commonly used to improve accessibility, guide user workflow, or trigger specific UI behaviors.
RresetThis method resets the input field to its initial value, discarding any changes made by the user and restoring the input's original state as specified when the component or element was first rendered.
Properties
animationSpecifies or retrieves the current animation mode. When set to 'none', all animations are disabled. If set to any other supported value, animations will be enabled according to the specified mode."none" | "simple" | "advanced"
Specifies or retrieves the current animation mode. When set to 'none', all animations are disabled. If set to any other supported value, animations will be enabled according to the specified mode.
Allowed Values
- "none" - animation is disabled
- "simple" - ripple animation is disabled
- "advanced" - all animations are enabled
Default value
"advanced"Examples
Markup and runtime examples for animation:
HTML:
<smart-password-text-box animation="none"></smart-password-text-box>
Vanilla JS — prefer #id if multiple widgets exist on the page:
const el = document.querySelector('smart-password-text-box');
el.animation = "simple";Read the current value:
const el = document.querySelector('smart-password-text-box');
const animation = el.animation;
autoFocusIndicates that the element will automatically receive keyboard focus as soon as the page is loaded, allowing users to interact with it immediately without clicking or tabbing to it. This is often used to improve accessibility and streamline user interaction with form fields or interactive elements.boolean
Indicates that the element will automatically receive keyboard focus as soon as the page is loaded, allowing users to interact with it immediately without clicking or tabbing to it. This is often used to improve accessibility and streamline user interaction with form fields or interactive elements.
Default value
falseExamples
Markup and runtime examples for autoFocus:
HTML attribute:
<smart-password-text-box auto-focus></smart-password-text-box>
Vanilla JS — prefer #id if multiple widgets exist on the page:
const el = document.querySelector('smart-password-text-box');
el.autoFocus = false;Read the current value:
const el = document.querySelector('smart-password-text-box');
const autoFocus = el.autoFocus;
disabledDetermines whether the element is interactive or inactive. When enabled, users can interact with the element; when disabled, the element becomes unresponsive to user actions such as clicks or input.boolean
Determines whether the element is interactive or inactive. When enabled, users can interact with the element; when disabled, the element becomes unresponsive to user actions such as clicks or input.
Default value
falseExamples
Markup and runtime examples for disabled:
HTML attribute:
<smart-password-text-box disabled></smart-password-text-box>
Vanilla JS — prefer #id if multiple widgets exist on the page:
const el = document.querySelector('smart-password-text-box');
el.disabled = false;Read the current value:
const el = document.querySelector('smart-password-text-box');
const disabled = el.disabled;
enterKeyBehaviorDefines the action that occurs when the "Enter" key is pressed within the input field. By default, the mode is set to "submit", meaning pressing "Enter" will attempt to submit the associated form. You can customize this behavior by specifying alternative modes, such as preventing form submission or triggering a custom handler."clearOnSubmit" | "submit"
Defines the action that occurs when the "Enter" key is pressed within the input field. By default, the mode is set to "submit", meaning pressing "Enter" will attempt to submit the associated form. You can customize this behavior by specifying alternative modes, such as preventing form submission or triggering a custom handler.
Allowed Values
- "clearOnSubmit" - Clears the value of the input on Submit.
- "submit" - Submits the value of the input but doesn't clear it.
Default value
"submit"Examples
Markup and runtime examples for enterKeyBehavior:
HTML:
<smart-password-text-box enter-key-behavior="newLine"></smart-password-text-box>
Vanilla JS — prefer #id if multiple widgets exist on the page:
const el = document.querySelector('smart-password-text-box');
el.enterKeyBehavior = "submit";Read the current value:
const el = document.querySelector('smart-password-text-box');
const enterKeyBehavior = el.enterKeyBehavior;
formSpecifies the form element with which this element is associated (referred to as its "form owner"). The value of this attribute should be the id of a string
Specifies the form element with which this element is associated (referred to as its "form owner"). The value of this attribute should be the id of a