TextBox
Represents an <input> element that can be used to edit unformatted text.
The Wisej.Web.TextBox control enables users to enter unformatted text.
The TextBox
control accepts a single line of text. Enable the Multiline
property to allow multiple lines of text input.
Features
Label
The TextBox
control supports the inline Label property. This allows setting a label in relation to a TextBox
control without creating an additional Label
control.

Data Binding
Data binding supports formatting and value conversion through the default data binding infrastructure. The default data property is Text
.
Spell Checking
Enable the browser's built-in spell checking by setting the SpellCheck
property to true
.

This functionality relies on the browser's language and spell checking support. Third-party spell checking is possible but outside Wisej.NET functionality.
Tool Buttons
A key Wisej.NET feature available in most controls. The Tools property enables adding internal buttons aligned left or right, with user clicks handled through the ToolClicked
event.

Lazy Events
Some TextBox
events fire only when a handler is attached. This prevents unnecessary browser requests unless explicitly subscribed.
The KeyDown
event is a Lazy Event, preventing ajax requests for each character typed.
When extending a control class and overriding On[EventName] for a lazy event without attaching a handler, the code won't execute unless a handler is attached.
Watermark
All Wisej.NET editable controls include the Watermark
property, displaying background text in empty fields.
Wisej.NET renders the watermark using the placeholder HTML attribute when supported, otherwise creating an overlaid label managed by the Wisej.NET JavaScript library.

Password
Set the PasswordChar
property to any character or the InputType
to Password
for a password input field. The PasswordChar
value always converts to "*" as browsers control password field display. This property exists for WinForms migration compatibility.
Character Casing
The CharacterCasing
property forces text case transformation on both client and server. Wisej.NET performs the change while typing (client) and when setting the Text property (server).
How To
Enter tab or enter
By default, Tab moves focus to the next control and Enter does nothing. For tab characters and newlines, set Multiline
to true
and enable AcceptsTab
or AcceptsReturn
.
Filter keyboard input
Limit accepted characters using either:
Set the
Filter
property to a regular expressionHandle the keydown event on the client with JavaScript
Server-side KeyDown
handling cannot prevent character input as the browser processes it before server communication.

Customize the appearance
Customize TextBox
appearance through:
Properties (
BackColor
,ForeColor
,BorderStyle
,Font
)Custom theme
Theme mixin
Custom styles
For specialized UI like Material-3 animated underline on focus, use theme customization or custom styles.

The image shows a TextBox
with "border-radius:20px" in CssStyle
. For shared styles, use CssClass
and add a StyleSheet file through Default.html or the StyleSheet extender.
Native Input Types
The TextBox
supports various <input> types through the InputType
property.

The Text
property always returns a string representing the native input value. Special input types have specific behaviors:
Radio
Clicking toggles the Checked
property and fires CheckedChanged
(not TextChanged
). Checked value is "on".
Browsers don't fire events for <input type=radio>. Content localization depends on browser language.
Checkbox
Clicking toggles the Checked
property and fires CheckedChanged
(not TextChanged
). Checked value is "on".
Advanced
AutoComplete
The AutoCompleteList
property enables browser native autocomplete with a string array.

Browser filters the AutoCompleteList
as users type.

The AutoComplete
property controls this feature. When enabled, browsers may build their own suggestions.
Common AutoComplete
options include:
An email address
Username
A username or account name
NewPassword
A new password field for account creation or password changes
CurrentPassword
The user's current password
OneTimeCode
A one-time verification code
See Mozilla Developer Site for all options.
Browser implementation controls this functionality, including when to use previous values.
Select content when focused
Wisej.NET selects all text when tabbing between fields. Clicking places the cursor at click location.
Enable SelectOnEnter
for automatic text selection on any focus method.
Native context menu
EnableNativeContextMenu
(default: true
) controls the browser's context menu on right-click. Disable to prevent the native menu.
JavaScript Widget
Class name
"wisej.web.TextBox" or "wisej.web.TextArea" when Multiline is true
Theme appearance
"textbox", see Themes
Child components
"textfield" is the inner <input> widget. See JavaScript
Toolcontainer state
"editor", see Embedded Tools
Source code
Last updated
Was this helpful?