Core 셀 값·표현

comins-table@0.2.2React

0.2.0: 이 페이지의 타입과 helper는 루트 comins-table의 React 상태 계약입니다. 중립 /core는 별도 타입 계약을 사용합니다. 마이그레이션 가이드에서 import 경로와 셀 정책 차이를 확인합니다.

사용자 렌더러에서 값·format·셀 props를 계산할 때 사용하는 함수입니다. 값 조회와 셀 컴포넌트 렌더링을 구분합니다.

getCominsCellValue

export declare function getCominsCellValue<TData>(state: CominsTableState<TData>, row: TData, columnId: string): unknown;

컬럼 field의 점 경로를 따라 원시 값을 읽습니다. 컬럼이 없거나 경로가 없으면 undefined입니다.

formatCominsCellValue

export declare function formatCominsCellValue<TData>(state: CominsTableState<TData>, row: TData, rowId: CominsRowId, column: CominsTableRuntimeColumn<TData>): import("react").ReactNode;

cell.format이 있으면 공통 셀 payload로 호출합니다. 없으면 null/undefined는 빈 문자열, 나머지는 String(value)입니다. cell.renderer나 components를 실행하지 않습니다.

isCominsCellDisabled

export declare function isCominsCellDisabled<TData>(state: CominsTableState<TData>, row: TData, rowId: CominsRowId, column: CominsTableRuntimeColumn<TData>): boolean;

해당 행에서 cell.props와 disabled의 함수형 값을 해석하여 true인지 반환합니다.

getCominsCellClassName

export declare function getCominsCellClassName<TData>(state: CominsTableState<TData>, row: TData, rowId: CominsRowId, column: CominsTableRuntimeColumn<TData>): string | undefined;

cell.props.className의 정적 문자열 또는 payload 함수를 해석합니다. 없으면 undefined입니다.

getCominsCellStyle

export declare function getCominsCellStyle<TData>(state: CominsTableState<TData>, row: TData, rowId: CominsRowId, column: CominsTableRuntimeColumn<TData>): import("react").CSSProperties | undefined;

cell.props.style의 정적 객체 또는 payload 함수를 해석합니다. 없으면 undefined입니다.

CominsCellFormatParams

export type CominsCellFormatParams<TData, TValue = unknown> = {
    column: CominsTableRuntimeColumn<TData, TValue>;
    row: TData;
    rowId: CominsRowId;
    value: TValue;
};

속성	동작·기본값
`column`	런타임 컬럼 정의.
`row`	업무 행 데이터. 공통 component payload의 row wrapper와 다릅니다.
`rowId`	행 ID.
`value`	셀 값.

CominsColumnValueResolver

export type CominsColumnValueResolver<TData, TValue> = TValue | ((params: CominsCellFormatParams<TData, TValue>) => TValue);

정적 TValue 또는 CominsCellFormatParams를 받아 TValue를 계산하는 함수의 공개 타입입니다. 현재 cell.format 콜백은 더 풍부한 CominsCellComponentPayload를 사용합니다.

CominsClipboardGuard

export type CominsClipboardGuard<TData, TValue = unknown> = boolean | ((params: CominsCellComponentPayload<TData, TValue>) => boolean);

disabled/copyable/pasteable의 boolean 또는 셀 payload 판정 함수입니다. 셀이 disabled이면 copyable/pasteable보다 우선하여 복사·붙여넣기를 차단합니다.