@cdx-ui/web

中文文档
0.3.12发布于 2026/11/04MITTypeScriptESM + CJS零依赖近 30 天下载 2547

在React web应用程序中使用Forge UI的Vite集成.

中文使用文档
文档目录5 节
  1. 安装
  2. 配置维特( V) ( forge() (中文(简体) )
  3. forge() 选项
  4. 使用 Vitest 进行测试( E) forgeVitest() (中文(简体) )
  5. forgeVitest() 选项

@cdx-ui/网络

在React web应用程序中使用Forge UI的Vite集成.

安装

安装 @cdx-ui/web 与您其他 Forge UI 软件包相同的版本 :

npm install --save-dev @cdx-ui/web vite @tailwindcss/vite tailwindcss uniwind

配置维特( V) (forge()(中文(简体) )

添加 forge() 在 React 插件之前,并将其指向您的应用程序的 CSS 条目文件 :

import { defineConfig } from 'vite';
import react from '@vitejs/plugin-react';
import { forge } from '@cdx-ui/web/vite';

export default defineConfig({
  plugins: [forge({ cssEntryFile: 'src/index.css' }), react()],
});

forge() 配置 Tailwind 和 Uniwind, React 本地 Web 分辨率, 依赖性预捆绑, 和Forge UI所要求的兼容设置.

forge() 选项

选项类型默认说明
cssEntryFilestring—— 说应用程序的 CSS 条目文件的相对路径 .
patchWorkletsbooleantrue应用 React 本地工作板兼容补丁.

使用 Vitest 进行测试( E)forgeVitest()(中文(简体) )

执行 没有 设置 forge() 内 vitest.config.ts。Uniwind的维特适配器别名 react-native 在一个 vitest 解决 Flow- syntax 本地软件包的方法。 使用 forgeVitest() 相反:

import { defineConfig } from 'vitest/config';
import react from '@vitejs/plugin-react';
import { forgeVitest } from '@cdx-ui/web/vite';

export default defineConfig({
  plugins: [react(), forgeVitest()],
  test: {
    setupFiles: ['./src/__tests__/setup.ts'],
  },
});
// src/__tests__/setup.ts
import '@testing-library/jest-dom/vitest';
import { afterEach } from 'vitest';
import { cleanup } from '@testing-library/react';

afterEach(() => {
  cleanup();
});

在测试中将Forge UI 包入 ForgeDesignProvider (Dialog和其他覆盖需要其门户主机):

import type { ReactElement } from 'react';
import { render } from '@testing-library/react';
import { SafeAreaProvider } from 'react-native-safe-area-context';
import { ForgeDesignProvider } from '@cdx-ui/components';

export function renderWithForgeProviders(ui: ReactElement) {
  return render(ui, {
    wrapper: ({ children }) => (
      <SafeAreaProvider>
        <ForgeDesignProvider config={{ toast: false }}>{children}</ForgeDesignProvider>
      </SafeAreaProvider>
    ),
  });
}

forgeVitest() 拥有 :

  • react-native → react-native-web (不是Uniwind的维特别名)
  • @react-native-aria/* • 无害环境管理 lib/module 条目
  • @cdx-ui/* 因此,Bob 无害环境管理目录的进口将得到解决
  • jsdom 单风、再动、手动、工作、安全区域、SVG、屏幕、底页、闪光列表、闪光日历和再动木马

这些替身 导入时间边界测试 @cdx-ui/components API;它们不验证生产CSS,动画计时,或本地手势. 见 @cdx-ui/web/testing 用于模拟包列表.

维系着消费者的生命 examples/forge-ui-mui-vite。 。 。 .

forgeVitest() 选项

选项类型默认说明
optimizerIncludestring[][]额外维特依赖-优化包括条目

版本与发布记录

@cdx-ui/web 共发布 62 个版本,首次发布于 2026/08/20;过去 12 个月发布了 62 个版本。

版本发布日期距今
0.3.12latest2026/11/044 天前
0.3.112026/10/309 天前
0.3.102026/10/3010 天前
0.3.92026/10/3010 天前
0.3.82026/10/2811 天前
0.3.72026/10/2713 天前

其他发布通道:staging → 0.1.0。

关于 @cdx-ui/web 的常见问题

@cdx-ui/web 是什么?

在React web应用程序中使用Forge UI的Vite集成.

如何安装 @cdx-ui/web?

在项目目录运行 npm install @cdx-ui/web,或使用 pnpm add / yarn add / bun add。

@cdx-ui/web 支持 TypeScript 吗?

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

@cdx-ui/web 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@cdx-ui/web 可以商用吗?

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

@cdx-ui/web 的下载量有多少?

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

@cdx-ui/web 还在维护吗?

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