# @guardian/source-foundations 中文文档

规范地址：https://npmcn.com/package/%40guardian/source-foundations/

版本：16\.0\.0
npm 元数据更新时间：2025-10-28T11:48:24.710Z
中文译文更新时间：2026-11-17T03:22:58.798Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40guardian/source-foundations
原文对照：https://npmcn.com/package/%40guardian/source-foundations/?lang=original

弃用说明：Use @guardian/source instead

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

- 包体积（解压后）：314 kB，74 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：tslib ^2\.6\.2，typescript ~5\.3\.3
- 首次发布：2021-10-07T14:46:08.871Z
- 最新版本发布：2024-05-13T13:42:29.511Z
- 近 30 天下载量：8035（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：75（近 12 个月 0 个）

## 中文简介

[![npm](https://img.shields.io/npm/v/@guardian/source-foundations)](https://www.npmjs.com/package/@guardian/source-foundations)

## 安装

```sh
npm install @guardian/source-foundations
```

也可以使用：`pnpm add @guardian/source-foundations`、`yarn add @guardian/source-foundations`、`bun add @guardian/source-foundations`

## README

# `@guardian/source-foundations`

[![npm](https://img.shields.io/npm/v/@guardian/source-foundations)](https://www.npmjs.com/package/@guardian/source-foundations)

我们的外观设计都是从这些原子上建造的。 可用于任何CSS-in-JS图书馆.

此软件包是 [源设计系统](https://npmcn.com/docs/source/README.md)。 。 。 .

## 安装

通过Yarn作为JavaScript软件包安装基础:

```sh
$ yarn add @guardian/source-foundations
```

或:

```sh
$ npm install @guardian/source-foundations
```

## 颜色

守护者的颜色可见于 [`palette` 文档](https://guardian.github.io/csnx/?path=/docs/source-foundations_palette--palette)。 。 。 .

## 空间

我们 [空间](https://guardian.github.io/csnx/?path=/docs/source-foundations_space--page) 系统结构为4px的递增.

```js
import { space } from '@guardian/source-foundations';

const spaceAfter = css`
    margin-bottom: ${space[3]}px;
`;

// margin-bottom: 12px;
```

## 大小

[大小](https://guardian.github.io/csnx/?path=/docs/source-foundations_size--page) 单元可以用来设置一个组件的高度、最大高度、宽度或最大宽度.

```js
import { width, height } from '@guardian/source-foundations';

const checkbox = css`
    width: ${width.inputXsmall}px;
    height: ${height.inputXsmall}px;
`;

// width: 24px;
// height: 24px;
```

## 类型

[类型](https://guardian.github.io/csnx/?path=/docs/source-foundations_typography--headline) 表示为根据所希望的字体家族和大小返回 CSS 片段的方法.

```js
import { headline } from '@guardian/source-foundations';

const h1 = css`
    ${headline.medium()};
`;

// font-family: GH Guardian Headline, Georgia, serif;
// font-size: 2.13rem;
```

## 媒体查询

我们提供 [媒体查询](https://guardian.github.io/csnx/?path=/docs/source-foundations_media-queries--page) 用于我们网格布局中的每个断点.

```js
import { from, until, between } from '@guardian/source-foundations';

const styles = css`
    padding: 0 10px;

    ${from.mobileLandscape} {
        padding: 0 20px;
    }

    ${between.phablet.and.desktop} {
        padding: 0 32px;
    }

    ${until.wide} {
        padding: 0 40px;
    }
`;

// padding: 0 10px;
// @media (min-width: 480px) {
//   padding: 0 20px;
// }
// @media (min-width: 660px) and (max-width: 979px) {
//   padding: 0 32px;
// }
// @media (max-width: 1300px) {
//   padding: 0 40px;
// }
```

## 常见问题

### 如何安装 @guardian/source-foundations？

在项目目录运行 npm install @guardian/source-foundations，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：tslib（^2\.6\.2）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @guardian/source-foundations 支持 TypeScript 吗？

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

### @guardian/source-foundations 支持 ESM 还是 CommonJS？

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

### @guardian/source-foundations 可以商用吗？

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

### @guardian/source-foundations 的下载量有多少？

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

### @guardian/source-foundations 还在维护吗？

最新版本 16\.0\.0 发布于 2024/05/13（2 年前）；至今共发布 75 个版本，其中过去 12 个月发布了 0 个；首次发布于 2021/10/07。作者已将其标记为弃用，新项目建议寻找替代方案。

