@epignosis_llc/gnosis

中文文档
6.12.0发布于 2026/11/12MITTypeScriptESM + CJS近 30 天下载 2419

Epigosis官方反应设计系统.

中文使用文档
文档目录7 节
  1. * 安装
  2. 使用量
  3. 主题
  4. QQ 全球
  5. QQ 主题配置
  6. 图标
  7. 即将到来的构成部分

肠道

麻风病 官方反应设计系统.

一个内部的,有观点的UI图书馆. 主要重点是在我们的产品中提供由一体和统一的UI、UX和无障碍环境.

* 安装

$ npm i @epignosis_llc/gnosis
$ yarn add @epignosis_llc/gnosis

重新推荐的字体家族是 "Mulish", Arial, sans-serif 因此请不要忘记包含它(当然你可以通过自定义主题来改变默认字体家族——下面是更多信息).

请注意: react >= 16.0.0 财务报告和审定财务报表 react-dom >= 16.0.0 是同伴的依赖关系。 而且,情感11正在被使用,这不会在旧的情感项目中起作用.

使用量

开始将您的 App 包装为 ThemeProvider (见下文实例)。 所有其他组件MUST被放入"主题提供",以获得适当的主题上下文.

import { ThemeProvider, Button } from "@epignosis_llc/gnosis";

function App() {
  return (
    <ThemeProvider>
      <Button>My Button</Button>
    </ThemeProvider>
  );
}

要查看每个组件的所有可用道具复制当前重播和运行 npm install 以安装所有依赖,然后 npm start 以全部可用的道具查看故事书中的所有组件.

主题

您可以使用 gnosis 主题默认主题( 颜色, 字体等) 或自定义以适应您的工程需要 。 本节介绍您可以用来修改它的各种选项.

QQ 全球

您可以通过提供序列化样式来添加全局样式, 如下面的例子 :

const globalStyles = {
  "html, body": {
    background: "red",
  },
  h1: {
    fontSize: "5rem",
    textAlign: "center",
  },
  "#my-id": {
    color: "green",
  },
  ".my-css-class": {
    color: "blue",
  },
};

<ThemeProvider globalStyles={globalStyles}></ThemeProvider>;

QQ 主题配置

也可以简单地通过提供一个新的颜色主题来应用自己的品牌和颜色. 只要找到您需要更改的组件的主题配置 - 下面的示例是用于更改成功按钮颜色 - 并创建一个带有您新值的对象 。 新的主题配置会与默认主题合并,而最终合并的主题会将所有的新值应用到成功按钮(或任何其他组件)上. 默认主题的配置文件位于 ./src/theme/default/config/ 目录 - 例如按钮组件的默认主题是 ./src/theme/default/config/button.ts。查看默认主题的配置并创建/配置您的新自定义主题.

const myCustomTheme = {
  button: {
    success: {
      default: {
        background: "pink",
        borderColor: "red",
        color: "white",
      },
      hover: {
        background: "red",
        borderColor: "pink",
        color: "white",
      },
      active: {
        background: "red",
        borderColor: "pink",
        color: "white",
      },
    },
  },
};

<ThemeProvider theme={myCustomTheme}></ThemeProvider>;

图标

您可以使用这样的自定义 Svg 图标 :

import { HomeSVG, CalendarSVG, CircleQuestionSVG } from "@epignosis_llc/gnosis/icons";

<HomeSVG height={32} />
<CalendarSVG height={32} />
<CircleQuestionSVG height={32} />

您可以查看所有可用的图标名称 gnosis/src/icons/index.ts 或者通过检查适当的故事书页.

即将到来的构成部分

  • 多选择
  • 图表
  • 输入日期
  • 文件输入

版本与发布记录

@epignosis_llc/gnosis 共发布 509 个版本,首次发布于 2021/09/24;过去 12 个月发布了 56 个版本。

版本发布日期距今
6.12.0latest2026/11/121 天前
6.11.12026/10/1925 天前
6.11.02026/10/1628 天前
6.10.02026/09/221 个月前
6.9.02026/09/171 个月前
6.8.22026/09/151 个月前

其他发布通道:next → 1.0.0-next.4,beta → 2.0.0-beta.1。

关于 @epignosis_llc/gnosis 的常见问题

@epignosis_llc/gnosis 是什么?

Epigosis官方反应设计系统.

如何安装 @epignosis_llc/gnosis?

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

@epignosis_llc/gnosis 支持 TypeScript 吗?

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

@epignosis_llc/gnosis 支持 ESM 还是 CommonJS?

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

@epignosis_llc/gnosis 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20.19.0 || >=22.12.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@epignosis_llc/gnosis 可以商用吗?

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

@epignosis_llc/gnosis 的下载量有多少?

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

@epignosis_llc/gnosis 还在维护吗?

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