컬럼 활용

첫 번째, (컬럼) 필터링 방식

QCELL은 API를 사용한 필터링 기능을 제공합니다.

1️⃣ 컬럼 필터링 API

컬럼별 필터를 설정할 때 사용하는 API입니다.

qcell.filter(col, filter) → {boolean}

▪️ 반환값: ✅ true – 정상적으로 필터링이 적용된 경우
❌ false – 오류 발생 시 (데이터 타입 불일치, 필수 입력값 누락 등)

파라미터	타입	설명
col	number	필터링할 컬럼 번호 (※ 반드시 컬럼 생성 시 filter: true로 설정되어 있어야 함)
filter	Array | Object	필터링 옵션. 컬럼 데이터 타입에 따라 배열 또는 객체로 설정

2️⃣ 필터 옵션 설정 방법

① 문자열(String) 컬럼 필터링

▪️ 배열(Array) 형태로 필터링할 데이터를 설정합니다.
예시:

 qcell.filter(1, ['전체', '여행업']);

▪️1번 컬럼에서 **"전체"**와 **"여행업"**만 보이도록 필터링합니다.

② 숫자(Number) 컬럼 필터링

✔️ 옵션 1개 설정

 qcell.filter(9, { 'value1': 3, 'comparison1': '>' });

▪️ 9번 컬럼에서 3보다 큰 값만 필터링합니다.

✔️ 옵션 2개 설정 (and/or 조건)

 qcell.filter(9, { 
	'value1': 1, 'comparison1': '>',
	'logical': 'and',
	'value2': 2, 'comparison2': '<=' 
});

▪️ 9번 컬럼에서 1보다 크고 2보다 작거나 같은 값을 필터링합니다.

📌 value| comparison|logical 의미

▪️ value1: 필터링 기준이 되는 첫 번째 값
▪️ comparison1: 첫 번째 값과 비교할 비교 연산자
▪️ logical: 두 조건을 연결하는 논리 연산자(and 또는 or)
▪️ value2: 필터링 기준이 되는 두 번째 값
▪️ comparison2: 두 번째 값과 비교할 비교 연산자

📌 비교 연산자 종류

▪️ > : 크다
▪️ >= : 크거나 같다
▪️ < : 작다
▪️ <= : 작거나 같다
▪️ = : 같다
▪️ != : 같지 않다

3️⃣ 반환값 설명

반환값	설명
true	✅ 정상적으로 필터링이 적용된 경우
false	❌ 오류 발생 시 (예: 문자열 컬럼인데 Object로 설정했거나, 숫자 컬럼 필수 값이 누락된 경우 등)

4️⃣ 필터 초기화(Reset)

qcell.resetFilter(col); 특정 컬럼의 필터링을 해제할 때 사용합니다.

qcell.resetFilter(1); 

---