> For the complete documentation index, see [llms.txt](https://help.smallbuilder.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.smallbuilder.com/ko/smallbuilder-lists/undefined-1-1/filter-setup-optional.md).

# 필터 설정

**필터를 사용하여 List View에서 데이터 테이블을 필터링할 수 있습니다. 필터는 리스트 구성기에 설정된 개체의 필드에 기반합니다**. 필터 설정에서 필터를 추가하고 설정할 수 있습니다. 사용자는 다양한 조건(예: 같음, 포함, 보다 큼, 보다 작음 등)을 사용하여 원하는 데이터만 표시할 수 있으며, 여러 필터를 조합하여 복잡한 검색 조건을 만들 수 있습니다. 이러한 필터링 기능을 통해 사용자는 대량의 데이터에서 필요한 정보를 빠르고 효율적으로 찾을 수 있으며, 데이터 분석과 의사 결정 과정을 크게 개선할 수 있습니다.

<figure><img src="/files/3NpqBvR2kF7LgqrCTvLL" alt=""><figcaption><p>List View 필터</p></figcaption></figure>

***

### :small\_orange\_diamond: 필터링 로직

{% hint style="info" %}
필터 우선순위\
리스트 구성기가 처음 페이지에 로드될 때 적용되는 필터의 우선순위는 다음과 같습니다.

1\. ListView 필터 (ListView Filter)

2\. [DATATABLE SETUP WHERE 필터](/ko/smallbuilder-lists/undefined-1-1/datatable-setup/query.md) (DATATABLE SETUP where)

3\. URL 파라미터 필터 (URL Parameter)

4\. 필터 기본 입력값 (Default Filter Value)

5\. 로컬에 저장된 사용자 입력 필터값 (Preserved Filter Value)
{% endhint %}

<div data-full-width="false"><figure><img src="/files/Mz7oWnoTmIX0pU0FQn4o" alt="" width="531"><figcaption><p>필터링 로직 상세</p></figcaption></figure></div>

:small\_red\_triangle\_down: 필터링 로직 상세

* **ListView 필터의 역할**
  * 사용자가 하나의 리스트 뷰에서 여러 리스트 뷰를 추가로 생성할 수 있습니다.
  * 이때 사용자가 설정한 필터를 'ListView 필터'라고 정의하며, 이 필터는 WHERE 조건과 동일한 우선순위로 필터링 됩니다.
  * 즉, ListView 필터는 가장 우선적으로 적용되는 필터입니다.
* **URL 파라미터가 있는 경우**
  * 리스트 로드 시, 우선적으로 DATATABLE SETUP의 WHERE 조건이 필터로 설정됩니다.
  * URL 파라미터로 전달된 필터값이 있는 경우, WHERE 조건과 AND로 결합하여 필터링 합니다.
  * 필터 기본 입력값과 로컬에 저장된 사용자 입력 필터값은 무시됩니다.
* **URL 파라미터가 없는 경우**
  * 필터값 유지 여부를 확인합니다.
    * **필터값 유지 활성화**
      * 로컬에 저장된 사용자 입력 필터값을 가져옵니다.
      * 필터 기본 입력값과 비교하여, 로컬에 저장된 사용자 입력 필터값에 존재하지 않는 필터가 있으면 해당 값을 로컬에 저장합니다.
      * DATATABLE SETUP의 WHERE 조건과 AND로 결합하여 필터링합니다.
    * **필터값 유지 비활성화**
      * 필터 기본 입력값을 그대로 사용하여 DATATABLE SETUP의 WHERE 조건과 AND로 결합하여 필터링합니다.

***

### :small\_orange\_diamond: 화면 구성

<figure><img src="/files/WZMdNpioLIzNFnVhJNSP" alt="" width="280"><figcaption><p>필터 설정 화면</p></figcaption></figure>

<table><thead><tr><th width="86" data-type="number">번호</th><th width="203">필드명 및 영역</th><th width="401">설명</th></tr></thead><tbody><tr><td>1</td><td>필터 값 유지<br>(Preserve Filter Values)</td><td>필터 값 유지를 활성화하면 새로 고침 후에도 필터의 입력값이 유지됩니다.</td></tr><tr><td>2</td><td>필터 레이아웃<br>(Filter Layout)</td><td><p>한 행에 나타나는 필터의 개수를 선택합니다.</p><ul><li>3 of 12(한 행 당 4개)</li><li>4 of 12(한 행 당 3개)</li></ul><p>기본 값 : 3 of 12</p></td></tr><tr><td>3</td><td><a href="/pages/u9nUi30sQfCI28Z3XGtE"><mark style="color:blue;">필터 추가</mark><br><mark style="color:blue;">(Add Filters)</mark></a></td><td>리스트 구성 개체의 필드를 기반으로 필터를 추가하고 필터 유형에 따른 속성을 편집합니다.</td></tr></tbody></table>