# viewportDatasource

현재 화면에 보이는 행 범위에 맞춰 데이터를 공급하는 뷰포트 모델입니다. 초기화·범위 변경·정리를 구현합니다.

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

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

## 무엇을 하는 API인가요

현재 화면에 보이는 행 범위에 맞춰 데이터를 공급하는 뷰포트 모델입니다. 초기화·범위 변경·정리를 구현합니다.

Pro 기능 관련 API: Viewport row model

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

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

```typescript
viewportDatasource: ViewportDatasource<GridRow>
```

| 항목 | 값 |
| --- | --- |
| JavaScript 이름 | viewportDatasource |
| HTML 속성 | viewport-datasource |
| 기본값 | undefined |
| 입력 타입 | ViewportDatasource<GridRow> |

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

## 사용 흐름

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

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

## 관련 타입 읽기

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

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

## 기능별 설명과 예제

- [보이는 구간을 스트리밍](https://grid.syidax.com/ko/docs/features/viewport-row-model.md) — 전체 데이터 개수는 알지만 현재 보이는 행만 지속 갱신하려는 시세·모니터링 화면에 적합합니다. 스크롤 범위에 맞춰 구독 범위를 바꾸는 것이 핵심입니다.