@gov-design-system-ce/react

中文文档
4.7.3发布于 2026/10/21EUPL-1.2TypeScriptESM + CJS近 30 天下载 9130

本套件中包含一个为React所特有并被设计用于Gov Design System CE组件的包装.

中文使用文档
文档目录7 节
  1. 使用量
  2. 安装
  3. 导入样式
  4. 使用组件
  5. 时间线需要网络组件
  6. 建筑
  7. 版权

Gov 设计系统 - 反应包装器

本套件中包含一个为React所特有并被设计用于Gov Design System CE组件的包装.

使用量

有关使用说明,请参见: 文档。 。 。 .

安装

npm install @gov-design-system-ce/react@latest @gov-design-system-ce/styles@latest

导入样式

与Vue和Angular包装不同,反应包装是 没有 a Web 组件代理——它使光-DOM标记与 .gov-* 课程。 因此,它需要完整的样式表, 包括组件样式数字 :

@import "@gov-design-system-ce/styles/tokens.css";
@import "@gov-design-system-ce/styles/styles.css";
@import "@gov-design-system-ce/styles/layout.css";
@import "@gov-design-system-ce/styles/content.css";
@import "@gov-design-system-ce/styles/components.css";
@import "@gov-design-system-ce/styles/animations.css";

自4.7.0起,样式表生活在软件包根上——前者 html/* 路径被删除.

图标和字体从 /assets/icons 财务报告和审定财务报表 /assets/fonts ——见: 用于开发者 用于资产设置的页面.

使用组件

每个组件按名称导入:

import { GovButton } from "@gov-design-system-ce/react";

export function Example() {
  return (
    <GovButton color="primary" type="solid">
      Click me
    </GovButton>
  );
}

时间线需要网络组件

GovTimeline, (中文(简体) ), GovTimelineCategory, (中文(简体) ), GovTimelineStep 财务报告和审定财务报表 GovTimelineCard 无国籍标记模式的例外: gov-timeline* 自定义元素,因为时间线在运行时间(spine, steps, 滚动- spy division)中被设定出. 网络组件在应用程序启动时必须注册,否则元素将保持惰性 GovTimeline 日志开发警告 :

import { defineCustomElements } from "@gov-design-system-ce/components/loader";

defineCustomElements();

它们按网页组件样式表排列(@gov-design-system-ce/styles/tokens.css, (中文(简体) ), styles.css, (中文(简体) ), components.css, (中文(简体) ), animations.css),不是通过 html/* 以上列出。 这个 ref 联 合 国 GovTimeline 是元素,所以 ref.current.refresh() 具备,以及 onGovChange 接收时间线本身 gov-change 事件(a) gov-change 从卡片内容中跳出,如表单控件,不会被传递). 所有四个包裹都通过 id, (中文(简体) ), style, (中文(简体) ), aria-* 财务报告和审定财务报表 data-* 穿过到元素。 各给 GovTimelineCategory 其本身 id 当其部分紧密相连时/page#priprava: 生成的id取决于页面和类别顺序.

服务器端渲染( Next.js等) : 服务器只生成 gov-timeline* 元素及其属性和子; 轴、点和导航由浏览器中的网页组件所添加。 打电话 defineCustomElements() 只在水合后,例如a useEffect ,因为在回放水合物之前升级的元素会改变 DOM 并导致水合不匹配:

import { useEffect } from "react";
import { defineCustomElements } from "@gov-design-system-ce/components/loader";

export function App({ children }) {
  useEffect(() => {
    defineCustomElements();
  }, []);
  return children;
}

完全由服务器发送的时间线标记(轴、点和导航)仅取自 Stencil hydrate 软件包 renderToString不是来自反应SSR.

建筑

与 core-vue 编号 : core-angular,其代理文件来自 Stencil 核心(vueOutputTarget 编号 : angularOutputTarget, (中文(简体) ), core-react 是一个 手写反应再执行 部分内容。 构建目标编译 src/ 与 tsc 加入ES模块外加类型声明 dist/。 。 。 .

版权(c)2020-2026 Digitální a informationační agentura 互联网档案馆的存檔,存档日期2013-12-02

版本与发布记录

@gov-design-system-ce/react 共发布 112 个版本,首次发布于 2023/02/15;过去 12 个月发布了 4 个版本。

版本发布日期距今
4.7.3latest2026/10/2126 天前
4.7.22026/10/151 个月前
4.7.12026/09/241 个月前
4.7.02026/08/192 个月前
3.4.02025/08/261.2 年前
3.3.12025/08/201.2 年前

其他发布通道:beta → 2.4.2。

关于 @gov-design-system-ce/react 的常见问题

@gov-design-system-ce/react 是什么?

本套件中包含一个为React所特有并被设计用于Gov Design System CE组件的包装.

如何安装 @gov-design-system-ce/react?

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

@gov-design-system-ce/react 支持 TypeScript 吗?

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

@gov-design-system-ce/react 支持 ESM 还是 CommonJS?

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

@gov-design-system-ce/react 可以商用吗?

@gov-design-system-ce/react 使用 EUPL-1.2 许可。声明的许可为 EUPL-1.2,请阅读许可原文确认使用条件。以上为概括,不构成法律意见,请以许可原文为准。

@gov-design-system-ce/react 的下载量有多少?

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

@gov-design-system-ce/react 还在维护吗?

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