> Documentation index: https://www.gooddata.ai/docs/gooddata-ui/llms.txt lists every page of these docs as Markdown.

# IAttributeFilterDropdownButtonProps

- Package: [@gooddata/sdk-ui-filters](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/index.md)
- Kind: interface
- Stability: beta
- Source: https://github.com/gooddata/gooddata-ui-sdk/blob/rel/11.64/libs/sdk-ui-filters/src/AttributeFilter/Components/DropdownButton/AttributeFilterDropdownButton.tsx

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

The interface of the AttributeFilter dropdown button.

**Signature:**

```typescript
export interface IAttributeFilterDropdownButtonProps 
```

## Remarks

It opens Attribute filter dropdown and displaying title or subtitle, selection details and attribute filter statuses like loading or filtering. Note: for rendering error status see [IAttributeFilterErrorProps](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributefiltererrorprops/index.md).

## Properties

| Property | Modifiers | Type | Description |
| --- | --- | --- | --- |
| [ariaLabel?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributefilterdropdownbuttonprops/index.md#iattributefilterdropdownbuttonpropsarialabel) |  | string | **_(BETA)_** _(Optional)_ Overrides the accessible name of the button. When omitted, the name is derived from the rendered title. |
| [buttonId?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributefilterdropdownbuttonprops/index.md#iattributefilterdropdownbuttonpropsbuttonid) |  | string | **_(BETA)_** _(Optional)_ Id of the dropdown trigger button. |
| [buttonRef?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributefilterdropdownbuttonprops/index.md#iattributefilterdropdownbuttonpropsbuttonref) |  | Ref<HTMLElement> | **_(BETA)_** _(Optional)_ Ref to the dropdown button component. |
| [className?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributefilterdropdownbuttonprops/index.md#iattributefilterdropdownbuttonpropsclassname) |  | string | **_(BETA)_** _(Optional)_ Classnames to add to the dropdown button component. |
| [customIcon?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributefilterdropdownbuttonprops/index.md#iattributefilterdropdownbuttonpropscustomicon) |  | [IFilterButtonCustomIcon](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.ifilterbuttoncustomicon/index.md) | **_(ALPHA)_** _(Optional)_ Represents a custom icon along with a tooltip. |
| [disabled?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributefilterdropdownbuttonprops/index.md#iattributefilterdropdownbuttonpropsdisabled) |  | boolean | **_(ALPHA)_** _(Optional)_ Specifies the visibility mode of the filter. |
| [dropdownId?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributefilterdropdownbuttonprops/index.md#iattributefilterdropdownbuttonpropsdropdownid) |  | string | **_(BETA)_** _(Optional)_ Id of the Attribute filter dropdown body. |
| [hideChevron?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributefilterdropdownbuttonprops/index.md#iattributefilterdropdownbuttonpropshidechevron) |  | boolean | **_(BETA)_** _(Optional)_ Hides the open/close chevron. |
| [icon?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributefilterdropdownbuttonprops/index.md#iattributefilterdropdownbuttonpropsicon) |  | ReactNode | **_(BETA)_** _(Optional)_ Icon of the AttributeFilterDropdownButton. |
| [isDraggable?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributefilterdropdownbuttonprops/index.md#iattributefilterdropdownbuttonpropsisdraggable) |  | boolean | **_(BETA)_** _(Optional)_ If true, the button supports drag and drop operations. |
| [isError?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributefilterdropdownbuttonprops/index.md#iattributefilterdropdownbuttonpropsiserror) |  | boolean | **_(BETA)_** _(Optional)_ |
| [isFiltering?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributefilterdropdownbuttonprops/index.md#iattributefilterdropdownbuttonpropsisfiltering) |  | boolean | **_(BETA)_** _(Optional)_ If true, the AttributeFilter is filtering its elements by parent filters. |
| [isLoaded?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributefilterdropdownbuttonprops/index.md#iattributefilterdropdownbuttonpropsisloaded) |  | boolean | **_(BETA)_** _(Optional)_ If true, all the initialization has finished. |
| [isLoading?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributefilterdropdownbuttonprops/index.md#iattributefilterdropdownbuttonpropsisloading) |  | boolean | **_(BETA)_** _(Optional)_ If true, the AttributeFilter is initializing Attribute elements and its internal data. |
| [isOpen?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributefilterdropdownbuttonprops/index.md#iattributefilterdropdownbuttonpropsisopen) |  | boolean | **_(BETA)_** _(Optional)_ If true, the AttributeFilter dropdown is open. |
| [layout?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributefilterdropdownbuttonprops/index.md#iattributefilterdropdownbuttonpropslayout) |  | "stacked" \| "row" | **_(BETA)_** _(Optional)_ Visual layout of the chip. "row" is the full-width single-line variant used in the mobile view. |
| [onClick?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributefilterdropdownbuttonprops/index.md#iattributefilterdropdownbuttonpropsonclick) |  | () => void | **_(BETA)_** _(Optional)_ Callback to open or close AttributeFilter dropdown. |
| [selectedItemsCount?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributefilterdropdownbuttonprops/index.md#iattributefilterdropdownbuttonpropsselecteditemscount) |  | number | **_(BETA)_** _(Optional)_ Selected items count |
| [showSelectionCount?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributefilterdropdownbuttonprops/index.md#iattributefilterdropdownbuttonpropsshowselectioncount) |  | boolean | **_(BETA)_** _(Optional)_ |
| [subtitle?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributefilterdropdownbuttonprops/index.md#iattributefilterdropdownbuttonpropssubtitle) |  | string | **_(BETA)_** _(Optional)_ Comma-separated list of selected element titles. |
| [title?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributefilterdropdownbuttonprops/index.md#iattributefilterdropdownbuttonpropstitle) |  | string | **_(BETA)_** _(Optional)_ Title of the attribute [IAttributeFilter](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iattributefilter/index.md) and its related display form [IAttributeDisplayFormMetadataObject](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iattributedisplayformmetadataobject/index.md). |
| [titleExtension?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributefilterdropdownbuttonprops/index.md#iattributefilterdropdownbuttonpropstitleextension) |  | ReactNode | **_(ALPHA)_** _(Optional)_ Allows adding content to the button after the title. |
| [TooltipContentComponent?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributefilterdropdownbuttonprops/index.md#iattributefilterdropdownbuttonpropstooltipcontentcomponent) |  | ComponentType | **_(BETA)_** _(Optional)_ Customize content of the attribute filter tooltip component. |
| [totalItemsCount?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iattributefilterdropdownbuttonprops/index.md#iattributefilterdropdownbuttonpropstotalitemscount) |  | number | **_(BETA)_** _(Optional)_ Total items count. Shown beside the selected items count if showSelectionCount is true. |

## Property details

### IAttributeFilterDropdownButtonProps.ariaLabel

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Overrides the accessible name of the button. When omitted, the name is derived from the rendered title.

**Signature:**

```typescript
ariaLabel?: string;
```

### IAttributeFilterDropdownButtonProps.buttonId

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Id of the dropdown trigger button.

**Signature:**

```typescript
buttonId?: string;
```

### IAttributeFilterDropdownButtonProps.buttonRef

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Ref to the dropdown button component.

**Signature:**

```typescript
buttonRef?: Ref<HTMLElement>;
```

### IAttributeFilterDropdownButtonProps.className

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Classnames to add to the dropdown button component.

**Signature:**

```typescript
className?: string;
```

### IAttributeFilterDropdownButtonProps.customIcon

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Represents a custom icon along with a tooltip.

**Signature:**

```typescript
customIcon?: IFilterButtonCustomIcon;
```

### IAttributeFilterDropdownButtonProps.disabled

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Specifies the visibility mode of the filter.

**Signature:**

```typescript
disabled?: boolean;
```

### IAttributeFilterDropdownButtonProps.dropdownId

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Id of the Attribute filter dropdown body.

**Signature:**

```typescript
dropdownId?: string;
```

### IAttributeFilterDropdownButtonProps.hideChevron

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Hides the open/close chevron.

**Signature:**

```typescript
hideChevron?: boolean;
```

### IAttributeFilterDropdownButtonProps.icon

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Icon of the AttributeFilterDropdownButton.

**Signature:**

```typescript
icon?: ReactNode;
```

### IAttributeFilterDropdownButtonProps.isDraggable

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

If true, the button supports drag and drop operations.

**Signature:**

```typescript
isDraggable?: boolean;
```

### IAttributeFilterDropdownButtonProps.isError

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

**Signature:**

```typescript
isError?: boolean;
```

### IAttributeFilterDropdownButtonProps.isFiltering

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

If true, the AttributeFilter is filtering its elements by parent filters.

**Signature:**

```typescript
isFiltering?: boolean;
```

### IAttributeFilterDropdownButtonProps.isLoaded

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

If true, all the initialization has finished.

**Signature:**

```typescript
isLoaded?: boolean;
```

### IAttributeFilterDropdownButtonProps.isLoading

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

If true, the AttributeFilter is initializing Attribute elements and its internal data.

**Signature:**

```typescript
isLoading?: boolean;
```

### IAttributeFilterDropdownButtonProps.isOpen

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

If true, the AttributeFilter dropdown is open.

**Signature:**

```typescript
isOpen?: boolean;
```

### IAttributeFilterDropdownButtonProps.layout

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Visual layout of the chip. "row" is the full-width single-line variant used in the mobile view.

**Signature:**

```typescript
layout?: "stacked" | "row";
```

### IAttributeFilterDropdownButtonProps.onClick

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Callback to open or close AttributeFilter dropdown.

**Signature:**

```typescript
onClick?: () => void;
```

### IAttributeFilterDropdownButtonProps.selectedItemsCount

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Selected items count

**Signature:**

```typescript
selectedItemsCount?: number;
```

#### Remarks

- If value is 0 for [IPositiveAttributeFilter](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipositiveattributefilter/index.md) means NONE items are selected

- If value is 0 for [INegativeAttributeFilter](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.inegativeattributefilter/index.md) means ALL items are selected

### IAttributeFilterDropdownButtonProps.showSelectionCount

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

**Signature:**

```typescript
showSelectionCount?: boolean;
```

### IAttributeFilterDropdownButtonProps.subtitle

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Comma-separated list of selected element titles.

**Signature:**

```typescript
subtitle?: string;
```

### IAttributeFilterDropdownButtonProps.title

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Title of the attribute [IAttributeFilter](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iattributefilter/index.md) and its related display form [IAttributeDisplayFormMetadataObject](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iattributedisplayformmetadataobject/index.md).

**Signature:**

```typescript
title?: string;
```

### IAttributeFilterDropdownButtonProps.titleExtension

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Allows adding content to the button after the title.

**Signature:**

```typescript
titleExtension?: ReactNode;
```

### IAttributeFilterDropdownButtonProps.TooltipContentComponent

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Customize content of the attribute filter tooltip component.

**Signature:**

```typescript
TooltipContentComponent?: ComponentType;
```

### IAttributeFilterDropdownButtonProps.totalItemsCount

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Total items count. Shown beside the selected items count if showSelectionCount is true.

**Signature:**

```typescript
totalItemsCount?: number;
```