# externalFilter

앱 바깥의 검색 조건으로 각 행의 통과 여부를 판단합니다. 필터 활성 여부와 행 판정 콜백 또는 수명 주기를 가진 인스턴스를 전달합니다.

Canonical: https://grid.syidax.com/ko/docs/options/externalFilter/

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

## 무엇을 하는 API인가요

앱 바깥의 검색 조건으로 각 행의 통과 여부를 판단합니다. 필터 활성 여부와 행 판정 콜백 또는 수명 주기를 가진 인스턴스를 전달합니다.

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

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

```typescript
externalFilter: | GridExternalFilterCallbacks<GridData>
    | GridExternalFilterInstance<GridData, unknown>
```

| 항목 | 값 |
| --- | --- |
| JavaScript 이름 | externalFilter |
| HTML 속성 | external-filter |
| 기본값 | undefined |
| 입력 타입 | \| GridExternalFilterCallbacks<GridData><br>    \| GridExternalFilterInstance<GridData, unknown> |

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

## 사용 흐름

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

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

## 관련 타입 읽기

- [GridExternalFilterCallbacks](https://grid.syidax.com/ko/docs/types/GridExternalFilterCallbacks.md)
- [GridData](https://grid.syidax.com/ko/docs/types/GridData.md)
- [GridExternalFilterInstance](https://grid.syidax.com/ko/docs/types/GridExternalFilterInstance.md)

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

## 기능별 설명과 예제

- [업무 조건으로 필터링](https://grid.syidax.com/ko/docs/features/external-filter.md) — Grid 밖의 업무 조건을 행 판정 함수로 연결합니다. 미완료만 보기, 내 담당 건만 보기처럼 외부 UI에 있는 선택이 표의 결과를 제어할 때 사용합니다.