# replaceGridComponent

등록된 사용자 컴포넌트 정의를 교체합니다.

Canonical: https://grid.syidax.com/ko/docs/methods/replaceGridComponent/

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

## 무엇을 하는 API인가요

등록된 사용자 컴포넌트 정의를 교체합니다.

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

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

```typescript
replaceGridComponent<TKind extends GridComponentKind>(scope: GridComponentRegistrationScope, kind: TKind, name: string, definition: GridComponentDefinitionFor<
      TKind,
      GridData,
      unknown,
      unknown,
      unknown
    >): Promise<void>
```

| 인수 | 필수 여부 | 타입 |
| --- | --- | --- |
| scope | 필수 | GridComponentRegistrationScope |
| kind | 필수 | TKind |
| name | 필수 | string |
| definition | 필수 | GridComponentDefinitionFor<<br>      TKind,<br>      GridData,<br>      unknown,<br>      unknown,<br>      unknown<br>    > |

반환 타입은 `Promise<void>`입니다.

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

## 사용 흐름

등록과 초기화를 마친 Grid 요소에서 grid.replaceGridComponent(…)를 호출합니다. 반환값은 await로 읽으세요. boolean이나 보고서를 반환하는 메서드는 결과를 확인한 뒤 다음 작업을 진행합니다.

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

## 관련 타입 읽기

- [GridComponentKind](https://grid.syidax.com/ko/docs/types/GridComponentKind.md)
- [GridComponentRegistrationScope](https://grid.syidax.com/ko/docs/types/GridComponentRegistrationScope.md)
- [GridComponentDefinitionFor](https://grid.syidax.com/ko/docs/types/GridComponentDefinitionFor.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) — 셀 렌더러는 데이터의 표시 방법을 바꿉니다. 상태 배지·링크·액션 버튼이 필요한 경우 사용하되 정렬·필터에 사용할 원본 값은 별도로 유지합니다.