# @budibase/bbui 中文文档

规范地址：https://npmcn.com/package/%40budibase/bbui/

版本：3\.50\.0
npm 元数据更新时间：2026-10-19T08:13:40.666Z
中文译文更新时间：2026-11-08T18:16:54.301Z
软件包许可：MPL-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40budibase/bbui
原文对照：https://npmcn.com/package/%40budibase/bbui/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：2.9 MB，175 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：49 个
- 首次发布：2020-05-26T09:51:29.613Z
- 最新版本发布：2026-10-19T08:13:40.411Z
- 近 30 天下载量：12277（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：3268（近 12 个月 151 个）

## 中文简介

不同Budibase项目中使用的UI解决方案.

## 安装

```sh
npm install @budibase/bbui
```

也可以使用：`pnpm add @budibase/bbui`、`yarn add @budibase/bbui`、`bun add @budibase/bbui`

## README

# Budibase bubui (英语)

处理Budibase组织所有共同组件的软件包。 您可以找到当前实时版本 [给](http://bbui.budibase.com/)。 。 。 .

## 安装

1.  克隆
2.  `npm install`
3.  `npm run svench`

(注:纱线不行!)

## 创建组件的示例工作流程

1.  创建文件 : `Headline.svelte`
2.  创建 Svench 文件 : `Headline.svench`
3.  构建组件并添加变体到斯文奇文件.
4.  完成后,将文件再导出到 `src/index.js`。 。 。 .
5.  发布,更新主项目中的包并利润.

## 准则

### 制作组件

1.  想想再使用的可能性
2.  使用 Cs 样式表中的 SCs 自定义属性( 变量) 。 这让事情很容易在后期调整.
3.  选择前进事件( E)`<button on:click>` 例如),而不是使用回调.
4.  避免在部件最外侧容器上增加边距.

### 使用组件和样式指南

1.  熟悉组件上存在的不同道具. 如果缺少重要的东西, 做一个公关并添加它.
2.  利用样式表中的 Css 自定义属性并避免写入硬编码值.
3.  由于组件上没有差分,考虑DOM的结构以及如何实现正确的间隔等. 可用 `css grid` + 键 `grid gap` 或有一个容器,其中指定了垫子或边距。 最佳的解决办法取决于具体情况.

## 开始

-   [ ] 找出一个良好的文件状况
-   [ ] 添加测试套件( E2E 使用 Playwright ?)

## 其它

项目使用 [风向](https://github.com/rixo/svench)它有点像"故事书",但少了一点膨胀,更容易设定。 它还支持高血压快速发展.

## 常见问题

### @budibase/bbui 是什么？

不同Budibase项目中使用的UI解决方案\.

### 如何安装 @budibase/bbui？

在项目目录运行 npm install @budibase/bbui，或使用 pnpm add / yarn add / bun add。

### @budibase/bbui 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/budibase\_\_bbui 是否存在。

### @budibase/bbui 支持 ESM 还是 CommonJS？

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

### @budibase/bbui 可以商用吗？

@budibase/bbui 使用 MPL-2\.0 许可。弱 Copyleft：可以商用，也可以和闭源代码一起使用；但如果分发时修改了 MPL 授权的文件，这些文件的修改需以 MPL 开源。以上为概括，不构成法律意见，请以许可原文为准。

### @budibase/bbui 的下载量有多少？

根据 npm 官方下载统计，@budibase/bbui 在 2026/10/09 – 2026/11/07 这 30 天内被下载 12,277 次，日均约 409 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @budibase/bbui 还在维护吗？

最新版本 3\.50\.0 发布于 2026/10/19（20 天前）；至今共发布 3268 个版本，其中过去 12 个月发布了 151 个；首次发布于 2020/05/26。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。