# 명령 팔레트

## Content

SpreadJS 디자이너의 \*\*명령 팔레트(Command Palette)\*\*의 핵심 장점은 작업 효율성을 크게 향상시킨다는 점입니다. 복잡한 다단계 메뉴를 탐색하는 대신, 사용자는 단축키(**Ctrl/Cmd+P**)를 눌러 명령 팔레트를 불러오고, “셀 병합”이나 “데이터 유효성 검사” 같은 키워드를 입력해 즉시 명령을 실행할 수 있어, 작업 단계를 줄이고 시간을 절약할 수 있습니다.
이 기능은 특히 수식 편집이나 일괄 스타일 적용과 같은 빈번하고 복잡한 작업에 매우 유용합니다. 키보드 중심의 탐색과 지능형 검색을 통해 인터페이스 전환으로 인한 방해를 최소화하고, 사용자가 핵심 작업에 집중할 수 있도록 도와주어 스프레드시트 설계 및 데이터 처리 속도를 높여줍니다.

## 구성

커맨드 팔레트는`GC.Spread.Sheets.Designer.DefaultConfig`를 통해 디자이너 레이아웃에 통합되어 있습니다. 설정에서 팝업 사이드 패널로 등록되어 있습니다.

```javascript
GC.Spread.Sheets.Designer.DefaultConfig = {
  // ...
  sidePanels: [
    // ...
    {
      /**
       * Displays the panel as a popup modal.
       */
      position: 'popup',
      command: GC.Spread.Sheets.Designer.CommandNames.CommandPalettePanel,
      uiTemplate: GC.Spread.Sheets.Designer.TemplateNames.CommandPaletteTemplate,
    }
  ]
};
```

## 명령 팔레트 여는 방법

![1.7cf273.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/216c2e7e-5246-4c37-8843-3854aa344a6a/1.7cf273.b6d0fc.png?width=800)

### **1\. 기본 단축키 \(**`Ctrl/Cmd + P`**)​**​

명령 팔레트를 즉시 열려면 ​**​**`Ctrl + P`**​**​ (Windows) 또는 ​**​**`Cmd + P`**​**​ (Mac)를 누르세요.

### **2\. 리본 버튼​**​

명령 팔레트는 리본의 **보기 탭**에서도 접근할 수 있습니다.
![2.fb6777.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/216c2e7e-5246-4c37-8843-3854aa344a6a/2.fb6777.1e3a12.png?width=800)

## 사용자 인터페이스 및 상호작용

### ​**​**검색 및 실행**​**​

* ​**​검색 필드​**​: 명령어를 필터링하려면 키워드를 입력하세요 (`title`, `text`, `tip` 및`name`을 검색합니다.)
* **​​키보드 탐색​​**

| 단축키 | 동작 |
| --- | --- |
| ​**​위 / 아래 화살표​**​ | 선택 항목을 위/아래로 이동 |
| ​**​엔터​**​ | 선택한 명령 실행 |
| ​**​Esc​**​ | <ol><li>목록 항목에 포커스가 있을 때 Esc 키를 누르면 포커스가 검색창으로 이동합니다.</li><li>검색창에 포커스가 있을 때 Esc 키를 누르면 명령 팔레트가 닫힙니다.</li><li>하위 메뉴 드롭다운에 포커스가 있을 때 Esc 키를 누르면:<ul><li>현재 하위 메뉴가 닫히고</li><li>포커스가 검색창으로 이동합니다.</li></ul></li></ol> |
| ​**​Backspace​**​ | 검색 태그 제거 |

![2.0807b9.gif](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/216c2e7e-5246-4c37-8843-3854aa344a6a/2.0807b9.bf480d.gif?width=800)
![3.e5dd26.gif](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/216c2e7e-5246-4c37-8843-3854aa344a6a/3.e5dd26.c72963.gif?width=800)

### 지원되는 명령어들

명령 팔레트는 다음을 검색합니다:

1. **모든 리본 명령어**
2. ​​**숨겨진 명령어​​** (예, `GC.Spread.Sheets.Designer.CommandNames.Background`)
3. ​다음에 정의된 **사용자 지정 명령어** `GC.Spread.Sheets.DefaultConfig.commandMap`
    1. 커맨드 팔레트에서 명령 타입을 사용자 정의하는 것은 현재 일부 내장 타입만 지원합니다.
**지원되는 명령 타입:** `button`, `RibbonList`, `checkbox`, `colorPicker`, `dropdown`, `comboBox`, `SparklineColorPicker`, `editableSelect`, `ThemeSetting`, `ThemeFonts`, `ThemeColors`, `FileMenuButton`, `dbclickCheckbox`, `listContent`, `chartFormat`, 그리고 타입 없음(기본적으로 버튼 컴포넌트로 표시됨)