# filter

이 열에 사용할 기본 필터 종류 또는 사용자 필터 정의입니다.

Canonical: https://grid.syidax.com/ko/docs/columns/filter/

<a id="meaning"></a>

## 무엇을 하는 API인가요

이 열에 사용할 기본 필터 종류 또는 사용자 필터 정의입니다.

Set filter와 Multi filter는 Pro입니다. 기본 text·number·date 필터는 Free입니다.

<a id="contract"></a>

## 입력과 결과의 정확한 타입

```typescript
filter?: | ColumnFilterDecl
    | string
    | GridFilterDefinition<TData, TValue, unknown, TContext>
```

| 항목 | 값 |
| --- | --- |
| 필수 여부 | 선택 |
| 입력 타입 | \| ColumnFilterDecl<br>    \| string<br>    \| GridFilterDefinition<TData, TValue, unknown, TContext> |

<a id="usage"></a>

## 사용 흐름

이 항목은 columnDefs 배열 안의 개별 열 객체에 설정합니다. 배열·객체·콜백 함수는 JavaScript로 전달하고, 변경을 반영할 때 새 배열이나 객체를 사용하세요.

<a id="types"></a>

## 관련 타입 읽기

- [ColumnFilterDecl](https://grid.syidax.com/ko/docs/types/ColumnFilterDecl.md)
- [GridFilterDefinition](https://grid.syidax.com/ko/docs/types/GridFilterDefinition.md)

<a id="recipes"></a>

## 기능별 설명과 예제

- [열마다 다른 조건](https://grid.syidax.com/ko/docs/features/column-filters.md) — 열 필터는 특정 열에 조건을 적용합니다. 텍스트·숫자·날짜별로 입력과 비교 방식이 다르며 여러 열의 조건은 함께 결과를 좁힙니다.
- [목록에서 값 선택](https://grid.syidax.com/ko/docs/features/set-filter.md) — 지역·상태처럼 반복되는 고유 값에서 포함할 항목을 고르게 하는 필터입니다. 이름 일부를 입력하는 Text filter보다 가능한 선택지를 한눈에 보여 주기 좋습니다.
- [여러 필터 조합](https://grid.syidax.com/ko/docs/features/multi-filter.md) — 한 열 안에 텍스트 검색과 값 목록 같은 여러 필터를 함께 구성합니다. 서로 다른 열에 각각 필터를 켜는 방식과 다릅니다.