# components

이 Grid에서 사용할 사용자 정의 렌더러·편집기·필터 등의 로컬 컴포넌트 정의를 등록합니다.

Canonical: https://grid.syidax.com/ko/docs/options/components/

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

## 무엇을 하는 API인가요

이 Grid에서 사용할 사용자 정의 렌더러·편집기·필터 등의 로컬 컴포넌트 정의를 등록합니다.

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

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

```typescript
components: GridComponentLocalDefinitions<
    GridData,
    unknown,
    unknown,
    unknown
  >
```

| 항목 | 값 |
| --- | --- |
| JavaScript 이름 | components |
| HTML 속성 | components |
| 기본값 | undefined |
| 입력 타입 | GridComponentLocalDefinitions<<br>    GridData,<br>    unknown,<br>    unknown,<br>    unknown<br>  > |

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

## 사용 흐름

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

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

## 관련 타입 읽기

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

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

## 기능별 설명과 예제

- [셀 표현 바꾸기](https://grid.syidax.com/ko/docs/features/custom-cells.md) — 셀 렌더러는 데이터의 표시 방법을 바꿉니다. 상태 배지·링크·액션 버튼이 필요한 경우 사용하되 정렬·필터에 사용할 원본 값은 별도로 유지합니다.