> For the complete documentation index, see [llms.txt](https://docs.bdb.ai/governed-dashboards-6/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bdb.ai/governed-dashboards-6/charts-gallery/filters/combobox.md).

# Combobox

{% hint style="success" %}
*Check out the walk-through given below on how to use a Combobox filter component in the Designer.*
{% endhint %}

<figure><img src="https://859511478-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDmsjfjJBNqow7Fo97cO%2Fuploads%2FLYWpMCCur2vpBXcHKCZ2%2FCombobox%20filter.gif?alt=media&#x26;token=ad12eaf0-d93e-4d6f-8854-e209142b28e5" alt=""><figcaption></figcaption></figure>

Combo Box is used to filter data on any associated components. Selecting an item from the drop-down menu will change the data displayed in the associated components.

## **Best Situation to Use Combo Box**  <a href="#best-situation-to-use-combo-box" id="best-situation-to-use-combo-box"></a>

* To filter data on associated components.&#x20;
* To select only a particular item.

## Default Component Image <a href="#default-component-image" id="default-component-image"></a>

![](https://859511478-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDmsjfjJBNqow7Fo97cO%2Fuploads%2FhoIU2yBgkvIX19SaYakv%2FDefault%20Component%20Image.png?alt=media\&token=f864c9fc-efad-4501-bc80-48a38c6196df)

## Properties of the Combo Box Filter <a href="#properties-of-the-combo-box-filter" id="properties-of-the-combo-box-filter"></a>

### **General**

The General Properties allow customization of the Combo Box Filter component through various fields:

* **Component Name**: Defines the identifier name for the Combo Box Filter component.
* **Show Search**: Enables or disables the search function, assisting users in finding specific values.
* **Left, Top**: Sets the component position in the user interface by specifying the leftmost and topmost margins.
* **Height, Width**: Adjusts the size dimensions of the Combo Box Filter component.
* **Initial Visibility**: Determines whether the filter is visible upon the first preview. If not enabled, the chart won't appear initially.
* **Font Color, Font Size**: Modifies the text color and size within the filter for better visual distinction.
* **Font Style, Font Weight, Font Family**: Customizes the typography, including style (e.g., italic), weight (e.g., bold), and font family for a consistent visual theme.
* **Font Weight**: Set the weight (boldness) of the font. The supported options are Normal, Bold, 300, 600, and 900.&#x20;
* **Font Family**: Choose the font family for the title text from the given choices.
* **Selection**: Allows choosing between 'Default', 'Single', or 'Multiple' selection modes for item selection flexibility.
* **Selected Index**: Sets a default value that appears initially in the filter; requires enabling 'Notify GV Update' for dynamic changes.
* **Auto Update GV**: Automatically refreshes the filter when changes occur to the governing variables (GV) without manual intervention.
* **Notify GV Update**: Notifies and updates linked variables when a selection is made, keeping data in sync.
* **Public Filter**: Determines if the filter settings should be accessible to other components or users. ![](https://2748020991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3b0OCsxHg64sEwjM1HIh%2Fuploads%2F0Rr3qRFduOdkSiXUw5gm%2Fimage.png?alt=media\&token=92ac7950-90d3-45ed-9997-e20c87015a7e)

### **Background**

The Background Properties panel offers options to enhance the visual layout of the component through the following fields:

* **Shadow**: Enables a shadow effect for the component, creating a sense of depth and focus.
* **Shadow Color**: Sets the color of the shadow, allowing for customization to match the overall design theme.
* **Shadow Transparency**: Adjusts the transparency of the shadow, providing control over how prominent or subtle the shadow appears.
* **Background Color**: Defines the main color filling to the component background for aesthetic and branding consistency.

&#x20;     ![](https://2748020991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3b0OCsxHg64sEwjM1HIh%2Fuploads%2FNxQCSnm1zBNtKDTwwFLP%2Fimage.png?alt=media\&token=ee7e3657-c8e9-4edd-81bf-85db559f700b)

### **Title**&#x20;

* **Title Box Color**: Sets the background color of the title box for a cohesive look.
* **Show Title Box**: Toggles the visibility of the title box.
* **Show Title**: Allows the title text to be displayed.
* **Show Only Title**: Displays only the title, hiding other elements for a minimalist approach.
* **Title Bar Height**: Adjusts the height of the title bar, impacting the overall layout.
* **Description**: Adds supplementary information beneath the title.
* **Font Color**: Specifies the color of the title text for readability and design alignment.
* **Font Size**: Defines the size of the title text.
* **Font Style**: Choose between normal, italic, or oblique styling for the title text.
* **Font Weight**: Sets the thickness of the title text, offering a range from light to bold.
* **Font Family**: Selects the font family to apply to the title text.
* **Align**: Aligns the title text (left, center, right) within its container.
* **Text Decoration**: Adds text decoration such as underline, overline, or line-through.
* **Position**: Determines the position of the title element within the component.![](https://2748020991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3b0OCsxHg64sEwjM1HIh%2Fuploads%2F60lbOmDXiaiLsp3qkmKr%2Fimage.png?alt=media\&token=1b2f7d3e-1f6b-4f70-a854-17f76144938b)

### Dropdown Style

* **Rollover Color**: This property changes the background color when a user hovers over an option in the dropdown, enhancing interactivity and user experience.
* **Selection Color**: Defines the background color of a selected option in the dropdown, providing a visual indication of the user's choice.
* **Background Color**: Sets the overall background color of the dropdown menu, contributing to the visual consistency of the design.

&#x20;       ![](https://2748020991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3b0OCsxHg64sEwjM1HIh%2Fuploads%2FbbF9UqawqVDEFMSdSbf9%2Fimage.png?alt=media\&token=0879ea06-3e3c-4d07-9647-f9f2ccbe7a03)

## **Combo Box Filter Variants after Changing its Properties**

### **Default Selection**

![](https://859511478-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDmsjfjJBNqow7Fo97cO%2Fuploads%2FtGZmSU7TZuLgteaPJof1%2FWhen%20selection%20is%20default%20%20%20.png?alt=media\&token=803181f1-13a7-4ef6-8e0c-e28e53cdd36c)

### **Single Select**&#x20;

![](https://859511478-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDmsjfjJBNqow7Fo97cO%2Fuploads%2FEXKeZ9VgaLL9PdgGkCmV%2FWhen%20selection%20is%20Single%20%20%20%20%20%20%20.png?alt=media\&token=b56ec464-cb1f-427f-b860-f108f3e22e18)

### **Multiselect with enhanced Checkbox**&#x20;

![](https://content.gitbook.com/content/3b0OCsxHg64sEwjM1HIh/blobs/GXrPYbVIxRNtV16PRmK5/image.png)
