# @gokberknur/design-system 中文文档

规范地址：https://npmcn.com/package/%40gokberknur/design-system/

版本：0\.31\.0
npm 元数据更新时间：2026-11-08T22:54:31.868Z
中文译文更新时间：2026-11-16T18:35:33.146Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40gokberknur/design-system
原文对照：https://npmcn.com/package/%40gokberknur/design-system/?lang=original
项目主页：https://design.gokberk.se/
源码仓库：https://github.com/gokberknur/gokberk-design-system

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

- 包体积（解压后）：4.2 MB，675 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=24
- 运行依赖：5 个
- peer 依赖：@types/react \>=18
- 首次发布：2026-06-24T18:06:52.499Z
- 最新版本发布：2026-11-08T22:54:31.737Z
- 近 30 天下载量：3890（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：44（近 12 个月 44 个）

## 中文简介

个性化,最小化和编辑设计系统:框架-可知性高克-\*网络组件+设计符号,用Lit来构建. 一个绿色口音,Geist,WCAG AA,轻/暗.

## 安装

```sh
npm install @gokberknur/design-system
```

也可以使用：`pnpm add @gokberknur/design-system`、`yarn add @gokberknur/design-system`、`bun add @gokberknur/design-system`

## README

# gökberk 设计系统

[![npm](https://img.shields.io/npm/v/@gokberknur/design-system?color=1a5a34&label=npm)](https://www.npmjs.com/package/@gokberknur/design-system) [![license: MIT](https://img.shields.io/npm/l/@gokberknur/design-system?color=1a5a34)](https://www.npmjs.com/package/@gokberknur/design-system) [![types](https://img.shields.io/badge/types-included-1a5a34)](https://www.npmjs.com/package/@gokberknur/design-system)

**我不是一个品牌。 无论如何,我建造了设计系统——我把它用于我的爱好项目.**

gökberk是一种个人的UI身份,使用的方法最少,口音颜色也很少. 构成部分 以 [升](https://lit.dev/),因此它们可用于任何 受欢迎的JavaScript库——回放,Angular,Vue,Svelte,或香草JS.

**[现场现场](https://design.gokberk.se/)** • 妇女 **[见用中](https://bank.gokberk.se/)**

## 安装

```bash
npm i @gokberknur/design-system
```

重命名:更改口音、中性、字体或角并检查对比度 `npx gok-check-brand`; 见 [文档/重命名](https://npmcn.com/package/%40gokberknur/design-system/docs/rebranding.md)。 。 。 .

浏览器支持: 见 [文档/浏览器支持](https://npmcn.com/package/%40gokberknur/design-system/docs/browser-support.md)。 。 。 .

无障碍:见 [WCAG 2.2合规报告](https://npmcn.com/package/%40gokberknur/design-system/docs/accessibility-conformance.md)。 。 。 .

## 快开始

装入基础一次, 然后导入您使用的元素 :

```js
import '@gokberknur/design-system/standalone.css'; // fonts + tokens + typography + layout
import '@gokberknur/design-system/gok-button';      // register an element (side-effect import)
```

```html
<gok-button>Get started</gok-button>
```

组件读取了符号,所以当CSS被装入时,主题和密度就会工作.

## 他们

根上的一个属性将一切主题重定(它连入了阴影DOM):

```html
<html data-theme="dark" data-density="compact"></html>
```

`data-theme` 实值 `light` • 妇女 `dark` • 妇女 `auto`· ; `data-density` 实值 `regular` • 妇女 `compact`。每种颜色 配对被验证 **WCAG AAA 亚军** 关于这两个主题.

## 里面的东西

**51个家庭的64个习俗要素**,加上地基层——设计标志,反应灵敏 类型尺度,自主办Geist。 分组为动作输入 · 反馈 · 导航 · 重叠 · 数据 显示-布局.

-   `gok-` 元素前缀 ^ `--gok-*` 符号前缀.
-   每个元件船轴式清洁,并有捆绑的TypeScript类型和一个 `custom-elements.json` 显出.
-   可树摇动——只导入您使用的东西,或 `@gokberknur/design-system/standalone` 注册 一时一切.

## 探索

-   **基金会** (托盘 · 类型 · 颜色) - [https://design.gokberk.se/ site/ (中文(简体) )](https://design.gokberk.se/site/)
-   **构成部分** —— 说 [https://design.gokberk.se/ site/组件/ 页面存档备份,存于互联网档案馆](https://design.gokberk.se/site/components/)
-   **在真正的应用程序中看到它** —— 说 [https://bank.gokberk.se (英语)](https://bank.gokberk.se/)一个基于这个包的银行应用软件.

## 许可证

MIT (代码). Geist & Geist Mono属于SIL开放字体许可证1.1. 由 [古克贝克·努尔](https://gokberk.se/)。 。 。 .

## 常见问题

### @gokberknur/design-system 是什么？

个性化,最小化和编辑设计系统:框架-可知性高克-\*网络组件\+设计符号,用Lit来构建\. 一个绿色口音,Geist,WCAG AA,轻/暗\.

### 如何安装 @gokberknur/design-system？

在项目目录运行 npm install @gokberknur/design-system，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 gok-check-brand，可以用 npx gok-check-brand 直接运行。

### @gokberknur/design-system 支持 TypeScript 吗？

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

### @gokberknur/design-system 支持 ESM 还是 CommonJS？

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

### @gokberknur/design-system 需要什么版本的 Node\.js？

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

### @gokberknur/design-system 可以商用吗？

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

### @gokberknur/design-system 的下载量有多少？

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

### @gokberknur/design-system 还在维护吗？

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

