# @bitrix24/b24ui-nuxt 中文文档

规范地址：https://npmcn.com/package/%40bitrix24/b24ui-nuxt/

版本：2\.15\.0
npm 元数据更新时间：2026-10-16T13:35:55.454Z
中文译文更新时间：2026-11-08T04:42:23.731Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40bitrix24/b24ui-nuxt
原文对照：https://npmcn.com/package/%40bitrix24/b24ui-nuxt/?lang=original
项目主页：https://bitrix24.github.io/b24ui/
源码仓库：https://github.com/bitrix24/b24ui

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

- 包体积（解压后）：4.1 MB，813 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：^20\.19\.0 \|\| \>=22\.12\.0
- 运行依赖：64 个
- peer 依赖：joi ^18，vue ^3\.5\.0，yup ^1\.7\.0，zod ^3\.24\.0 \|\| ^4，valibot ^1，typescript ^5\.6\.3 \|\| ^6 \|\| ^7，vue-router ^4\.5\.0 \|\| ^5，superstruct ^2，tailwindcss ^4，@nuxt/content ^3，@inertiajs/vue3 ^2\.0\.7 \|\| ^3，@tanstack/charts ^1，@internationalized/date ^3，@internationalized/number ^3
- 首次发布：2025-01-28T09:56:11.147Z
- 最新版本发布：2026-10-16T13:35:55.004Z
- 近 30 天下载量：8776（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：108（近 12 个月 36 个）

## 中文简介

Bitrix24 用于用 Nuxt & Vue 构建 REST- API 网络应用程序的 UI Kit

## 安装

```sh
npm install @bitrix24/b24ui-nuxt
```

也可以使用：`pnpm add @bitrix24/b24ui-nuxt`、`yarn add @bitrix24/b24ui-nuxt`、`bun add @bitrix24/b24ui-nuxt`

## README

# Bitrix24 用户界面

