# Sheet (Beta)

<figure><img src="https://2124792335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSGiM6UdbWlqrZA6kPT9b%2Fuploads%2FP7794oaFmdMGlmq49kZq%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-02-26%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%203.17.34.png?alt=media&#x26;token=f84f96aa-2d17-40b9-9847-f1993a3fd2a8" alt="" width="155"><figcaption></figcaption></figure>

## 컨트롤 설명

스프레드 시트형태로 데이터를 보여주고 추가 및 수정을 할 수 있는 컨트롤입니다.

이 컨트롤은 기존 방식과 다르게 동작하며, 데이터 변경과 반영 방식에 특징이 있습니다.

{% hint style="info" %}
**데이터 반영 방식:**\
시트에서 발생한 변경사항은 먼저 시트에서 카테고리로 적용됩니다.\
스크립트나 별도 로직을 통한 섹터 값 변경은 시트를 다시 그려야 반영됩니다.

**컬럼 Change 이벤트:**\
컬럼의 콜렉션키(또는 표시될 콜렉션키)를 기준으로, 행 데이터의 해당 키에 변경이 있으면 Change 이벤트가 발생합니다.\
동일 콜렉션키를 공유하는 컬럼의 경우, 하나의 변경이 여러 컬럼에서 동시에 이벤트를 발생시킬 수 있습니다.
{% endhint %}

## 디자인(Design) 모드

<div><figure><img src="https://2124792335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSGiM6UdbWlqrZA6kPT9b%2Fuploads%2FKALLGbpbRfWk6yErMktO%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-02-20%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%202.13.52.png?alt=media&#x26;token=d1bd635b-0a2e-48b0-89ed-6467a3c9cb21" alt=""><figcaption><p>시트 컨트롤</p></figcaption></figure> <figure><img src="https://2124792335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSGiM6UdbWlqrZA6kPT9b%2Fuploads%2FgjkktFnauDYpr1HDdB0J%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-02-20%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%202.27.45.png?alt=media&#x26;token=98b702f0-cb0c-4e2f-8dd9-bdc484cbbce0" alt=""><figcaption><p>컬럼 컨트롤</p></figcaption></figure></div>

### 디자인 속성

**행 높이**

행의 기본 높이를 지정할 수 있습니다.

**컬럼 명**

시트에 보여질 컬럼명칭을 지정할 수 있습니다.

### 공통 디자인 속성

<table data-view="cards"><thead><tr><th></th><th data-hidden></th><th data-hidden></th><th data-hidden data-type="content-ref"></th></tr></thead><tbody><tr><td><a href="../../design-mode/control-name">컨트롤 명</a></td><td></td><td></td><td></td></tr><tr><td><a href="../../design-mode/width-height">너비 높이</a></td><td></td><td></td><td><a href="../../design-mode/width-height">width-height</a></td></tr><tr><td><a href="../../design-mode/text">텍스트</a></td><td></td><td></td><td></td></tr></tbody></table>

### 컬럼 컨트롤 속성 변경

{% hint style="info" %}
시트의 컬럼 컨트롤은 우측에서 각각의 속성을 변경하여 수정할 수 있습니다.
{% endhint %}

<figure><img src="https://2124792335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSGiM6UdbWlqrZA6kPT9b%2Fuploads%2FEQlOjYIc5ovVU5TYMzWB%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-02-20%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%202.32.52.png?alt=media&#x26;token=9fa52a34-9ad1-41ab-b4fe-94e621c7827a" alt=""><figcaption><p>컬럼 컨트롤</p></figcaption></figure>

## 개발(Dev) 모드

<figure><img src="https://2124792335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSGiM6UdbWlqrZA6kPT9b%2Fuploads%2FdyE5VBXpLUKJO9iQ5tMD%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-02-20%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%202.48.42.png?alt=media&#x26;token=3fb23be8-ec5b-46f7-be6b-a400858bd32c" alt=""><figcaption><p>시트 컨트롤</p></figcaption></figure>

**최소 행 수**

시트가 처음 렌더링될 때, 화면에 최소한으로 표시될 행의 수를 지정합니다.

**최소 빈행 수**

