@univerjs/design

@univerjs/design

Package Overview

Package Name	UMD Namespace	Version	License	Downloads	Contains CSS	Contains i18n locales
@univerjs/design	UniverDesign				⭕️	⭕️

Introduction

To ensure better consistency in the UI of Univer plugins and to reduce the effort required for custom development, we provide some fundamental design guidelines and components.

The components are developed using React and less, and you can find out more information by visiting the component library website.

:::note If you only need to extend the toolbar, context menu, and so on, you can directly use the extension interfaces provided by @univerjs/ui without implementing the UI yourself. For more information, please refer to Extending UI. :::

Usage

Installation

# Using npm
npm install @univerjs/design

# Using pnpm
pnpm add @univerjs/design

This package contains CSS and has the highest priority. Please import it before importing any other Univer style files.

Built-in themes

The package provides two built-in themes: defaultTheme and greenTheme. You can import them directly and use them in your application.

import { defaultTheme } from '@univerjs/design';
// import { greenTheme } from '@univerjs/design';

// Use the default theme
new Univer({
    theme: defaultTheme,
    // theme: greenTheme,
});

Changelog

0.5.5 (2025-01-20)

Bug Fixes

• add selection facade API (#4467) (cc4ad5f)
• bind multiple times for UIEvent after dispose and create again (#4500) (5e6cd64)
• customize auto height for merged cell (#4488) (0c2f6b6)
• design: add hex format support for HSV conversion of ColorPicker (#4518) (f47408e)
• disable jsdoc/tag-lines rule and add ignore comments in FBase classes (#4495) (23af713)
• facade: make facade sync (#4482) (447f991)
• facade: sheets event facade (#4485) (bd9da5d)
• facade: support get rich-text by getValue (#4523) (d845d95)
• fix source error (#4505) (a4108c5)
• float dom event (#4514) (4d13d75)
• formula: fix bug in judging whether the value is in number format (#4493) (5d0b397)
• numfmt: use next in writeCellInterceptor (#4490) (293cf65)
• renderUnit is not sheet in prev way (#4492) (b40bc0d)
• sheet: cell precision error (#4476) (99b2600)
• sheet: fix binding type not set & add readme. (#4515) (c55f285)
• sheet: fix doc error (#4451) (d5cc9a7)
• sheet: fix facade throw error (#4466) (e53eb2c)
• sheet: remove custom paste (#4503) (ecc8256)
• sheets-formula-ui: highlight doc (#4516) (83a781e)
• sheets-formula-ui: wrong curosr index caused by move-range (#4517) (6cd0583)
• sheets-ui: modify selection when need to add one (#4513) (46e9e1c)
• sheets: data validation validator issues (#4477) (29b6f9a)
• sheets: set value error on formula cell (#4527) (a6a18e5)
• sheet: support bind delete & date type source (#4487) (4aff7f7)
• sheet: support source bind ignore header (#4524) (f38f29e)
• ui: menu hidden error (#4519) (26ef5e9)
• ui: menu hidden error (#4520) (930e15f)

Features

• add postcss-preset-env for enhanced CSS features and refactor AlphaSlider styles (#4486) (fdd876b)
• auto complete2 (#4489) (45bc936)
• core: add unit test for rich-text-builder (#4481) (2bf3e08)
• design: add hex format support for color output of ColorPicker (#4512) (5349885)
• facade: add comment example on facade (#4501) (7c74cc8)
• facade: add effect ranges on skeleton change (#4496) (7957d95)
• facade: add event support for sheets & sheets-ui (#4491) (635cc81)
• facade: add sheet facade functions (#4494) (ab3c712)
• facade: deprecated comment (#4502) (2247269)
• numfmt: add numfmt local enum (#4472) (2dcdfa4)
• numfmt: support set numfmt local (#4470) (116796d)
• sheets: add old sheets api (#4529) (6c6f245)
• sheet: support data binding in sheet (#4461) (08ed7a2)