핵심 기능

Headless 지원

Univer Sheets의 핵심 기능에는 스프레드시트 편집기, 수식 엔진, 렌더링 엔진, 숫자 서식 엔진, 디자인 시스템, UI 컴포넌트 라이브러리가 포함됩니다. 이 기능들은 다양한 형식과 복잡한 작업을 지원하는 강력한 스프레드시트 처리 플랫폼을 구성합니다.

기능

Univer Sheets의 핵심 기능은 다음과 같습니다.

  • 스프레드시트 렌더링: 커서와 선택 영역 표시를 포함하여 Univer Sheets 렌더링을 지원합니다.
  • 셀 스타일: 글꼴, 색상, 테두리, 맞춤 등 스프레드시트 셀의 스타일을 지정할 수 있습니다.
  • 수식 계산: 수학, 통계, 텍스트, 날짜 함수를 비롯한 거의 모든 Excel 함수를 추가하고 계산할 수 있습니다.
  • 숫자 서식: 통화, 백분율, 날짜 등 스프레드시트의 숫자 서식을 지정할 수 있습니다.
  • 눈금선 및 틀 고정: 눈금선 표시와 틀 고정을 지원하여 대규모 데이터도 쉽게 보고 편집할 수 있습니다.
  • 기본 스타일: 기본 글꼴, 크기, 색상 등 스프레드시트의 기본 스타일을 설정할 수 있습니다.
  • 플러그인 시스템: 수식, 이미지, 차트 등의 사용자 지정 플러그인을 지원합니다. 이는 Univer 핵심 아키텍처의 주요 기능이기도 합니다.

플러그인 모드

설치

Shell
pnpm add @univerjs/core @univerjs/design @univerjs/engine-render @univerjs/engine-formula @univerjs/ui @univerjs/docs @univerjs/docs-ui @univerjs/sheets @univerjs/sheets-ui @univerjs/sheets-formula @univerjs/sheets-formula-ui @univerjs/sheets-numfmt @univerjs/sheets-numfmt-ui

사용법

TypeScript
import { LocaleType, mergeLocales, Univer } from '@univerjs/core'import DesignEnUS from '@univerjs/design/locale/en-US'import { UniverDocsPlugin } from '@univerjs/docs'import { UniverDocsUIPlugin } from '@univerjs/docs-ui'import DocsUIEnUS from '@univerjs/docs-ui/locale/en-US'import { UniverFormulaEnginePlugin } from '@univerjs/engine-formula'import { UniverRenderEnginePlugin } from '@univerjs/engine-render'import { UniverSheetsPlugin } from '@univerjs/sheets'import { UniverSheetsFormulaPlugin } from '@univerjs/sheets-formula'import { UniverSheetsFormulaUIPlugin } from '@univerjs/sheets-formula-ui'import SheetsFormulaUIEnUS from '@univerjs/sheets-formula-ui/locale/en-US'import { UniverSheetsNumfmtPlugin } from '@univerjs/sheets-numfmt'import { UniverSheetsNumfmtUIPlugin } from '@univerjs/sheets-numfmt-ui'import SheetsNumfmtUIEnUS from '@univerjs/sheets-numfmt-ui/locale/en-US'import { UniverSheetsUIPlugin } from '@univerjs/sheets-ui'import SheetsUIEnUS from '@univerjs/sheets-ui/locale/en-US'import SheetsEnUS from '@univerjs/sheets/locale/en-US'import { UniverUIPlugin } from '@univerjs/ui'import UIEnUS from '@univerjs/ui/locale/en-US'import '@univerjs/design/lib/index.css'import '@univerjs/ui/lib/index.css'import '@univerjs/docs-ui/lib/index.css'import '@univerjs/sheets-ui/lib/index.css'import '@univerjs/sheets-formula-ui/lib/index.css'import '@univerjs/sheets-numfmt-ui/lib/index.css'import '@univerjs/engine-formula/facade'import '@univerjs/ui/facade'import '@univerjs/docs-ui/facade'import '@univerjs/sheets/facade'import '@univerjs/sheets-ui/facade'import '@univerjs/sheets-formula/facade'import '@univerjs/sheets-numfmt/facade'const univer = new Univer({  locale: LocaleType.EN_US,  locales: {    [LocaleType.EN_US]: mergeLocales(      DesignEnUS,      UIEnUS,      DocsUIEnUS,      SheetsEnUS,      SheetsUIEnUS,      SheetsFormulaUIEnUS,      SheetsNumfmtUIEnUS,    ),  },})univer.registerPlugin(UniverRenderEnginePlugin)univer.registerPlugin(UniverFormulaEnginePlugin)univer.registerPlugin(UniverUIPlugin, {  container: 'app',})univer.registerPlugin(UniverDocsPlugin)univer.registerPlugin(UniverDocsUIPlugin)univer.registerPlugin(UniverSheetsPlugin)univer.registerPlugin(UniverSheetsUIPlugin)univer.registerPlugin(UniverSheetsFormulaPlugin)univer.registerPlugin(UniverSheetsFormulaUIPlugin)univer.registerPlugin(UniverSheetsNumfmtPlugin)univer.registerPlugin(UniverSheetsNumfmtUIPlugin)