[![npm version](https://img.shields.io/npm/v/@bitrix24/b24ui-nuxt.svg?style=flat&colorA=020420&colorB=2fc6f6)](https://www.npmjs.com/package/@bitrix24/b24ui-nuxt) [![npm downloads](https://img.shields.io/npm/dm/@bitrix24/b24ui-nuxt.svg?style=flat&colorA=020420&colorB=2fc6f6)](https://npm.chart.dev/@bitrix24/b24ui-nuxt) [![License](https://img.shields.io/github/license/bitrix24/b24ui.svg?style=flat&colorA=020420&colorB=2fc6f6)](https://github.com/bitrix24/b24ui/blob/main/LICENSE) [![Bitrix24 UI](https://img.shields.io/badge/Bitrix24%20-UI%20Kit-2fc6f6?labelColor=020420)](https://apidocs.bitrix24.com/)

Bitrix24 用于用 Nuxt & Vue 构建 REST- API 网络应用程序的 UI Kit

查找更多细节 [文档](https://bitrix24.github.io/b24ui/)

## 文档

访问 [https://bitrix24.github.io/b24ui/ (中文(简体) )](https://bitrix24.github.io/b24ui/) 以探索文档.

## 安装

```bash
pnpm add @bitrix24/b24ui-nuxt @bitrix24/b24icons-vue tailwindcss
```

```bash
yarn add @bitrix24/b24ui-nuxt @bitrix24/b24icons-vue tailwindcss
```

```bash
npm install @bitrix24/b24ui-nuxt @bitrix24/b24icons-vue tailwindcss
```

```bash
bun add @bitrix24/b24ui-nuxt @bitrix24/b24icons-vue tailwindcss
```

### 坚果

1.  在您中添加 Bitrix24 用户界面模块 `nuxt.config.ts`数字 :

```ts
export default defineNuxtConfig({
  modules: ['@bitrix24/b24ui-nuxt'],
  css: ['~/assets/css/main.css']
})
```

2.  在您的 CSS 中导入 Tailwind CSS 和 Bitrix24 UI :

```css
@import "tailwindcss";
@import "@bitrix24/b24ui-nuxt";
```

学习更多在 [安装指南](https://bitrix24.github.io/b24ui/docs/getting-started/installation/nuxt/)。 。 。 .

### 阴道

1.  在您中添加 Bitrix24 用户界面插件 `vite.config.ts`数字 :

```ts
import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'
import bitrix24UIPluginVite from '@bitrix24/b24ui-nuxt/vite'

export default defineConfig({
  plugins: [
    vue(),
    bitrix24UIPluginVite()
  ]
})
```

2.  使用您的 Bitrix24 用户界面插件 `main.ts`数字 :

```ts
import './assets/css/main.css'

import { createApp } from 'vue'
import { createRouter, createWebHistory } from 'vue-router'
import b24UiPlugin from '@bitrix24/b24ui-nuxt/vue-plugin'
import App from './App.vue'

const app = createApp(App)

const router = createRouter({
  routes: [],
  history: createWebHistory()
})

app.use(router)
app.use(b24UiPlugin)

app.mount('#app')
```

3.  在您的 CSS 中导入 Tailwind CSS 和 Bitrix24 UI :

```css
@import "tailwindcss";
@import "@bitrix24/b24ui-nuxt";
```

学习更多在 [安装指南](https://bitrix24.github.io/b24ui/docs/getting-started/installation/vue/)。 。 。 .

## 捐款

谢谢你考虑为Bitrix24UI捐款. 以下是你能参与的几种方式:

-   **警卫**:发现弱点? [私下报告](https://github.com/bitrix24/b24ui/security/advisories/new) ——不通过以下表格. [警卫](https://github.com/bitrix24/b24ui/blob/main/SECURITY.md) 说什么重要.
-   **报告错误**数字 : [打开错误报告](https://github.com/bitrix24/b24ui/issues/new?template=bug-report.yml)表格要求复制,这是决定是否可以对报告采取行动的领域 [报告错误](https://github.com/bitrix24/b24ui/blob/main/CONTRIBUTING.md#reporting-a-bug)。 。 。 .
-   **建议**数字 : [打开特性请求](https://github.com/bitrix24/b24ui/issues/new?template=feature-request.yml)。有什么想法来增强Bitrix24 UI? 我们很想听到他们.
-   **代码**数字 : [捐款额](https://github.com/bitrix24/b24ui/blob/main/CONTRIBUTING.md) 是地图——设置,深潜水向导,以及CI期望的拉取请求. 这个 [捐款指南](https://bitrix24.github.io/b24ui/docs/getting-started/contribution/) 在文件网址上,数据库可以运行.

> \[TIP\] 我们通过 [`AGENTS.md`](https://github.com/bitrix24/b24ui/blob/main/AGENTS.md) 帮助您为 Bitrix24 UI 做出贡献。 所有AI编码代理人和指南通过组件结构、主题模式、测试公约和文献指南自动进行检索.

## 贷项

-   [纳克特/纳克特](https://github.com/nuxt/nuxt)
-   [nuxt/ ui (单位)](https://github.com/nuxt/ui)
-   [不爱/雷卡-伊](https://github.com/unovue/reka-ui)
-   [尾风窗/尾风窗](https://github.com/tailwindlabs/tailwindcss)
-   [阴道/阴道](https://github.com/vueuse/vueuse)

## 常见问题

### @bitrix24/b24ui-nuxt 是什么？

Bitrix24 用于用 Nuxt & Vue 构建 REST- API 网络应用程序的 UI Kit

### 如何安装 @bitrix24/b24ui-nuxt？

在项目目录运行 npm install @bitrix24/b24ui-nuxt，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：vue（^3\.5\.0）、typescript（^5\.6\.3 \|\| ^6 \|\| ^7）、tailwindcss（^4）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @bitrix24/b24ui-nuxt 支持 TypeScript 吗？

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

### @bitrix24/b24ui-nuxt 支持 ESM 还是 CommonJS？

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

### @bitrix24/b24ui-nuxt 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js ^20\.19\.0 \|\| \>=22\.12\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @bitrix24/b24ui-nuxt 可以商用吗？

@bitrix24/b24ui-nuxt 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @bitrix24/b24ui-nuxt 的下载量有多少？

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

### @bitrix24/b24ui-nuxt 还在维护吗？

最新版本 2\.15\.0 发布于 2026/10/16（22 天前）；至今共发布 108 个版本，其中过去 12 个月发布了 36 个；首次发布于 2025/01/28。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。