# @asheeui/web 中文文档

规范地址：https://npmcn.com/package/%40asheeui/web/

版本：2\.9\.2
npm 元数据更新时间：2026-11-07T18:35:20.751Z
中文译文更新时间：2026-11-08T11:27:20.606Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40asheeui/web
原文对照：https://npmcn.com/package/%40asheeui/web/?lang=original
项目主页：https://asheeui.com/
源码仓库：https://github.com/AsheeSoftworks/AsheeUI

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

- 包体积（解压后）：1.2 MB，949 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：4 个
- peer 依赖：react ^18\.0\.0 \|\| ^19\.0\.0，react-dom ^18\.0\.0 \|\| ^19\.0\.0，tailwindcss \>=4\.0\.0
- 首次发布：2026-10-08T14:31:03.870Z
- 最新版本发布：2026-11-07T18:35:20.592Z
- 近 30 天下载量：1787（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：11（近 12 个月 11 个）

## 中文简介

使用Tailwind CSS设计的可访问且可定制的回放原始.

## 安装

```sh
npm install @asheeui/web
```

也可以使用：`pnpm add @asheeui/web`、`yarn add @asheeui/web`、`bun add @asheeui/web`

## README

# @asheui/网络

在 Tailwind CSS v4 上构建的 React UI 框架。 可访问、可配置驱动 组件、布局系统、一页的区段和一页 融入他们自己的切入点.

## 特征

-   **配置驱动** —主题,变体,颜色,半径和间隔默认解析 通过一个级联,因此可以在全球、每个组件或每个组件确定一个值 举个例子.
-   **排版系统** —— 说 `Container`, (中文(简体) ), `Section`, (中文(简体) ), `Stack`编号 :`HStack`编号 :`VStack`, (中文(简体) ), `Grid`, (中文(简体) ), `Page`编号 :`PageHeader`编号 :`PageContent`编号 :`PageFooter`附加时 `SidebarLayout` 财务报告和审定财务报表 `AuthLayout` 申请页.
-   **页 次** —— 说 `Navbar`, (中文(简体) ), `Hero`, (中文(简体) ), `FeatureGrid`, (中文(简体) ), `CTA`, (中文(简体) ), `Testimonials`, (中文(简体) ), `PricingCard` 财务报告和审定财务报表 `Footer`,每个动作作为配置.
-   **Puck 一体化** ——框架的区块登记在 `@asheeui/puck`,所以一个 应用程序、编辑器和已出版的页面共享一个执行,和一个设备 使由本地组件构成的页面. `@puckeditor/core` 是一个 该软件包的可选对等依赖性.
-   **尾风 CSS v4** ——类名称为静态并完整,颜色决定 通过 CSS 自定义属性.
-   **浅而暗的主题** ——内置 `light`, (中文(简体) ), `dark` 财务报告和审定财务报表 `system` 主题,加 自定义主题.
-   **可访问** - 地标、名称、键盘行为和宣布状态 每个部件合同的一部分, 并有说明它们的测试.
-   **类型脚本第一** ——完全打入的配置,主题登记和组件 道具,每个出口符号上都有JSDoc.

## 所需资源

-   反应 18 或更新
-   尾风 CSS v4
-   22.12或较新的发展节点

## 安装

```bash
npm install @asheeui/web
```

导入样式表一次后将根包入提供者 :

```css
@import "tailwindcss";
@import "@asheeui/web/styles";
```

```tsx
import { AsheeUIProvider } from "@asheeui/web";
```

可选 `@asheeui/cli` 包可以脚手架 设置和检查,但它 不需要:以上两个步骤是整个设置.

## 文档

框架文件存放在存储处:

-   [安装](https://github.com/AsheeSoftworks/AsheeUI/blob/main/docs/installation.md)
-   [配置](https://github.com/AsheeSoftworks/AsheeUI/blob/main/docs/configuration.md)
-   [构成部分](https://github.com/AsheeSoftworks/AsheeUI/blob/main/docs/components.md)
-   [纸](https://github.com/AsheeSoftworks/AsheeUI/blob/main/docs/puck.md)
-   [无障碍](https://github.com/AsheeSoftworks/AsheeUI/blob/main/docs/accessibility.md)
-   [移徙](https://github.com/AsheeSoftworks/AsheeUI/blob/main/docs/migration.md)

## 快开始

```tsx
import { Button, Page, PageContent, Hero } from "@asheeui/web";

export function App() {
  return (
    <Page>
      <PageContent>
        <Hero
          title="Run your campaigns from one place"
          primaryAction={{ label: "Start free", href: "/signup" }}
        />
        <Button>Hello AsheeUI</Button>
      </PageContent>
    </Page>
  );
}
```

一个完整的页面是 `Navbar`,一个或两个乐队,和 `Footer`全部编曲 结束 `Page`, (中文(简体) ), `Section`, (中文(简体) ), `Container` 财务报告和审定财务报表 `Grid`。 。 。 .

## 他们

主题为 CSS 自定义属性( S)`--ashee-background`, (中文(简体) ), `--ashee-primary`,以及 由供应商在第一次油漆之前应用. `useTheme` 开关 并记录首选项, `themeController` 做同样的 外部反应,一个主题被定义为配置中的块.

## 链接

-   联合国 [https://asheeui.com (英语)](https://asheeui.com/)
-   仓库 : [https://github.com/AsheeSoftworks/AsheeUI (英语)](https://github.com/AsheeSoftworks/AsheeUI)
-   问题: [https://github.com/AsheeSoftworks/AsheeUI/issubs (中文(简体) )](https://github.com/AsheeSoftworks/AsheeUI/issues)

## 许可证

AsheeUI根据该条例获得许可证 [Apache 许可证 2.0](https://npmcn.com/package/LICENSE)版权和版权 归属通知在根中 [通知](https://npmcn.com/package/NOTICE) 文件; 仓库 [许可证指南](https://npmcn.com/package/docs/licensing.md) 解释重新分配需要什么.

## 常见问题

### @asheeui/web 是什么？

使用Tailwind CSS设计的可访问且可定制的回放原始\.

### 如何安装 @asheeui/web？

在项目目录运行 npm install @asheeui/web，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^18\.0\.0 \|\| ^19\.0\.0）、react-dom（^18\.0\.0 \|\| ^19\.0\.0）、tailwindcss（\>=4\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @asheeui/web 支持 TypeScript 吗？

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

### @asheeui/web 支持 ESM 还是 CommonJS？

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

### @asheeui/web 可以商用吗？

@asheeui/web 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @asheeui/web 的下载量有多少？

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

### @asheeui/web 还在维护吗？

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