# UserComboBox

The UserComboBox control allows the creation of a custom template to use as the dropdown portion of the ComboBox.

{% hint style="info" %}
For a full list of properties, methods and events see the [API documentation](https://docs.wisej.com/api/wisej.web/lists-and-grids/wisej.web.usercombobox).
{% endhint %}

## Features

### Custom Controls

The **DropDownControl** property of the UserComboBox control specifies which control to use as a template for the drop down panel of the combo box.

<div align="left"><img src="https://553579532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MF1D11gPs_az3xaKusw%2Fuploads%2Fgit-blob-954ced164bcce9e49759cf55a5b66219aba4052c%2Fimage.png?alt=media" alt=""></div>

### Label

The UserComboBox control supports the inline [Label ](https://docs.wisej.com/docs/controls/general/labels)property. This allows an application to set a label in relation to a UserComboBox control without having to create an additional Label control.

<div align="left"><img src="https://553579532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MF1D11gPs_az3xaKusw%2Fuploads%2Fgit-blob-da8caf672de01a8bb9c62e8800bd74b78b95eb7e%2Fimage.png?alt=media" alt=""></div>

{% content-ref url="../../general/labels" %}
[labels](https://docs.wisej.com/docs/controls/general/labels)
{% endcontent-ref %}

## Advanced

### JavaScript Widget

| Item             | Description                                                                                                                                                                                                                                                                                                                                                                        |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Class name       | "wisej.web.UserComboBox"                                                                                                                                                                                                                                                                                                                                                           |
| Theme appearance | "combobox", "listitem" for the items in the drop down, see [Themes](https://docs.wisej.com/theme-builder/theme-elements/elements).                                                                                                                                                                                                                                                 |
| Child components | "textfield" is the inner \<input> widget, "button" is the drop down button, "list" is the drop down list, "popup" is the container of the drop down list, "labelfield" is the inner content when the ComboBox is not editable, and "icon" is the icon for the selected item when it shows an icon. See [JavaScript](https://docs.wisej.com/docs/concepts/javascript-object-model). |
| Source code      | [https://github.com/iceteagroup/wisej-js](https://github.com/iceteagroup/wisej-js/blob/master/wisej.web.TextBox.js)                                                                                                                                                                                                                                                                |