플러그인 및 구성

@univerjs/core

이 플러그인은 Univer의 핵심 라이브러리로, Univer 인스턴스 생성, 테마, 언어 등의 기본 기능을 제공합니다.

TypeScript
interface UniverParameter {  // Univer instance theme, default is `defaultTheme`  theme: IStyleSheet  // Whether to use dark mode, default is false  darkMode?: boolean  // The locale of the Univer instance  locale: LocaleType  // The locale objects to use, with keys as locale types and values as corresponding locale objects  locales: ILocales  // The log level of the Univer instance  logLevel?: LogLevel}

참고: Univer

@univerjs/engine-render

이 플러그인은 Univer의 렌더링 엔진으로, 렌더링, 스크롤바, 커서 및 선택 영역 렌더링을 담당하며 UniverRenderEnginePlugin을 제공합니다.

참고: @univerjs/engine-render

@univerjs/engine-formula

이 플러그인은 Univer의 수식 엔진으로, 수식 계산과 처리를 담당하며 UniverFormulaEnginePlugin을 제공합니다.

참고: @univerjs/engine-formula

@univerjs/design

이 플러그인은 Univer의 디자인 시스템으로, 모든 기본 컴포넌트와 스타일을 제공합니다.

참고: UI 장

@univerjs/ui

이 플러그인은 Univer의 UI 기반이며 UniverUIPlugin을 제공합니다.

UniverUIPlugin은 기본 레이아웃을 구성하는 데 사용할 수 있는 여러 옵션을 제공합니다.

TypeScript
interface IUniverUIConfig {  // Container element, can be a string or a DOM element  container?: string | HTMLElement  // Whether to show the header  header?: boolean  // Whether to show the header toolbar  toolbar?: boolean  // The type of the header toolbar. 'classic': default classic mode; 'grid': two-row grid mode; 'collapsed': compact mode; 'simple': ungrouped mode  ribbonType?: RibbonType  // Whether to show the context menu  contextMenu?: boolean  // Whether to disable auto focus  disableAutoFocus?: true  // Dependency injection override configuration  override?: DependencyOverride  // Menu configuration  menu?: MenuConfig}

menu 구성 옵션을 사용하면 특정 메뉴 항목의 표시 또는 숨김 상태를 간단히 설정할 수 있습니다.

TypeScript
univer.registerPlugin(UniverSheetsUIPlugin, {  menu: {    'sheet.command.set-range-bold': {      hidden: true,    },    'sheet.command.set-range-italic': {      hidden: true,      disabled: true,    },  },})

여기서 'sheet.command.set-range-bold'와 'sheet.command.set-range-italic'은 해당 메뉴 항목의 ID입니다. 아래의 메뉴 항목 ID 목록을 참고하세요.

참고: @univerjs/ui

@univerjs/docs

이 플러그인은 Univer Docs의 핵심 플러그인이며 UniverDocsPlugin을 제공합니다.

참고: @univerjs/docs

@univerjs/docs-ui

이 플러그인은 문서 편집기의 UI 컴포넌트와 상호작용을 포함하는 Univer Docs UI 플러그인이며 UniverDocsUIPlugin을 제공합니다.

참고: @univerjs/docs-ui

@univerjs/sheets

이 플러그인은 스프레드시트 편집기의 핵심 기능을 제공하는 Univer Sheets 핵심 플러그인이며 UniverSheetsPlugin을 제공합니다.

UniverSheetsPlugin은 스프레드시트 편집기 구성에 사용할 수 있는 여러 옵션을 제공합니다.

TypeScript
interface IUniverSheetsConfig {  // If both row style and column style are set, whether row style precedes column style  isRowStylePrecedeColumnStyle?: boolean  // Whether auto height applies to merged cells  autoHeightForMergedCells?: boolean  /**   * Whether synchronize the frozen state to other users in real-time collaboration.   * @default true   */  freezeSync?: boolean}

참고: @univerjs/sheets

@univerjs/sheets-ui

이 플러그인은 스프레드시트 편집기의 UI 컴포넌트와 상호작용을 포함하는 Univer Sheets UI 플러그인이며 UniverSheetsUIPlugin을 제공합니다.

UniverSheetsUIPlugin은 스프레드시트 편집기 UI 구성에 사용할 수 있는 여러 옵션을 제공합니다.

TypeScript
interface IUniverSheetsUIConfig {  // Whether to show the footer.  footer?:    | false    | {        // The sheet bar is the sub-sheet manager, including adding/switching/deleting sub-sheets.        sheetBar?: boolean        // The statistic bar includes statistics of the current selection, such as count, sum, average, etc.        statisticBar?: boolean        // The bottom menu includes options like highlight, gridlines, etc.        menus?: boolean        // The zoom slider at the bottom.        zoomSlider?: boolean        /**         * The config of the add sheet button in the sheet bar.         */        addSheetButtonConfig?: {          /**           * Whether to show the add sheet button in the sheet bar.           * When `footer` or `footer.sheetBar` is false, this config will not work because the sheet bar will not be rendered.           * @default true           */          show?: boolean          /**           * The default row count of the new sheet created by the add sheet button.           * @default 1000           */          defaultRowCount?: number          /**           * The default column count of the new sheet created by the add sheet button.           * @default 20           */          defaultColumnCount?: number        }      }  // Whether to show the formula bar  formulaBar?: boolean  clipboardConfig?: {    // Whether to show the paste options button after paste operation    hidePasteOptions?: boolean  }  // The configuration for the scroll bar  scrollConfig?: IScrollBarProps  /**   * Strategy for showing the protected range shadow.   * - true or 'always': Show shadow for all protected ranges (default behavior)   * - 'non-editable': Only show shadow for ranges that cannot be edited (Edit permission is false)   * - 'non-viewable': Only show shadow for ranges that cannot be viewed (View permission is false)   * - false or 'none': Never show shadow for protected ranges   * @default true   */  protectedRangeShadow?: boolean | 'always' | 'non-editable' | 'non-viewable' | 'none'  // Whether to disable the force string alert.  disableForceStringAlert?: boolean  // Whether to disable the force string mark.  disableForceStringMark?: boolean}

참고: @univerjs/sheets-ui

모바일 지원

먼저 모바일 에디터를 구성하세요. 이 페이지의 플러그인 모드 초기화 코드에서 아래 데스크톱 등록을 같은 패키지의 모바일 버전으로 바꾸고 문서를 열기 전에 완료하세요. 모델 플러그인, 스타일, 언어 파일과 Facade 가져오기는 유지하며 두 버전을 동시에 등록하지 마세요.

패키지데스크톱 등록모바일 등록
@univerjs/sheets-formula-uiUniverSheetsFormulaUIPluginUniverSheetsFormulaMobileUIPlugin
@univerjs/sheets-numfmt-uiUniverSheetsNumfmtUIPluginUniverSheetsNumfmtMobileUIPlugin

프리셋 모드

설치

Shell
pnpm add @univerjs/presets @univerjs/preset-sheets-core

사용법

TypeScript
import { UniverSheetsCorePreset } from '@univerjs/preset-sheets-core'import UniverPresetSheetsCoreEnUS from '@univerjs/preset-sheets-core/locales/en-US'import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'import '@univerjs/preset-sheets-core/lib/index.css'const { univerAPI } = createUniver({  locale: LocaleType.EN_US,  locales: {    [LocaleType.EN_US]: mergeLocales(UniverPresetSheetsCoreEnUS),  },  presets: [UniverSheetsCorePreset()],})univerAPI.createWorkbook({})

프리셋 및 구성

@univerjs/presets

이 프리셋은 Univer 애플리케이션을 만드는 createUniver 메서드를 제공하고, @univerjs/core와 @univerjs/design의 모든 메서드와 객체를 노출합니다.

createUniver 메서드는 테마, 언어, 프리셋 등의 옵션이 포함된 구성 객체를 받습니다. Facade API 호출에 사용할 Univer 인스턴스 univer와 FUniver 인스턴스 univerAPI를 반환합니다.

TypeScript
interface CreateUniverParameter {  // Univer instance theme, default is `defaultTheme`  theme: IStyleSheet  // Whether to use dark mode, default is false  darkMode?: boolean  // The locale of the Univer instance  locale: LocaleType  region?: LocaleType  // The locale objects to use, with keys as locale types and values as corresponding locale objects  locales: ILocales  // The log level of the Univer instance  logLevel?: LogLevel  // The list of presets to use.  presets: IPresets[]  // The list of plugins to use.  plugins: IPlugins[]}

참고: createUniver

@univerjs/preset-sheets-core

이 프리셋은 Univer Sheets의 핵심 프리셋으로, 문서 편집기, 수식 엔진, 렌더링 엔진 등 문서 편집에 필요한 핵심 기능을 포함합니다.

TypeScript
interface IUniverSheetsCorePresetConfig {  // Container element, can be a string or a DOM element  container?: string | HTMLElement  // Whether to show the header  header?: boolean  // Whether to show the header toolbar  toolbar?: boolean  // The type of the header toolbar. 'classic': default classic mode; 'grid': two-row grid mode; 'collapsed': compact mode; 'simple': ungrouped mode  ribbonType?: RibbonType  // Whether to show the footer  footer?:    | false    | {        // Sheet bar is the sub-sheet manager, including adding/switching/deleting sub-sheets.        sheetBar?: boolean        // Statistic bar includes statistics of the current selection, such as count, sum, average, etc.        statisticBar?: boolean        // The bottom menu includes options like highlight, gridlines, etc.        menus?: boolean        // The zoom slider at the bottom.        zoomSlider?: boolean        /**         * The config of the add sheet button in the sheet bar.         */        addSheetButtonConfig?: {          /**           * Whether to show the add sheet button in the sheet bar.           * When `footer` or `footer.sheetBar` is false, this config will not work because the sheet bar will not be rendered.           * @default true           */          show?: boolean          /**           * The default row count of the new sheet created by the add sheet button.           * @default 1000           */          defaultRowCount?: number          /**           * The default column count of the new sheet created by the add sheet button.           * @default 20           */          defaultColumnCount?: number        }      }  // Whether to show the context menu  contextMenu?: boolean  // Whether to disable auto focus  disableAutoFocus?: true  // Menu configuration  menu?: MenuConfig  sheets?: {    // If both row style and column style are set, whether row style precedes column style    isRowStylePrecedeColumnStyle?: boolean    // Whether auto height applies to merged cells    autoHeightForMergedCells?: boolean    /**     * Whether synchronize the frozen state to other users in real-time collaboration.     * @default true     */    freezeSync?: boolean    clipboardConfig?: {      // Whether to show the paste options button after paste operation      hidePasteOptions?: boolean    }    // The configuration for the scroll bar    scrollConfig?: IScrollBarProps    /**     * Strategy for showing the protected range shadow.     * - true or 'always': Show shadow for all protected ranges (default behavior)     * - 'non-editable': Only show shadow for ranges that cannot be edited (Edit permission is false)     * - 'non-viewable': Only show shadow for ranges that cannot be viewed (View permission is false)     * - false or 'none': Never show shadow for protected ranges     * @default true     */    protectedRangeShadow?: boolean | 'always' | 'non-editable' | 'non-viewable' | 'none'    // Whether to disable the force string alert.    disableForceStringAlert?: boolean    // Whether to disable the force string mark.    disableForceStringMark?: boolean  }  // ... More configuration options}

menu 구성 옵션을 사용하면 특정 메뉴 항목의 표시 또는 숨김 상태를 간단히 설정할 수 있습니다.

TypeScript
UniverSheetsCorePreset({  menu: {    'sheet.command.set-range-bold': {      hidden: true,    },    'sheet.command.set-range-italic': {      hidden: true,      disabled: true,    },  },})

여기서 'sheet.command.set-range-bold'와 'sheet.command.set-range-italic'은 해당 메뉴 항목의 ID입니다. 아래의 메뉴 항목 ID 목록을 참고하세요.

참고: @univerjs/preset-sheets-core

도구 모음 레이아웃과 RibbonType

IUniverSheetsCorePresetConfig 또는 IUniverUIConfig의 ribbonType 속성을 구성하여 도구 모음 레이아웃을 설정할 수 있습니다.

ribbonType은 다음 네 가지 모드를 지원합니다.

