The UserBrowser component enables browsing and selecting users from the system. It is a business-specific control widely used in enterprise applications for managing user assignments, permissions, or workflow responsibilities.
1. Basic Properties
- Name: Unique identifier for the component (e.g.,
UserBrowser1
). - Label: The text displayed above the input (e.g.,
Select user
). - Default value: Preselected user when the component loads.
- Placeholder: Text shown when no user is selected.
States
- Multiple: Allows selecting multiple users at once.
- Disabled: Disables interaction.
- Hidden: Hides the component but keeps it functional in logic.
- Auto focus: Automatically focuses when the form is loaded.
- Multiline: Displays multiple selected users in a wrapped format.
2. Layout
Controls responsiveness (breakpoints, spacing).
📘 See Common Properties → Layout.
3. Events
- onChange: Triggered when a user (or multiple users) is selected or removed.
4. Loading
- Loading: Displays a spinner when user data is being fetched.
5. User Interaction
- Search button (🔍) opens the User Browser dialog.
- Users can be cleared (❌) or re-selected.
- Supports single and multi-user selection depending on configuration.
User Browser Dialog
The User Browser dialog provides an advanced interface for browsing and filtering users.
1. Filter Panel (Left Side)
- User Name → Filter by username.
- Name / Surname → Filter by personal name or surname.
- E-Mail → Search users by email address.
- Email Confirmed → Dropdown filter for email confirmation status (All, Yes, No).
- Is Active → Filter users by active/inactive status.
- Lockout → Filter based on lockout state (All, Locked, Unlocked).
2. User List (Right Side)
Displays the result list in a table format:
- User Name → System username.
- E-Mail → Registered email address.
- Name / Surname → Full name of the user.
- Is Active → Indicates if the user is active.
- Email Confirmed → Shows if the email is verified.
- Lockout → Status of lockout (e.g., failed login attempts).
- Creation Time → Date and time of account creation.
✅ Each user row can be selected for assignment. Multiple users can be selected if Multiple mode is enabled.
3. Actions
- Ok button → Confirms the selected user(s).
- Get Users button → Refreshes or reloads the user list.
- Search (🔍) → Quick search across the user list.
- Pagination → Allows switching between pages (e.g., 10, 20, 40 items per page).
6. Business Use Cases
The UserBrowser component is used in:
- Assigning users to tasks or workflows.
- Mapping approvals to specific users.
- Selecting users for notifications or role-based actions.
- Managing organizational processes where user identity is needed.
7. Style
Custom styles can be applied for visual customization.
📘 See Common Properties → Style.
✅ The UserBrowser component provides a powerful way to manage user selection, with both simple inline input and a detailed dialog for searching, filtering, and selecting users in enterprise scenarios.