@asheeui/native

中文文档
2.9.2发布于 2026/11/08Apache-2.0TypeScriptESM + CJS近 30 天下载 1705

反应原生组件与原生Wind风格,共享AsheeUI设计语言和组件合同.

中文使用文档
文档目录7 节
  1. 特征
  2. 所需资源
  3. 安装
  4. 快开始
  5. 文档
  6. 链接
  7. 许可证

@asheui/ 本地语

AsheeUI on React Industrial: 相同的组件词汇,相同的道具合同和 与网络渲染器相同的设计语言,由平台自己建造 组件,所以屏幕表现平台的行为。 造型是原始风云, 和图层,两个渲染器共享 @asheeui/core。 。 。 .

特征

  • 整套内容 ——58个组件中的每一个组件的相容性 对本地人的矩阵承诺得到落实:布局包、外地家庭、 反馈和状态家族、导航、覆盖、页面外壳和 营销乐队.
  • 一个跨平台的词汇 ——一个组件由同名导入 并使用与其网页对应的相同道具,所以屏幕和页面可以共享 他们的构成.
  • 排版工具包和反应能力 —— 说 Container, (中文(简体) ), Stack编号 :HStack编号 :VStack, (中文(简体) ), Grid, (中文(简体) ), Section, (中文(简体) ), Split 财务报告和审定财务报表 Page 及其标题、内容和页脚,加 useBreakpoint 与纯洁 resolveBreakpoint 财务报告和审定财务报表 resolveGridColumns。 。 。 .
  • 配置驱动 ——每个组件登记并解决其缺省 通过同样的级联, 渲染器读取, 因此一个值可以在全球设定, 每 组件或每个实例.
  • 平台的无障碍性 ——角色和状态在平台上被表述 拥有词汇,每个组件的测试都证实了这些词汇.
  • 类型脚本第一 ——在每个出口符号上用JSDoc完全打入道具.

所需资源

  • 反应18.2或更新,或19
  • 通过 Expo 或 裸体 项目, 反应本地 0. 78 或 更新
  • 原生Wind 4.2或更新,带有 尾风 CSS 3.x —— 本地Wind v4 不编译为 Tailwind v4, 这是网页渲染器使用的
  • 22.12或较新的发展节点

安装

npm install @asheeui/native

软件包期望应用程序能提供平台的工具链,所以 设置可以适应应用程序自己的配置,而不是替换. 三个 文档和一个提供者 :

// babel.config.js — the interop runtime, which is what turns a className into a style
presets: [
  ["babel-preset-expo", { jsxImportSource: "nativewind" }],
  "nativewind/babel",
];

// metro.config.js — the stylesheet NativeWind compiles (import it from App.tsx too)
module.exports = withNativeWind(getDefaultConfig(__dirname), {
  input: "./global.css",
});

// tailwind.config.js — NativeWind's preset, the eight colour roles as the properties the
// provider paints, and the package's own classes; the globs are absolute, so any install
// layout works
const asheeui = require("@asheeui/native/tailwind-preset");

module.exports = {
  presets: [asheeui],
  content: ["./src/**/*.{ts,tsx}", ...asheeui.content],
};

然后将应用程序根包入 AsheeUIProvider - 网络渲染器使用的同名名称, 配置相同的:轴;组件;调色板(color和 defaultTheme,它遵循设备的颜色方案(AsheeNativeProvider 一样 其平台名称下的组件)。 在第一个屏幕前有三件事值得了解:

  • 不安装 react-native-css-interop 你自己来. 土著Wind 4.2.7号船 它需要的,是你们自己决定的一针,而不是它,每个部件都变成无形的 没有扔.
  • 调色板来自配置,而不是来自 tailwind.config.js。 。 。 . 预设 将每个角色声明为 rgb(var(--ashee-<role>) / <alpha-value>) 供应商用品 数值,所以 theme.extend.colors 输入角色在构建时修正并停止 如下 defaultTheme。提供者接受网络渲染器自己的 ExternalConfig 加号 仅限平台 defaultSize,所以一个配置对象——键入 ExternalConfig,或 AsheeConfig 从 asheeui ——描述两个渲染器.
  • 一个开发大楼说,当管道没有连接. 供应商检查 运行时间、编译的样式表以及挂载的预设,并用 因为它找到了; verifyNativeWind() 返回与数据相同的诊断.

原生反应 文档,每个步骤 失败看起来像, 和命令检查他们.

公布的切入点是包根, @asheeui/native/section-kit 财务报告和审定财务报表 @asheeui/native/tailwind-preset;没有每个组件子路径,所以一个组件是 从根部以名称导入,捆绑则由捆绑者而不是由 导入路径.

快开始

import { AsheeNativeProvider, Button, Card, Text } from "@asheeui/native";

export function Screen() {
  return (
    <AsheeNativeProvider>
      <Card title="Invoices" description="Three are waiting for approval.">
        <Text>Nothing leaves the device until you send it.</Text>
        <Button onPress={() => undefined}>Approve all</Button>
      </Card>
    </AsheeNativeProvider>
  );
}

文档

文件是网站,使每个网页成为每一页 .md 变式和 作为一体 llms-full.txt数字 :

许可证

AsheeUI根据Apache许可证2.0获得许可 LICENSE 使用这个软件包的文件船, 版权和归属通知 NOTICE 旁边. 许可证发放 解释重新分配需要什么.

版本与发布记录

@asheeui/native 共发布 11 个版本,首次发布于 2026/10/08;过去 12 个月发布了 11 个版本。

版本发布日期距今
2.9.2latest2026/11/082 天前
2.9.12026/11/054 天前
2.9.02026/11/019 天前
2.8.02026/10/319 天前
2.7.02026/10/2812 天前
2.6.02026/10/2713 天前

关于 @asheeui/native 的常见问题

@asheeui/native 是什么?

反应原生组件与原生Wind风格,共享AsheeUI设计语言和组件合同.

如何安装 @asheeui/native?

在项目目录运行 npm install @asheeui/native,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^18.0.0 || ^19.0.0)、nativewind(>=4.2.0)、react-native(>=0.78.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@asheeui/native 支持 TypeScript 吗?

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

@asheeui/native 支持 ESM 还是 CommonJS?

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

@asheeui/native 可以商用吗?

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

@asheeui/native 的下载量有多少?

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

@asheeui/native 还在维护吗?

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