@univerjs-pro/shape-editor-ui
v1.2.0
Published
Reusable shape editor UI building blocks for Univer Pro.
Readme
@univerjs-pro/shape-editor-ui
@univerjs-pro/shape-editor-ui is part of Univer Pro. Reusable shape editor UI building blocks for Univer Pro.
Package Overview
| Package | UMD global | CSS | Locales | Facade entry |
| --- | --- | :---: | :---: | :---: |
| @univerjs-pro/shape-editor-ui | UniverProShapeEditorUi | Yes | Yes | No |
Installation
pnpm add @univerjs-pro/shape-editor-ui
# or
npm install @univerjs-pro/shape-editor-uiKeep all @univerjs/* and @univerjs-pro/* packages on the same version.
Usage
import '@univerjs-pro/shape-editor-ui/lib/index.css';
import EnUS from '@univerjs-pro/shape-editor-ui/locale/en-US';
import { UniverShapeEditorUIPlugin } from '@univerjs-pro/shape-editor-ui';
univer.registerPlugin(UniverShapeEditorUIPlugin);
// Merge EnUS into your Univer locale map when this package contributes UI text.Integration Notes
- Keep this package on the same version as the other
@univerjs/*and@univerjs-pro/*packages in your application. - Import the package stylesheet once in the application entry before rendering Univer UI.
- Import locale files only for the languages your application enables.
Format painter
registerShapeFormatPainter supplies the shared Shape adapter used by Sheets, Docs, and
Slides. It copies fill, stroke, supported effects, text insets, and text formatting while
retaining the target's geometry, text, identity, and formula bindings. Connector targets also
receive line and arrow styling. Images, SmartArt, groups, and mixed object selections are unsupported.
Hosts provide hit testing and permission checks, and commit changes through their undoable commands. The existing Start ribbon button handles single-use and continuous painting; Shape text editing uses the Docs text-selection adapter instead of object painting. The clear-formatting icon restores insertion defaults for the selected Shape while retaining its text, geometry, and formula bindings. Text boxes and text placeholders reset their text formatting without acquiring a Shape fill.