  • classic: 기본 클래식 모드입니다. 그룹은 위쪽에, 도구 모음은 아래쪽에 배치되며 기존 레이아웃에 익숙한 사용자에게 적합합니다.
  • grid: 그리드 모드입니다. 위쪽 탭을 유지하고 아래쪽의 각 도구 그룹을 2행 그리드로 배치하며, 더 많은 도구를 한 번에 표시해야 하는 데스크톱 레이아웃에 적합합니다.
  • collapsed: 컴팩트 모드입니다. 그룹과 도구 모음이 같은 행에 배치되며 세로 공간이 제한된 환경에 적합합니다.
  • simple: 그룹 없는 모드입니다. 모든 도구가 평면 목록으로 배치되며 도구 모음 기능에 익숙한 사용자에게 적합합니다.

grid Ribbon이 컨테이너 너비에 맞지 않으면 그룹 전체가 더 보기 메뉴로 이동해 간결한 배치로 표시됩니다. 너비가 넓어지면 그룹이 돌아옵니다. 가용 너비에 따라 자동 적용되며 기본 Ribbon의 gridLayout 설정을 그대로 사용합니다. 메뉴에서도 같은 명령, 비활성 상태, 권한 검사를 유지합니다.

초기 설정과 런타임 univerAPI.updateMenuConfig()는 같은 menu 구조를 사용합니다. 키는 Ribbon 탭 키(예: ribbon.insert), 그룹 키(예: ribbon.start.format) 또는 메뉴 항목 ID입니다.

order는 같은 수준의 항목을 오름차순으로 정렬합니다. 탭, 탭 안의 그룹, 그룹이나 하위 메뉴 안의 항목에 적용되며 다른 그룹으로 이동시키지는 않습니다. 탭과 그룹 키에는 @univerjs/ui에서 내보내는 RibbonPosition과 그룹 열거형도 사용할 수 있습니다.

초기 설정

사용 중인 모드를 선택하고 기존 초기화 설정에 아래 옵션을 병합하세요. 다른 플러그인, 언어, 테마 및 컨테이너 설정은 유지하고 같은 플러그인을 중복 등록하지 마세요.

TypeScript
import type { MenuConfig } from '@univerjs/ui'const menu: MenuConfig = {  'ribbon.insert': { order: -1 },  'ribbon.start.format': { order: -1 },  'sheet.command.set-range-font-family': {    order: 0,    gridLayout: { row: 1, column: 1, width: 160 },  },}
TypeScript
import { UniverUIPlugin } from '@univerjs/ui'univer.registerPlugin(UniverUIPlugin, {  ribbonType: 'grid',  menu,})

런타임 업데이트

공개 Facade는 변경 사항을 병합하고 UI를 즉시 갱신합니다. 지정하지 않은 속성은 기존 설정이나 Schema 기본값을 유지하며, 나중에 등록되는 메뉴에도 설정이 적용됩니다. 플러그인 모드에서는 먼저 @univerjs/ui/facade를 가져와야 합니다.

TypeScript
import '@univerjs/ui/facade'univerAPI.updateMenuConfig({  'sheet.command.set-range-bold': {    order: 0,    gridLayout: { row: 2, column: 2 },  },  'sheet.command.set-range-italic': {    gridLayout: { row: 2, column: 1 },  },})

gridLayout은 ribbonType: 'grid'일 때만 적용됩니다. 각 그룹은 두 행이며 row와 column은 1부터 시작합니다. 명시한 좌표가 위치를 결정하므로 order만 바꿔서는 좌표가 지정된 버튼을 이동할 수 없습니다. 위치를 교환할 때는 겹치지 않도록 두 버튼을 함께 업데이트하세요. 선택적 필드는 rowSpan, columnSpan, showLabel, width, iconSize이며 크기의 단위는 픽셀입니다. 제약 조건과 기본값은 IRibbonGridLayout을 참고하세요.

사용자 정의 메뉴 배치

createMenu()와 createSubmenu()도 order와 gridLayout을 지원합니다. 하위 메뉴에서는 Ribbon 트리거의 위치를 지정하며 팝업 내부 배치는 바꾸지 않습니다. 다음 예제는 기록 그룹의 세 번째 열에 버튼을 추가합니다.

TypeScript
univerAPI  .createMenu({    id: 'custom-action',    title: 'Custom action',    action: () => console.log('Custom action clicked'),    order: 4,    gridLayout: { row: 1, column: 3, showLabel: true, width: 96 },  })  .appendTo('ribbon.start.history')

아래 표는 데스크톱 메뉴 항목을 위치별로 정리한 목록입니다. 같은 항목이 여러 위치에 표시될 수 있으며, 행 및 열 머리글 메뉴는 일부 셀 컨텍스트 메뉴 항목을 공유합니다. 기능 메뉴에는 해당 플러그인 등록이 필요하며, 표시 여부는 권한과 현재 선택 내용에 따라 달라집니다. 모바일 전용 ID는 마지막 표에 따로 정리했습니다.

메뉴 항목 DOM 요소의 data-u-command 속성에서 ID를 확인할 수 있습니다. menu 설정에는 이 메뉴 항목 ID를 사용하세요. 항목이 실행하는 명령의 ID와 다를 수 있습니다.

도구 모음 메뉴 항목

메뉴 항목 ID메뉴 항목 이름
univer.command.undo실행 취소
univer.command.redo다시 실행
ui.operation.activate-format-painter서식 복사
sheet.command.set-range-bold굵게
sheet.command.set-range-italic기울임꼴
sheet.command.set-range-underline밑줄
sheet.command.set-range-stroke취소선
sheet.command.set-range-font-family글꼴
sheet.command.set-range-fontsize글꼴 size
sheet.command.set-range-text-color텍스트 색
sheet.command.set-background-color채우기 색
sheet.command.set-border-basic테두리
sheet.command.set-horizontal-text-align가로 맞춤
sheet.command.set-vertical-text-align세로 맞춤
sheet.command.set-text-wrap텍스트 줄 바꿈
sheet.command.set-text-rotation텍스트 회전
sheet.command.add-worksheet-merge셀 병합
sheet.command.add-worksheet-merge-all셀 병합 - 모두 병합
sheet.command.add-worksheet-merge-vertical셀 병합 - 세로 병합
sheet.command.add-worksheet-merge-horizontal셀 병합 - 가로 병합
sheet.command.remove-worksheet-merge셀 병합 - 병합 취소
sheet.operation.open.conditional.formatting.panel조건부 서식
formula-ui.operation.insert-function.common자주 쓰는 함수
formula-ui.operation.more-functions함수 - More 함수
sheet.menu.sheets-sort정렬
sheet.command.sort-range-asc정렬 - Ascending
sheet.command.sort-range-asc-ext정렬 - 오름차순 범위 확장
sheet.command.sort-range-desc정렬 - Descending
sheet.command.sort-range-desc-ext정렬 - 내림차순 범위 확장
sheet.command.sort-range-custom정렬 - Custom 정렬
sheet.menu.image이미지
sheet.command.insert-float-image이미지 - Float 이미지
sheet.command.insert-cell-image이미지 - Cell 이미지
sheet.command.numfmt.set.currency통화
sheet.command.numfmt.add.decimal.command소수 자릿수 늘리기
sheet.command.numfmt.subtract.decimal.command소수 자릿수 줄이기
sheet.command.numfmt.set.percent백분율
sheet.operation.open.numfmt.panel숫자 서식
sheet.menu.data-validation데이터 유효성 검사
data-validation.operation.open-validation-panel데이터 유효성 검사 - 데이터 유효성 검사 management
data-validation.command.addRuleAndOpen데이터 유효성 검사 - 규칙 추가
sheet.command.smart-toggle-filter필터 전환
sheet.command.clear-filter-criteria필터 전환 - 필터 조건 지우기
sheet.command.re-calc-filter필터 전환 - 필터 조건 다시 계산
sheet.operation.open-pivot-table-range-selector-panel피벗 테이블
sheet.menu.print인쇄
sheet.operation.print-open인쇄 - 인쇄
sheet.operation.open-print-grid-sidebar인쇄 - 인쇄 Layout
sheet.command.menu-insert-chart차트 삽입
sheet.command.add-range-protection-from-toolbar보호
univer.operation.toggle-edit-history편집 기록
sheet.operation.open-sparkline-selectorSparkline
sheet.operation.toggle-comment-panel댓글 관리
sheet.operation.insert-hyper-link-toolbar링크 삽입
ui.operation.open-find-dialog찾기 및 바꾸기
base-ui.operation.toggle-shortcut-panel단축키 패널 전환
sheet.command.add-data-bar-conditional-rule데이터 막대
sheet.command.add-icon-set-conditional-rule아이콘 집합
sheet.operation.toggle-crosshair-highlight십자선 강조
data-validation.command.insert-quick-rule체크박스
sheet.menu.quick-dropdown목록
sheet.menu.quick-date날짜
sheet.menu.worksheet-background-image배경 이미지
sheet.command.add-worksheet-background-image배경 이미지 추가
sheet.command.delete-worksheet-background-image배경 이미지 삭제
formula-ui.operation.insert-function.financial재무
formula-ui.operation.insert-function.logical논리
formula-ui.operation.insert-function.text텍스트
formula-ui.operation.insert-function.date날짜 및 시간
formula-ui.operation.insert-function.lookup찾기 및 참조
formula-ui.operation.insert-function.math수학 및 삼각 함수
formula-ui.operation.insert-function.statistical통계
formula-ui.operation.insert-function.engineering공학
formula-ui.operation.insert-function.information정보
formula-ui.operation.insert-function.database데이터베이스
sheets-formula-ui.operation.calculation-options계산 옵션
sheet.operation.open-table-selector표
sheet.menu.paste붙여넣기
sheet.command.set-range-font-increase글꼴 크기 증가
sheet.command.set-range-font-decrease글꼴 크기 감소
sheet.command.reset-range-text-color텍스트 색상 - 초기화
sheet.command.reset-background-color채우기 색상 - 초기화
sheet.command.set-shrink-to-fit셀에 맞춤
sheet.toolbar.sheet-frozen고정
sheet.menu.zoom-ratio확대/축소
sheet.command.toggle-gridlines눈금선 표시/숨기기
base-ui.operation.toggle-fullscreen전체 화면
ui.command.clear-formatting서식 지우기
ui.operation.open-feature-search기능 검색
sheet.toolbar.dimension-outline.group그룹
sheet.command.menu-insert-pivot-chart피벗 차트
sheet.pivot-chart.insert피벗 차트
sheet.command.menu-insert-shape도형 삽입
sheet.operation.open-shape-object-list-panel레이어
sheet.operation.open-slicer-insert-dialog슬라이서 삽입
sheet.menu.insert-timeline타임라인 삽입

컨텍스트 메뉴 항목

메뉴 항목 ID메뉴 항목 이름
sheet.command.copy복사
sheet.command.cut잘라내기
sheet.command.paste붙여넣기
sheet.menu.copy-special복사 Special
sheet.command.copy-formula-only선택하여 복사 - 수식만 복사
sheet.menu.paste-special붙여넣기 Special
sheet.command.paste-value붙여넣기 Special - 붙여넣기 Value
sheet.command.paste-format붙여넣기 Special - 붙여넣기 Format
sheet.command.paste-col-width붙여넣기 Special - 붙여넣기 열 너비
sheet.command.paste-besides-border붙여넣기 Special - 붙여넣기 Besides 테두리 Styles
sheet.command.paste-formula붙여넣기 Special - 붙여넣기 Formula
sheet.menu.clear-selection지우기
sheet.command.clear-selection-content지우기 - 지우기 Contents
sheet.command.clear-selection-format지우기 - 지우기 Formats
sheet.command.clear-selection-all지우기 - 지우기 All
sheet.contextMenu.text-to-numberText to Number
sheet.menu.cell-insert삽입
sheet.command.insert-row-before삽입 - 앞에 행 삽입
sheet.command.insert-col-before삽입 - 앞에 열 삽입
sheet.command.insert-range-move-right-confirm삽입 - 오른쪽으로 이동
sheet.command.insert-range-move-down-confirm삽입 - 아래로 이동
sheet.menu.delete삭제
sheet.command.remove-row-confirm선택한 행 삭제
sheet.command.remove-col-confirm선택한 열 삭제
sheet.command.delete-range-move-left-confirm삭제 - 왼쪽으로 이동
sheet.command.delete-range-move-up-confirm삭제 - Move Up
sheet.menu.sheet-frozen고정
sheet.command.set-selection-frozen고정 - 고정
sheet.command.set-row-frozen고정 - 이 행까지 고정
sheet.command.set-col-frozen고정 - 이 열까지 고정
sheet.command.cancel-frozen고정 - 고정 취소
sheet.contextMenu.permission행과 열 보호
sheet.command.add-range-protection-from-context-menu행과 열 보호 - 보호 범위 추가
sheet.command.set-range-protection-from-context-menu행과 열 보호 - 보호 범위 설정
sheet.command.delete-range-protection-from-context-menu행과 열 보호 - 보호 범위 제거
sheet.command.view-sheet-permission-from-context-menu행과 열 보호 - 모든 보호 범위 보기
sheet.menu.sheets-sort-ctx정렬
sheet.command.sort-range-asc-ctx정렬 - Ascending
sheet.command.sort-range-asc-ext-ctx정렬 - 오름차순 범위 확장
sheet.command.sort-range-desc-ctx정렬 - Descending
sheet.command.sort-range-desc-ext-ctx정렬 - 내림차순 범위 확장
sheet.command.sort-range-custom-ctx정렬 - Custom 정렬
sheet.operation.show-comment-modal댓글 추가
sheet.operation.insert-hyper-link링크 삽입
sheet.operation.screenshot복사 as picture
sheet.command.save-cell-images셀 이미지 저장
sheet.operation.add-note-popup노트 추가
sheet.command.delete-note노트 삭제
sheet.command.toggle-note-popup노트 표시/숨기기
sheet.table.context-insert_menu-id표 삽입
sheet.command.table-insert-row표 행 삽입
sheet.command.table-insert-col표 열 삽입
sheet.table.context-remove_menu-id표 제거
sheet.command.table-remove-row표 행 삭제
sheet.command.table-remove-col표 열 삭제
sheet.command.set-first-row-frozen첫 번째 행 고정
sheet.command.set-first-column-frozen첫 번째 열 고정
sheet.sparkline.context-menu-id스파크라인
sheet.operation.open-sparkline-panel스파크라인 편집
sheet.command.remove-sparkline스파크라인 지우기

컨텍스트 메뉴 항목 - 행 머리글

메뉴 항목 ID메뉴 항목 이름
sheet.command.insert-multi-rows-above앞에 행 삽입
sheet.command.insert-multi-rows-after뒤에 행 삽입
sheet.command.hide-row-confirm선택한 행 숨기기
sheet.command.set-selected-rows-visible숨긴 행 표시
sheet.command.set-row-height행 높이
sheet.command.set-row-is-auto-height데이터에 맞춤
sheet.row-header-menu.sheet-frozen고정
sheet.contextMenu.dimension-outline그룹

컨텍스트 메뉴 항목 - 열 머리글

메뉴 항목 ID메뉴 항목 이름
sheet.command.insert-multi-cols-before앞에 열 삽입
sheet.command.insert-multi-cols-right뒤에 열 삽입
sheet.command.hide-col-confirm선택한 열 숨기기
sheet.command.set-selected-cols-visible숨긴 열 표시
sheet.command.set-worksheet-col-width열 너비
sheet.command.set-col-auto-width데이터에 맞춤
sheet.column-header-menu.sheet-frozen고정
sheet.contextMenu.dimension-outline그룹

컨텍스트 메뉴 항목 - 시트 탭

메뉴 항목 ID메뉴 항목 이름
sheet.command.remove-sheet-confirm삭제
sheet.command.copy-sheet복사
sheet.operation.rename-sheet이름 변경
sheet.command.set-tab-color색상 변경
sheet.command.set-worksheet-hidden숨기기
ui-sheet.command.show-menu-list보이기
sheet.command.add-range-protection-from-sheet-bar시트 보호
sheet.command.delete-worksheet-protection-from-sheet-bar시트 보호 해제
sheet.command.change-sheet-protection-from-sheet-bar시트 권한 변경
sheet.command.view-sheet-permission-from-sheet-bar모든 보호 범위 보기

피벗 테이블 및 피벗 차트 컨텍스트 메뉴 항목

메뉴 항목 ID메뉴 항목 이름
sheet.pivot-chart.expand-collapse확장/축소
sheet.pivot.context-menu.date-group?? ??
sheet.pivot.context-menu.excel-date-group날짜 그룹화
sheet.pivot.context-menu.number-group숫자 그룹화
sheet.pivot.context-menu.manual-group항목 그룹화
sheet.pivot.context-menu.manual-rename그룹 이름 바꾸기
sheet.pivot.context-menu.manual-ungroup그룹 해제
sheet.pivot.context-menu.show-data-as값 표시 형식
sheet.pivot.context-menu.value-filter값 필터
sheet.pivot.context-menu.date-group.year?? ?? - 년
sheet.pivot.context-menu.date-group.year-quarter?? ?? - 년-분기
sheet.pivot.context-menu.date-group.quarter?? ?? - 분기
sheet.pivot.context-menu.date-group.year-month?? ?? - 년-월
sheet.pivot.context-menu.date-group.month?? ?? - 월
sheet.pivot.context-menu.date-group.month-date?? ?? - 월-일
sheet.pivot.context-menu.date-group.year-month-date?? ?? - 년-월-일
sheet.pivot.context-menu.date-group.date?? ?? - 일
sheet.pivot.context-menu.date-group.hour?? ?? - 시
sheet.pivot.context-menu.date-group.minute?? ?? - 분
sheet.pivot.context-menu.date-group.hour-minute?? ?? - 시-분
sheet.pivot.context-menu.show-data-as.1값 표시 형식 - 계산 안 함
sheet.pivot.context-menu.show-data-as.4값 표시 형식 - 총합계 비율
sheet.pivot.context-menu.show-data-as.3값 표시 형식 - 행 합계 비율
sheet.pivot.context-menu.show-data-as.2값 표시 형식 - 열 합계 비율
sheet.pivot.context-menu.show-data-as.6값 표시 형식 - 상위 행 합계 비율
sheet.pivot.context-menu.show-data-as.5값 표시 형식 - 상위 열 합계 비율
sheet.pivot.context-menu.show-data-as.8값 표시 형식 - 인덱스
sheet.pivot.context-menu.show-data-as.14값 표시 형식 - 상위 합계 비율
sheet.pivot.context-menu.show-data-as.13값 표시 형식 - 비율
sheet.pivot.context-menu.show-data-as.9값 표시 형식 - 기준값과의 차이
sheet.pivot.context-menu.show-data-as.10값 표시 형식 - 기준값과의 차이 비율
sheet.pivot.context-menu.show-data-as.11값 표시 형식 - 누계
sheet.pivot.context-menu.show-data-as.12값 표시 형식 - 누계 비율
sheet.pivot.context-menu.show-data-as.15값 표시 형식 - 작은 값부터 순위
sheet.pivot.context-menu.show-data-as.16값 표시 형식 - 큰 값부터 순위

그리기 및 차트 메뉴 항목

메뉴 항목 ID메뉴 항목 이름
contextMenu.drawing-group그룹
drawing.operation.set-drawing-group그룹화
drawing.operation.cancel-drawing-group그룹 해제
contextMenu.drawing-arrange정렬
drawing.operation.set-drawing-arrange-front맨 앞으로 가져오기
drawing.operation.set-drawing-arrange-forward앞으로 가져오기
drawing.operation.set-drawing-arrange-back맨 뒤로 보내기
drawing.operation.set-drawing-arrange-backward뒤로 보내기
contextMenu.drawing-align맞춤
sheet.operation.set-drawing-align-left왼쪽 맞춤
sheet.operation.set-drawing-align-center가운데 맞춤
sheet.operation.set-drawing-align-right오른쪽 맞춤
sheet.operation.set-drawing-align-top위쪽 맞춤
sheet.operation.set-drawing-align-middle가운데 맞춤
sheet.operation.set-drawing-align-bottom아래쪽 맞춤
sheet.operation.set-drawing-align-horizon수평 간격 균등 분배
sheet.operation.set-drawing-align-vertical수직 간격 균등 분배
sheet.operation.add-drawing-comment댓글 추가
sheet.command.chart.open-focused-panel차트 패널 열기
sheet.command.chart.copy-focused-chart복사
sheet.command.chart.export-focused-image이미지로 내보내기
sheet.command.chart.delete-focused-chart차트 삭제

상황별 리본 메뉴 항목

해당 도형, 슬라이서 또는 타임라인을 선택하면 이 컨트롤이 표시됩니다.

메뉴 항목 ID메뉴 항목 이름
sheet.operation.apply-shape-quick-style빠른 스타일
sheet.operation.update-shape-type도형 변경
sheets-shape-ui.ribbon.shape-format.style-control도형 스타일 컨트롤
sheets-shape-ui.ribbon.shape-format.text-control도형 텍스트 컨트롤
sheet.menu.shape.flip-horizontal가로 뒤집기
sheet.menu.shape.flip-vertical세로 뒤집기
sheets-shape-ui.ribbon.shape-format.arrange-forward앞으로 보내기
sheets-shape-ui.ribbon.shape-format.arrange-backward뒤로 보내기
sheets-shape-ui.ribbon.shape-format.arrange-front맨 앞으로
sheets-shape-ui.ribbon.shape-format.arrange-back맨 뒤로
sheets-shape-ui.ribbon.shape-format.formula-control수식 도형 컨트롤
sheet.operation.open-sheet-shape-format-panel도형 서식
shape-editor-ui.operation.toggle-floating-toolbar플로팅 도구 모음
sheet.menu.slicer-quick-style빠른 스타일
sheet.menu.slicer-settings슬라이서 설정
sheet.menu.timeline-settings타임라인 설정
sheet.menu.slicer-connections보고서 연결

모바일 전용 메뉴 항목

메뉴 항목 ID메뉴 항목 이름
sheet.menu.mobile.crosshair-highlight십자선 강조
sheet.menu.mobile.numfmt숫자 서식
sheet.command.set-once-format-painter서식 페인트

이 가이드는 어떠셨나요?

© 2026 DreamNum Co., Ltd.