데이터 입력 및 편집을 원활하게 하기 위해 항상 유지할 빈 행의 최소 개수를 설정합니다.

**컬럼 이동 사용**

사용자가 드래그 앤 드롭 방식으로 컬럼의 순서를 변경할 수 있도록 허용하는 기능을 활성화합니다.

**열 너비 조정 사용**

사용자가 열의 너비를 직접 조절할 수 있도록 하는 기능의 활성화 여부를 지정합니다.

**행 너비 조정 사용**

사용자가 행의 높이나 너비(레이아웃)를 조정할 수 있도록 지원하는 기능을 설정합니다.

**행 상태값 사용**

행 번호 영역에 작업 상태를 표시하는 상태값(A: 추가된 행 또는 빈 행, U: 수정된 행)을 노출할지 여부를 결정합니다.

**행 삭제 사용**

마우스 우클릭을 통한 컨텍스트 메뉴에서 행 삭제 기능을 사용할 수 있도록 허용하는 옵션입니다.

### Data

**카테고리명**

컬렉션에서 해당 카테고리명으로 된 데이터를 연결해줍니다.

**상위 데이터 연결과 연결관계 설정**

시트에 보여줄 데이터를 연결관계 설정에 맞게 필터해서 보여줍니다.

{% hint style="info" %}
[\[심화\] 카테고리 연결관계](https://docs.flextudio.com/flextudio/concept/undefined)에서 연결관계에 대한 이해를 도울 수 있습니다.
{% endhint %}

### 컬럼 컨트롤 설정

{% hint style="info" %}
컬럼 컨트롤은 **시트 내에서 추가되는 컨트롤**로, 기존 컨트롤과 비교하여 **일부 설정 속성이 제한되거나 추가된 기능이 존재합니다.**
{% endhint %}

**컬럼 명**

시트에 표시될 컬럼의 제목을 설정할 수 있습니다.

**컬럼타입**

컬럼의 타입을 지정할 수 있습니다.

InputText, InputSearch, InputNumber, InputMask, InputDate, ComboBox, CheckBox, Button 지원

**컬럼 추가**

컬럼을 추가합니다.

**컬럼단위 정렬 사용**\
각 컬럼별로 정렬 기능을 활성화하여, 사용자가 원하는 순서로 데이터를 정렬할 수 있는 옵션입니다.

**Data (콜렉션 키)**\
컬럼에 표시될 데이터의 키 값을 지정합니다.\
이 키를 기반으로 행 데이터에서 변경사항이 반영됩니다.

**표시될 콜렉션키 추가**\
컬럼에 표시될 데이터의 키 값을 지정합니다.

**Event**

| 컬럼 타입       | Change | Click | dblClick |
| ----------- | ------ | ----- | -------- |
| inputText   | ✔️     |       | ✔️       |
| inputNumber | ✔️     |       | ✔️       |
| inputMask   | ✔️     |       | ✔️       |
| inputDate   | ✔️     |       |          |
| inputSearch | ✔️     |       |          |
| Combo       | ✔️     |       |          |
| button      |        | ✔️    |          |
| checkBox    | ✔️     |       |          |

### 컬럼 컨트롤 개발 속성

컬럼 컨트롤의 속성들에 대한 자세한 설명은 각 컨트롤 페이지를 참고하세요.

<table data-view="cards"><thead><tr><th></th></tr></thead><tbody><tr><td><a href="inputtext">inputText</a></td></tr><tr><td><a href="inputnumber">inputNumber</a></td></tr><tr><td><a href="inputmask">inputMask</a></td></tr><tr><td><a href="inputdate">inputDate</a></td></tr><tr><td><a href="inputsearch">inputSearch</a></td></tr><tr><td><a href="combobox">Combo</a></td></tr><tr><td><a href="button">button</a></td></tr><tr><td><a href="checkbox">checkBox</a></td></tr></tbody></table>

### 공통 개발 속성

<table data-view="cards"><thead><tr><th></th><th data-hidden></th><th data-hidden></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><a href="../../dev-mode/component/status">컨트롤 상태</a></td><td></td><td></td><td></td></tr><tr><td><a href="../../../reference/voca/authkey">권한키</a></td><td></td><td></td><td></td></tr></tbody></table>
