# valueGetter

원본 행에서 계산한 셀 값을 반환합니다. 단순 표시 문자열만 바꾸려면 valueFormatter를 사용합니다.

Canonical: https://grid.syidax.com/ko/docs/columns/valueGetter/

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

## 무엇을 하는 API인가요

원본 행에서 계산한 셀 값을 반환합니다. 단순 표시 문자열만 바꾸려면 valueFormatter를 사용합니다.

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

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

```typescript
valueGetter?: GridCallback<[ValueGetterParams<TData, TValue, TContext>], TValue> | string
```

| 항목 | 값 |
| --- | --- |
| 필수 여부 | 선택 |
| 입력 타입 | GridCallback<[ValueGetterParams<TData, TValue, TContext>], TValue> \| string |

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

## 사용 흐름

이 항목은 columnDefs 배열 안의 개별 열 객체에 설정합니다. 배열·객체·콜백 함수는 JavaScript로 전달하고, 변경을 반영할 때 새 배열이나 객체를 사용하세요.

<a id="types"></a>

## 관련 타입 읽기

- [GridCallback](https://grid.syidax.com/ko/docs/types/GridCallback.md)
- [ValueGetterParams](https://grid.syidax.com/ko/docs/types/ValueGetterParams.md)

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

## 기능별 설명과 예제

- [계산과 표시 분리](https://grid.syidax.com/ko/docs/features/value-getter-formatter.md) — valueGetter는 실제 계산값을 만들고 valueFormatter는 화면에 읽기 좋은 문자열을 만듭니다. 합계·정렬·비교에 숫자가 필요하면 getter는 숫자를 반환해야 합니다.