Univer Boards API

Univer Boards 애플리케이션에서 Facade API를 사용하는 방법을 알아봅니다.

Facade API는 Univer 서비스 및 유닛 모델 위에 애플리케이션용 계층을 제공합니다. Board 만들기, 활성 페이지 읽기, 요소 추가, 컨테이너 업데이트, 스윔레인 관리와 같은 일반적인 Board 작업에 사용하세요.

주의

Board 변경 API는 동기식이며 boolean 또는 nullable 핸들을 반환합니다. 반환값을 확인하세요.

Facade 진입점 활성화

Boards는 Web SDK 플러그인으로 배포됩니다. 애플리케이션에서 사용하는 Board 기능의 Facade 진입점을 가져옵니다.

TypeScript
import { FUniver } from '@univerjs/core/facade'import '@univerjs-pro/boards/facade'

Univer 인스턴스와 필수 플러그인을 등록한 후 API 객체를 만듭니다.

TypeScript
const univerAPI = FUniver.newAPI(univer)

Board 만들기 및 읽기

createBoard를 사용하여 Facade 계층을 통해 Board 유닛을 만듭니다. 하위 수준 설정 코드에서는 univer.createUnit(UniverInstanceType.UNIVER_BOARD, snapshot)으로 유닛을 만듭니다.

TypeScript
const board = univerAPI.createBoard({  id: 'board-demo',  name: 'Board Demo',})const activeBoard = univerAPI.getActiveBoard()const sameBoard = univerAPI.getBoard(board.getId())

핵심 기능 계속 보기

반환된 FBoard 객체는 활성 페이지와 해당 콘텐츠의 진입점입니다. 자세한 작업은 다음 가이드를 참고하세요.

  • 요소에서는 Board 요소 읽기, 삽입, 연결, 변형, 배치 및 삭제를 설명합니다.
  • 컨테이너 및 스윔레인에서는 프레임 그룹, 소속 관계 및 스윔레인 구조를 설명합니다.

참고 자료

이 가이드는 어떠셨나요?

© 2026 DreamNum Co., Ltd.