# quickFilterText

빠른 검색에 적용할 문자열입니다. 앱의 외부 검색창에서도 새 문자열을 지정할 수 있습니다.

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

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

## 무엇을 하는 API인가요

빠른 검색에 적용할 문자열입니다. 앱의 외부 검색창에서도 새 문자열을 지정할 수 있습니다.

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

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

```typescript
quickFilterText: string
```

| 항목 | 값 |
| --- | --- |
| JavaScript 이름 | quickFilterText |
| HTML 속성 | quick-filter-text |
| 기본값 | '' |
| 입력 타입 | string |

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

## 사용 흐름

이 항목은 Grid 요소의 프로퍼티에 설정합니다. HTML에서는 quick-filter-text 속성으로도 지정할 수 있습니다. 배열·객체·콜백 함수는 JavaScript로 전달하고, 변경을 반영할 때 새 배열이나 객체를 사용하세요.

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

## 기능별 설명과 예제

- [모든 열에서 빠르게 찾기](https://grid.syidax.com/ko/docs/features/quick-filter.md) — 빠른 검색은 열을 지정하지 않고 여러 열의 표시 대상에서 문자열을 찾습니다. 사용자가 제품명인지 지역인지 모를 때 진입점으로 적합합니다.