# 모든 열에서 빠르게 찾기

빠른 검색은 열을 지정하지 않고 여러 열의 표시 대상에서 문자열을 찾습니다. 사용자가 제품명인지 지역인지 모를 때 진입점으로 적합합니다.

Canonical: https://grid.syidax.com/ko/docs/features/quick-filter/

<a id="understand"></a>

## 동작 원리와 선택 기준

Find는 일치 셀로 이동하고 Quick filter는 일치하지 않는 행을 숨깁니다. 목적에 따라 두 기능을 구분해 제공하세요.

코드의 grid는 설치와 연결 장에서 준비한 Grid 요소입니다. 예제마다 필요한 데이터·설정을 확인하고, 코드에서 소개하는 앱 함수와 서버 주소는 프로젝트에 맞게 구현하세요.

- [설치와 연결 · 공통 예제 데이터](https://grid.syidax.com/ko/docs/guides/getting-started.md)

<a id="example-1"></a>

## 예제 1. 통합 검색어 전달

앱의 검색 입력값을 quickFilterText에 연결합니다.

```javascript
grid.quickFilter = true;
grid.quickFilterText = 'Platform';
```

결과 확인: 현재 데이터에서 검색어와 맞는 행만 남습니다. 서버에 아직 없는 데이터까지 찾으려면 원격 요청에 검색어를 전달합니다.

<a id="example-2"></a>

## 예제 2. 여러 단어 조건

두 단어를 모두 만족해야 하는 검색과 하나만 만족해도 되는 검색을 비교합니다.

```javascript
grid.quickFilterMode = 'and';
grid.quickFilterText = 'Platform APAC';
// 둘 중 하나만 맞아도 표시하려면
// grid.quickFilterMode = 'or';
```

결과 확인: 단어 조합에 따라 결과가 달라집니다. 사용자가 이해할 수 있도록 검색창의 안내에 조건 관계를 표시하세요.

<a id="example-3"></a>

## 예제 3. 입력 빈도와 해제

입력할 때마다 무거운 계산이나 서버 요청이 발생하지 않도록 지연을 조절합니다.

```javascript
grid.quickFilterDebounce = 200;
grid.quickFilterText = '';
```

결과 확인: 빈 문자열은 검색어 해제입니다. 정규식 검색을 켜는 앱은 잘못된 패턴과 과도하게 넓은 패턴도 확인해야 합니다.

<a id="pitfalls"></a>

## 조합할 때와 문제를 해결할 때

검색 대상에 원본 객체 전체가 무조건 포함된다고 가정하지 마세요. 열 구성과 표시·접근 규칙을 함께 확인합니다.

검색어 변경과 서버 응답의 시간차 때문에 이전 결과가 잠시 남을 수 있습니다. 로딩과 결과 없음 안내를 구분하세요.

<a id="related-api"></a>

## 이 기능에 사용하는 API

- [quickFilter](https://grid.syidax.com/ko/docs/options/quickFilter.md) — 표 전체 검색 입력을 표시합니다. 초기 검색어나 외부 입력 연결에는 quickFilterText를 사용합니다.
- [quickFilterText](https://grid.syidax.com/ko/docs/options/quickFilterText.md) — 빠른 검색에 적용할 문자열입니다. 앱의 외부 검색창에서도 새 문자열을 지정할 수 있습니다.
- [quickFilterPlaceholder](https://grid.syidax.com/ko/docs/options/quickFilterPlaceholder.md) — 빠른 검색 입력의 안내 문구입니다. 검색할 수 있는 데이터 범위를 구체적으로 설명하세요.
- [quickFilterMode](https://grid.syidax.com/ko/docs/options/quickFilterMode.md) — 여러 검색어를 모두 만족해야 하는 and 또는 하나라도 만족하면 되는 or로 연결합니다.
- [quickFilterRegex](https://grid.syidax.com/ko/docs/options/quickFilterRegex.md) — 빠른 검색 문자열을 정규식으로 해석하도록 설정합니다. 일반 텍스트 검색과 입력 의미가 달라집니다.
- [quickFilterDebounce](https://grid.syidax.com/ko/docs/options/quickFilterDebounce.md) — 빠른 검색 입력 후 필터를 적용하기까지 기다릴 시간입니다. 연속 입력의 처리량과 반응 속도를 조절합니다.
- [quickFilterChanged](https://grid.syidax.com/ko/docs/events/quickFilterChanged.md) — 빠른 검색 조건이 바뀌었을 때 발생합니다. 앱 외부 검색 입력과 값을 동기화할 수 있습니다.

<a id="next"></a>

## 함께 읽기

- [행·열·ID의 관계](https://grid.syidax.com/ko/docs/guides/concepts.md)
- [결과와 이벤트 연결](https://grid.syidax.com/ko/docs/guides/data-event-access.md)
- [Features에서 살펴보기](https://grid.syidax.com/grid/quick-filter) — 직접 체험 가능한 범위는 해당 가이드에 안내되어 있습니다.