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

# IArbitraryValuesInputProps

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

> **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).
> 

Props for ArbitraryValuesInput component.

**Signature:**

```typescript
export interface IArbitraryValuesInputProps 
```

## Properties

| Property | Modifiers | Type | Description |
| --- | --- | --- | --- |
| [ariaDescribedBy?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iarbitraryvaluesinputprops/index.md#iarbitraryvaluesinputpropsariadescribedby) |  | string | **_(ALPHA)_** _(Optional)_ Optional id(s) of elements that describe this control. |
| [ariaLabelledBy?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iarbitraryvaluesinputprops/index.md#iarbitraryvaluesinputpropsarialabelledby) |  | string | **_(ALPHA)_** _(Optional)_ Optional id of an external label that describes this control. |
| [autocompleteOptions?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iarbitraryvaluesinputprops/index.md#iarbitraryvaluesinputpropsautocompleteoptions) |  | string[] | **_(ALPHA)_** _(Optional)_ Optional list of autocomplete suggestions. When provided, a dropdown of matching options is shown while the user types. Selecting an option adds it as a chip. Already-selected values are excluded from the suggestions. |
| [disabled?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iarbitraryvaluesinputprops/index.md#iarbitraryvaluesinputpropsdisabled) |  | boolean | **_(ALPHA)_** _(Optional)_ Whether the input is disabled |
| [emptyValueDisplay](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iarbitraryvaluesinputprops/index.md#iarbitraryvaluesinputpropsemptyvaluedisplay) |  | string | **_(ALPHA)_** Localized display string for empty value (e.g. "(empty value)"). Used for parsing input and displaying empty string values. |
| [hasEmptyError?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iarbitraryvaluesinputprops/index.md#iarbitraryvaluesinputpropshasemptyerror) |  | boolean | **_(ALPHA)_** _(Optional)_ Whether empty-value validation should be shown. |
| [hasValuesLimitExceededError?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iarbitraryvaluesinputprops/index.md#iarbitraryvaluesinputpropshasvalueslimitexceedederror) |  | boolean | **_(ALPHA)_** _(Optional)_ True when value limit exceeded (error state) - red border on container. |
| [hasValuesLimitReachedWarning?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iarbitraryvaluesinputprops/index.md#iarbitraryvaluesinputpropshasvalueslimitreachedwarning) |  | boolean | **_(ALPHA)_** _(Optional)_ True when at value limit (warning state) - yellow border on container. |
| [inputId?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iarbitraryvaluesinputprops/index.md#iarbitraryvaluesinputpropsinputid) |  | string | **_(ALPHA)_** _(Optional)_ Optional id of the values input. |
| [isAutocompleteLoading?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iarbitraryvaluesinputprops/index.md#iarbitraryvaluesinputpropsisautocompleteloading) |  | boolean | **_(ALPHA)_** _(Optional)_ Whether autocomplete is currently loading results from the backend. |
| [onAutocompleteSearch?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iarbitraryvaluesinputprops/index.md#iarbitraryvaluesinputpropsonautocompletesearch) |  | (searchString: string) => void | **_(ALPHA)_** _(Optional)_ Optional callback to trigger a search for autocomplete suggestions. When provided, this will be called as the user types to fetch matching elements from the backend. |
| [onBlur?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iarbitraryvaluesinputprops/index.md#iarbitraryvaluesinputpropsonblur) |  | FocusEventHandler<HTMLInputElement> | **_(ALPHA)_** _(Optional)_ Callback when input loses focus. |
| [onValuesChange?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iarbitraryvaluesinputprops/index.md#iarbitraryvaluesinputpropsonvalueschange) |  | (values: Array<string \| null>) => void | **_(ALPHA)_** _(Optional)_ Callback when values change |
| [placeholder?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iarbitraryvaluesinputprops/index.md#iarbitraryvaluesinputpropsplaceholder) |  | string | **_(ALPHA)_** _(Optional)_ Placeholder text |
| [values](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.iarbitraryvaluesinputprops/index.md#iarbitraryvaluesinputpropsvalues) |  | Array<string \| null> | **_(ALPHA)_** Current values |

## Property details

### IArbitraryValuesInputProps.ariaDescribedBy

> **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).
> 

Optional id(s) of elements that describe this control.

**Signature:**

```typescript
ariaDescribedBy?: string;
```

### IArbitraryValuesInputProps.ariaLabelledBy

> **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).
> 

Optional id of an external label that describes this control.

**Signature:**

```typescript
ariaLabelledBy?: string;
```

### IArbitraryValuesInputProps.autocompleteOptions

> **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).
> 

Optional list of autocomplete suggestions. When provided, a dropdown of matching options is shown while the user types. Selecting an option adds it as a chip. Already-selected values are excluded from the suggestions.

**Signature:**

```typescript
autocompleteOptions?: string[];
```

### IArbitraryValuesInputProps.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).
> 

Whether the input is disabled

**Signature:**

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

### IArbitraryValuesInputProps.emptyValueDisplay

> **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).
> 

Localized display string for empty value (e.g. "(empty value)"). Used for parsing input and displaying empty string values.

**Signature:**

```typescript
emptyValueDisplay: string;
```

### IArbitraryValuesInputProps.hasEmptyError

> **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).
> 

Whether empty-value validation should be shown.

**Signature:**

```typescript
hasEmptyError?: boolean;
```

### IArbitraryValuesInputProps.hasValuesLimitExceededError

> **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).
> 

True when value limit exceeded (error state) - red border on container.

**Signature:**

```typescript
hasValuesLimitExceededError?: boolean;
```

### IArbitraryValuesInputProps.hasValuesLimitReachedWarning

> **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).
> 

True when at value limit (warning state) - yellow border on container.

**Signature:**

```typescript
hasValuesLimitReachedWarning?: boolean;
```

### IArbitraryValuesInputProps.inputId

> **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).
> 

Optional id of the values input.

**Signature:**

```typescript
inputId?: string;
```

### IArbitraryValuesInputProps.isAutocompleteLoading

> **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).
> 

Whether autocomplete is currently loading results from the backend.

**Signature:**

```typescript
isAutocompleteLoading?: boolean;
```

### IArbitraryValuesInputProps.onAutocompleteSearch

> **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).
> 

Optional callback to trigger a search for autocomplete suggestions. When provided, this will be called as the user types to fetch matching elements from the backend.

**Signature:**

```typescript
onAutocompleteSearch?: (searchString: string) => void;
```

### IArbitraryValuesInputProps.onBlur

> **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).
> 

Callback when input loses focus.

**Signature:**

```typescript
onBlur?: FocusEventHandler<HTMLInputElement>;
```

### IArbitraryValuesInputProps.onValuesChange

> **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).
> 

Callback when values change

**Signature:**

```typescript
onValuesChange?: (values: Array<string | null>) => void;
```

### IArbitraryValuesInputProps.placeholder

> **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).
> 

Placeholder text

**Signature:**

```typescript
placeholder?: string;
```

### IArbitraryValuesInputProps.values

> **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).
> 

Current values

**Signature:**

```typescript
values: Array<string | null>;
```