필터 옵션·변경 이벤트
columnFiltering은 부모가 소유한 배열 데이터의 클라이언트 필터입니다. 빈 model이라도 설정 객체가 있으면 Row Drag가 제한됩니다. 필터 버튼·모델 편집 모두 부모 콜백과 값을 연결해야 합니다.
연산자와 값 처리
섹션 제목: “연산자와 값 처리”| kind | 지원 operator |
|---|---|
| text | contains, notContains, startsWith, endsWith, equals, notEquals, isEmpty, isNotEmpty |
| number / date | equals, notEquals, greaterThan, greaterThanOrEqual, lessThan, lessThanOrEqual, between, isEmpty, isNotEmpty |
| boolean | equals, notEquals, isEmpty, isNotEmpty |
Date는 UTC 날짜 단위입니다. 잘못된 날짜·값·연산자 규칙은 무시하며, 유효한 규칙이 없으면 모든 행을 표시합니다. text에서 공백은 값이고 null/undefined/빈 문자열만 empty입니다. 필터는 원본 data 순서를 바꾸지 않습니다. 필터로 숨긴 선택 행 ID는 유지되지만 표시 좌표가 필요한 셀/범위 선택은 해제될 수 있습니다.
CominsColumnFilteringConfig
섹션 제목: “CominsColumnFilteringConfig”model
섹션 제목: “model”model: CominsColumnFilterModel;필수. 전체 필터 규칙 배열입니다. 빈 배열은 필터 없음. 서로 다른 컬럼 규칙은 AND, 같은 컬럼은 첫 유효 규칙만 사용합니다.
onChangeModel
섹션 제목: “onChangeModel”onChangeModel?: (model: CominsColumnFilterRule[]) => void;편집/삭제 후 전체 다음 model을 전달합니다. 없으면 편집기는 읽기 전용입니다.
openColumnId
섹션 제목: “openColumnId”openColumnId?: string | null;현재 열린 컬럼 ID 또는 null입니다. 생략하면 열린 필터 없음.
onChangeOpenColumnId
섹션 제목: “onChangeOpenColumnId”onChangeOpenColumnId?: (columnId: string | null) => void;열기/닫기 요청의 다음 ID 또는 null을 전달합니다. 없으면 헤더 필터 버튼이 비활성화됩니다. openColumnId에 반영하십시오.
CominsColumnFilterConfig
섹션 제목: “CominsColumnFilterConfig”kind
섹션 제목: “kind”kind: CominsColumnFilterKind;필수. text/number/date/boolean 중 값 종류입니다.
caseSensitive
섹션 제목: “caseSensitive”caseSensitive?: boolean;text 기본 false. true일 때만 대소문자를 구분합니다.
getValue
섹션 제목: “getValue”getValue?: (params: CominsCellFormatParams<TData, TValue>) => unknown;미지정 시 field의 원본 값을 사용합니다. 지정하면 필터 비교 값만 별도로 추출합니다.
CominsColumnFilterRule
섹션 제목: “CominsColumnFilterRule”columnId
섹션 제목: “columnId”columnId: string;필수. filter 설정이 있는 컬럼 ID입니다. 알 수 없는 컬럼 규칙은 무시합니다.
operator
섹션 제목: “operator”operator: CominsColumnConditionFilterOperator;필수. 아래 kind별 지원 연산자 중 하나입니다. 잘못된 조합은 무시합니다.
value
섹션 제목: “value”value?: CominsColumnFilterValue;비교 값입니다. isEmpty/isNotEmpty는 생략합니다. number는 유한 숫자, date 모델은 YYYY-MM-DD, boolean은 boolean을 사용합니다.
valueTo
섹션 제목: “valueTo”valueTo?: null | number | string;between의 다른 끝 값입니다. 양 끝을 포함하며 순서가 뒤집혀도 범위를 정규화합니다.
관련 API
섹션 제목: “관련 API”getOptionLabel
섹션 제목: “getOptionLabel”getOptionLabel?: (value: CominsColumnFilterValue) => string;표준 렌더링 경로와 반환값은 값 목록 필터 가이드를 참고하십시오.
mode
섹션 제목: “mode”mode?: "condition" | "values";표준 렌더링 경로와 반환값은 값 목록 필터 가이드를 참고하십시오.
trigger
섹션 제목: “trigger”trigger?: CominsValueFilterPart<CominsValueFilterTriggerRenderParams<TData>>;표준 렌더링 경로와 반환값은 값 목록 필터 가이드를 참고하십시오.
option
섹션 제목: “option”option?: CominsValueFilterPart<CominsValueFilterOptionRenderParams<TData>>;표준 렌더링 경로와 반환값은 값 목록 필터 가이드를 참고하십시오.
panel
섹션 제목: “panel”panel?: CominsValueFilterPart<CominsValueFilterPanelRenderParams<TData>>;표준 렌더링 경로와 반환값은 값 목록 필터 가이드를 참고하십시오.
values
섹션 제목: “values”values?: never;표준 렌더링 경로와 반환값은 값 목록 필터 가이드를 참고하십시오.
export type CominsColumnFilterRule = CominsColumnConditionFilterRule | CominsColumnValueFilterRule;