@webority/ui-react

中文文档
0.119.0发布于 2026/11/03SEE LICENSE IN LICENSETypeScriptES Module

Webority shared React component library — App* primitives on react-bootstrap + the @webority/theme design system.

原始使用文档

@webority/ui-react

Webority's internal React component library — the App* primitives, built on @webority/theme.

Published publicly so npm install needs no private registry. Built for Webority products; no support commitment outside them.

Use

npm install --save-exact @webority/ui-react @webority/theme
npm install bootstrap react-bootstrap

--save-exact is deliberate: pin @webority/* to an exact version, never ^. A patch of a shared UI library can change rendering on every screen at once, so moving version is a decision you make and test. (A caret would not even buy you auto-upgrades — deploys run npm ci, which installs the lockfile and ignores the range; it only allows a silent jump the next time someone runs a bare npm install.)

Import the theme once (see @webority/theme for the SCSS chain), then:

import { AppButton } from '@webority/ui-react';

<AppButton variant="primary">Save changes</AppButton>;

Component catalogue: https://ui-react.webority.dev

版本与发布记录

@webority/ui-react 共发布 271 个版本,首次发布于 2026/07/24;过去 12 个月发布了 271 个版本。

版本发布日期距今
0.119.0latest2026/11/03今天
0.118.02026/11/03今天
0.117.02026/11/03今天
0.116.02026/11/02今天
0.115.02026/11/02今天
0.114.02026/11/021 天前

关于 @webority/ui-react 的常见问题

@webority/ui-react 是什么?

Webority共享React组件库- App*元素在React -bootstrap + @webority/theme设计系统。

如何安装 @webority/ui-react?

在项目目录运行 npm install @webority/ui-react,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^19.0.0)、bootstrap(5.3.3)、react-dom(^19.0.0)、react-bootstrap(^2.10.0)、@webority/analytics(^0.31.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@webority/ui-react 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@webority/ui-react 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@webority/ui-react 可以商用吗?

@webority/ui-react 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中,请阅读该文件确认可否商用。以上为概括,不构成法律意见,请以许可原文为准。

@webority/ui-react 还在维护吗?

最新版本 0.119.0 发布于 2026/11/03(今天);至今共发布 271 个版本,其中过去 12 个月发布了 271 个;首次发布于 2026/07/24。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。