UI 개요

@univerjs-pro/boards-ui는 Univer 널을 위한 허가한 브라우저 화포입니다. 그것은 장면을, 손잡이 선택 및 viewport 상호 작용을 렌더링하고, 도구 모음, 컨텍스트 메뉴, 텍스트 편집, 모양 편집, 연결관 편집 및 지원되는 널 성분 유형을 위한 UI를 제공합니다.

Board UI 등록

보드 플러그인 전에 UniverLicensePlugin 구성. 문서, 그림, 잉크 및 모양 편집기는 렌더링 및 편집을위한 기술 의존성입니다. 보드를 사용하여 그 제품의 사전 지식이 필요하지 않습니다.

UniverBoardsUIPlugin

  • workbench
    object
    Workbench 레이아웃 옵션.
    • content
      boolean기본값: true
      기본 콘텐츠 영역을 표시합니다.
    • header
      boolean기본값: false
      헤더를 표시합니다.
    • headerMenu
      boolean기본값: false
      헤더 메뉴를 표시합니다.
    • toolbar
      boolean기본값: false
      도구 모음을 표시합니다.
    • footer
      boolean기본값: false
      바닥글을 표시합니다.
  • interaction
    object
    캔버스 확대·축소 및 이동 설정입니다.
    • minZoomRatio
      number기본값: 0.02
      최소 확대 배율을 설정합니다.
    • maxZoomRatio
      number기본값: 4
      최대 확대 배율을 설정합니다.
    • wheelZoomWithModifier
      boolean기본값: true
      보조 키를 누른 채 휠을 돌리면 확대하거나 축소합니다.
    • trackpadPanEnabled
      boolean기본값: true
      트랙패드로 캔버스를 이동합니다.
  • interactionMode
    'editing' | 'viewing'기본값: 'editing'
    편집 또는 보기 모드에서 시작. 문서 권한은 여전히 적용됩니다.
  • gridVisible
    boolean기본값: false
    캔버스 그리드를 표시합니다.
  • grid
    object
    격자 색과 간격입니다.
    • gridSize
      number기본값: 32
      작은 격자의 간격입니다. 캔버스 좌표를 사용합니다.
    • lineColor
      string기본값: 'rgba(100, 116, 139, 0.48)'
      작은 격자선의 색입니다.
    • majorGridSize
      number기본값: 160
      큰 격자의 간격입니다. 캔버스 좌표를 사용합니다.
    • majorLineColor
      string기본값: 'rgba(100, 116, 139, 0.72)'
      큰 격자선의 색입니다.
  • quickAddEnabled
    boolean기본값: true
    빠른 추가 컨트롤을 표시합니다.
  • preciseSelection
    boolean기본값: false
    요소를 선택하기 위해 더 정확한 결과를 요구합니다.
  • showDimensions
    boolean기본값: false
    차원 지시자를 보여주십시오.
  • showToolbar
    boolean기본값: true
    캔버스 도구 모음을 표시합니다.
  • modeSwitcherVisible
    boolean기본값: true
    상호 작용 모드 스위처를 표시합니다.
  • collaboratorCursorsVisible
    boolean기본값: true
    다른 협동자의 커서를 보여줍니다.
  • collaboratorCursorShareInterval
    number기본값: 100
    공동 편집 커서 위치 전송 간격입니다. 16–1000밀리초입니다.
  • viewportBar
    object
    뷰포트 스크롤바 설정입니다.
    • enabled
      boolean기본값: true
      viewport scrollbars를 활성화합니다.
    • horizontal
      boolean기본값: true
      수평 스크롤 표시.
    • vertical
      boolean기본값: true
      수직 scrollbar를 표시합니다.
    • padding
      number | object기본값: 300
      캔버스 주변 여백입니다. 모든 방향에 같은 값을 쓰거나 각 방향을 따로 지정할 수 있습니다.
      • top
        number기본값: 300
        위쪽 여백입니다.
      • right
        number기본값: 300
        오른쪽 여백입니다.
      • bottom
        number기본값: 300
        아래쪽 여백입니다.
      • left
        number기본값: 300
        왼쪽 여백입니다.
  • insert
    object
    새 요소의 기본 설정입니다.
    • chart
      object
      차트 크기입니다.
      • width
        number기본값: 480
        너비입니다.
      • height
        number기본값: 270
        높이입니다.
    • image
      object
      이미지 크기와 위치입니다.
      • fallbackWidth
        number기본값: 320
        이미지 차원이 알 수 없을 때 사용되는 폭.
      • fallbackHeight
        number기본값: 180
        이미지 차원이 알 수 없을 때 사용되는 높이.
      • fitRatio
        number기본값: 0.56
        이미지를 맞출 때 사용할 뷰포트 비율입니다.
      • minEdge
        number기본값: 80
        맞춘 후 최소 변 길이입니다.
      • minPositionOffset
        number기본값: 24
        뷰포트 원점에서의 최소 간격입니다.
    • table
      object
      표 크기입니다.
  • shape
    object
    도형 선택기 설정입니다.
    • commonCount
      number
      표시할 자주 쓰는 도형 수입니다.
    • presets
      readonly IBoardShapePreset[]
      선택기에 표시할 도형 정의입니다.
  • sticky
    object
    스티커 메모 설정입니다.
    • colors
      readonly string[]
      선택할 수 있는 색입니다.
  • renderAdapters
    readonly IBoardElementRenderAdapter[]
    기본 렌더링 어댑터를 교체합니다.
  • additionalRenderAdapters
    readonly IBoardElementRenderAdapter[]
    설정된 목록에 렌더링 어댑터를 추가합니다.

UniverLicensePlugin

  • license
    string
    클라이언트 라이선스 파일의 내용입니다.
TypeScript
univer.registerPlugin(UniverLicensePlugin, {  license: process.env.CLIENT_LICENSE_TEXT,})univer.registerPlugin(UniverBoardsPlugin)univer.registerPlugin(UniverBoardsUIPlugin, {  workbench: {    content: true,    header: false,    headerMenu: false,    toolbar: false,    footer: false,  },  interaction: {    minZoomRatio: 0.1,    maxZoomRatio: 4,    wheelZoomWithModifier: true,    trackpadPanEnabled: true,  },})

전체 의존성, 스타일 및 Locale 등록 주문에 대해서는 설치 및 기본 사용를 참조하십시오.

캔버스 옵션

IUniverBoardsUIConfig는 또한 격자 외관을 통제하고, 과태를 삽입하고, 유효한 모양과 끈끈한 주의 색깔, 연장통 공구, 전망 항구 막대기, 빠른 추가와 같은 접합기 및 선택권, 정확한 선택, 차원 및 복도계 cursors를 삽입합니다.

컨텍스트 메뉴 및 캔버스 도구를 시작으로 구성합니다. 기존 컨텍스트 메뉴를 변경하려면 메뉴 Facade API을 사용하십시오.

이 가이드는 어떠셨나요?

© 2026 DreamNum Co., Ltd.