기본 스타일

두 가지 수준의 기본 스타일을 제공합니다.

  1. 워크시트의 기본 스타일
  2. 열 또는 행의 기본 스타일

두 스타일 모두 IWorksheetData 인터페이스 또는 Facade API를 통해 설정할 수 있습니다.

배경색 우선순위

B2에는 행과 열의 기본 스타일이 모두 있습니다. 우선순위를 바꾸고 셀 배경색도 지정해 보세요.

A1

시트

B1

열

C1

시트

A2

행

B2

열

C2

행

A3

시트

B3

열

C3

시트

B2 적용 스타일: 열

isRowStylePrecedeColumnStyle: false

배경색만 비교하는 예시입니다. 다른 스타일 속성은 각각 병합됩니다.

구성

기본적으로 열 스타일이 행 스타일보다 우선합니다. 등록할 때 isRowStylePrecedeColumnStyle을 설정하여 이 동작을 변경할 수 있습니다.

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

TypeScript
import { UniverSheetsPlugin } from '@univerjs/sheets'univer.registerPlugin(UniverSheetsPlugin, {  isRowStylePrecedeColumnStyle: true,})

기본 스타일 설정

워크시트의 기본 스타일을 설정하는 방법은 두 가지입니다.

  1. IWorksheetData 인터페이스를 통해 설정
TypeScript
interface IWorksheetData {  // other  /**   * @property {Nullable<IStyleData>} [defaultStyle] - Default style data of Worksheet.   */  defaultStyle?: Nullable<IStyleData>}interface IRowData {  // other  /**   * style data   */  s?: Nullable<IStyleData>}interface IColumnData {  // other  /**   * style data   */  s?: Nullable<IStyleData>}
  1. Facade API를 통해 설정
TypeScript
const fworkbook = univerAPI.getActiveWorkbook()const fworksheet = fworkbook.getActiveSheet()const defaultStyle = {  bg: {    rgb: 'red',  },}const defaultColumnStyle = {  bg: {    rgb: 'blue',  },}const defaultRowStyle = {  bg: {    rgb: 'green',  },}// set default stylefworksheet.setDefaultStyle(defaultStyle)// set column D default stylefworksheet.setColumnDefaultStyle(3, defaultColumnStyle)// reset column D the default stylefworksheet.setColumnDefaultStyle(3, undefined)// set row default stylefworksheet.setRowDefaultStyle(1, defaultRowStyle)

셀에 맞게 텍스트 축소

텍스트 너비가 셀을 초과하면 FRange로 글꼴 크기를 줄일 수 있습니다. 이 설정은 범위의 모든 셀에 적용되며, getShrinkToFit()은 왼쪽 위 셀의 상태를 반환합니다.

TypeScript
const range = univerAPI.getActiveWorkbook().getActiveSheet().getRange('A1:C3')range.setShrinkToFit(true)const enabled = range.getShrinkToFit()

셀에 맞게 축소와 텍스트 줄 바꿈은 함께 사용할 수 없습니다. 줄 바꿈을 켜면 축소가 해제되고, 축소를 켜면 해당 셀의 기존 줄 바꿈 설정이 해제됩니다.

이 가이드는 어떠셨나요?

© 2026 DreamNum Co., Ltd.