@guardian/source-foundations

中文文档
16.0.0发布于 2024/05/13Apache-2.0TypeScriptESM + CJS近 30 天下载 8035

npm

此软件包已被标记为弃用

Use @guardian/source instead

中文使用文档
文档目录6 节
  1. 安装
  2. 颜色
  3. 空间
  4. 大小
  5. 类型
  6. 媒体查询

@guardian/source-foundations

npm

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

此软件包是 源设计系统。 。 。 .

安装

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

$ yarn add @guardian/source-foundations

或:

$ npm install @guardian/source-foundations

颜色

守护者的颜色可见于 palette 文档。 。 。 .

空间

我们 空间 系统结构为4px的递增.

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

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

// margin-bottom: 12px;

大小

大小 单元可以用来设置一个组件的高度、最大高度、宽度或最大宽度.

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

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

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

类型

类型 表示为根据所希望的字体家族和大小返回 CSS 片段的方法.

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

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

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

媒体查询

我们提供 媒体查询 用于我们网格布局中的每个断点.

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 共发布 75 个版本,首次发布于 2021/10/07;过去 12 个月发布了 0 个版本。

版本发布日期距今
16.0.0latest2024/05/132 年前
0.0.0-canary-20240513110200canary2024/05/132 年前
15.0.12024/05/082 年前
0.0.0-canary-202405071603322024/05/082 年前
0.0.0-canary-202405071559112024/05/082 年前
15.0.02024/05/072 年前

其他发布通道:next → 4.0.0-rc.7,canary → 0.0.0-canary-20240513110200。

关于 @guardian/source-foundations 的常见问题

如何安装 @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。作者已将其标记为弃用,新项目建议寻找替代方案。