# TagTextBox

URL: https://docs.wisej.com/docs/controls/editors/textbox/tagtextbox

The Wisej.NET `TagTextBox` enables users to select multiple values as tags.

## Features

### Auto Size

The `TagTextBox` control automatically resizes to fit its contents, including font size changes and tag overflow.

![TagTextBox with auto-sizing enabled](/assets/images/image (175)-3b38637bf730a13080309f22c0e6a76d.png)

info
Enable horizontal growth by setting the `MaximumSize` property.

### Auto Completion Options

The `TagTextBox` control provides selection from preset items defined in the `AutoCompleteList` property.

![TagTextBox with auto-completion options](data:image/png;base64,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)

info
The drop down uses an [<input>](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input) element with a specified [<datalist>](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/datalist) .

### Limit Tags and Length

Configure tag limits using these properties:

- `MaxLength` : Maximum characters allowed in the edit control
- `MaxTagCount` : Maximum number of tags allowed
- `MaxTagWidth` : Maximum width in pixels for tag widgets
- `MinFieldLength` : Minimum characters that should fit in the editable portion before wrapping

## How To

### Customize the Appearance

Customize tag colors using the Theme Builder, a mixin, or direct code application.

The `tagtextbox` appearance includes a `tag` child component, customizable for different states.

#### Theme Builder

![Wisej.NET Theme Builder with custom TagTextBox tag colors](/assets/images/image (176)-5c293558b4c068e387b0444941810b1a.png)

#### Mixin File

Apply custom appearance using a project mixin:

```csharp
//
// Mixin Theme Definition
//
// Mixin theme files define only a subset of the theme and are overlayed
// on top of the loaded theme. A mixin theme can extend or override the loaded theme.
//
// Mixin themes are useful to refine or style a particular feature in an application and/or
// style a new component.
//
{
	"appearances":
	{
		"mytagtextbox":
		{
			"inherit": "tagtextbox",
			"components": {
				"tag": {
					"states": {
						"default": {
							"styles": {
								"backgroundColor": "#ffe8d6"
							}
						},
						"selected": {
							"styles": {
								"backgroundColor": "#cb997e"
							}
						},
						"hovered": {
							"styles": {
								"backgroundColor": "#ddbea9"
							}
						}
					}
				}
			}
		}
	}
}
```

info
Add the mixin definition to the **/Themes** directory in your project.

#### Directly in Code

Modify the theme at runtime for custom `TagTextBox` appearance:

- C#

```csharp
Application.Theme.Appearances["tagtextbox"]["components"]["tag"]["states"]["default"]["styles"]["backgroundColor"] = "#ffe8d6";
Application.Theme.Appearances["tagtextbox"]["components"]["tag"]["states"]["hovered"]["styles"]["backgroundColor"] = "#ddbea9";
Application.Theme.Appearances["tagtextbox"]["components"]["tag"]["states"]["selected"]["styles"]["backgroundColor"] = "#cb997e";
```

## Advanced

### JavaScript Widget

| Item | Description | Class name | "wisej.web.TagTextBox" | Theme Appearance | "tagtextbox", inherited from "textbox" | Child components | "textfield" is the inner <input> widget. See [JavaScript](/docs/concepts/javascript-object-model) | Toolcontainer state | "editor", see [Embedded Tools](/docs/controls/general/embedded-tools) | Source code | [https://github.com/iceteagroup/wisej-js](https://github.com/iceteagroup/wisej-js/blob/master/wisej.web.TextBox.js)