# @gemeentenijmegen/layout-css 中文文档

规范地址：https://npmcn.com/package/%40gemeentenijmegen/layout-css/

版本：0\.1\.23
npm 元数据更新时间：2026-11-12T12:01:24.019Z
中文译文更新时间：2026-11-16T02:54:47.486Z
软件包许可：EUPL-1\.2

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

原始 npm 页面：https://www.npmjs.com/package/%40gemeentenijmegen/layout-css
原文对照：https://npmcn.com/package/%40gemeentenijmegen/layout-css/?lang=original
项目主页：https://github.com/GemeenteNijmegen/design-system#readme
源码仓库：https://github.com/GemeenteNijmegen/design-system

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

- 包体积（解压后）：478 kB，16 个文件
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2025-04-10T11:37:03.645Z
- 最新版本发布：2026-11-12T12:01:23.190Z
- 近 30 天下载量：2368（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：142（近 12 个月 91 个）

## 中文简介

基于 NL 设计系统架构的设计系统的 CSS 版式

## 安装

```sh
npm install @gemeentenijmegen/layout-css
```

也可以使用：`pnpm add @gemeentenijmegen/layout-css`、`yarn add @gemeentenijmegen/layout-css`、`bun add @gemeentenijmegen/layout-css`

## README

# Nijmegen 设计系统布局

此套件包含了尼梅根市政府设计系统的 Cs 版式选项(断点,容器,网格和间隔). 此软件包的设置基于 [NL 设计系统原则](https://nldesignsystem.nl/richtlijnen/stijl/ruimte/) 并受到 [Bootstrap v5.3 版式](https://getbootstrap.com/docs/5.3/layout)。 。 。 .

## 断点

此布局包含6个断点, 具有默认值, 可以使用基于您设计符号的 Sass 变量来自定义 .

| 断点 | 类词 | 默认尺寸 | 设计符号 | Sass 变量 |
| --- | --- | --- | --- | --- |
| 额外小型 |  | < 576px (英语) | `nijmegen.breakpoint.xs` | `$nijmegen-breakpoint-xs` |
| 小型 | 静态 | ≥576px | `nijmegen.breakpoint.sm` | `$nijmegen-breakpoint-sm` |
| 中型 | 数字 | • 768px | `nijmegen.breakpoint.md` | `$nijmegen-breakpoint-md` |
| 大块 | 长 | ≥992px | `nijmegen.breakpoint.lg` | `$nijmegen-breakpoint-lg` |
| 额外大项 | 页:1 | ≥1200px | `nijmegen.breakpoint.xl` | `$nijmegen-breakpoint-xl` |
| 额外大项 | 页:1 | ≥ 1400px | `nijmegen.breakpoint.xxl` | `$nijmegen-breakpoint-xxl` |

## 集装箱

集装箱是执行 [5.3 集装箱](https://getbootstrap.com/docs/5.3/layout/containers/)。执行中包含所有三个不同的集装箱,并有定制类别名称:

-   `.nijmegen-container`,设置 `max-width` 在每个响应断点
-   `.nijmegen-container-{breakpoint}`,这是 `width: 100%` 直到指定的断点
-   `.nijmegen-container-fluid`,这是 `width: 100%` 在所有断点上

以下内容: `max-width` 使用 wicht 的值可以根据设计符号的执行而自定义 :

| 断点 | 默认 `max-width` 价值 | 设计符号 | Sass 变量 |
| --- | --- | --- | --- |
| 额外小型 | 100% |  |  |
| 小型 | 540px 调试 | `nijmegen.container.max-width.sm` | `$nijmegen-container-max-width-sm` |
| 中型 | 720px (英语) | `nijmegen.container.max-width.md` | `$nijmegen-container-max-width-md` |
| 大块 | 960px (英语) | `nijmegen.container.max-width.lg` | `$nijmegen-container-max-width-lg` |
| 额外大项 | 1140px (英语) | `nijmegen.container.max-width.xl` | `$nijmegen-container-max-width-xl` |
| 额外大项 | 1320px (英语) | `nijmegen.container.max-width.xxl` | `$nijmegen-container-max-width-xxl` |

其他容器设计标志 :

| 设计符号 | 默认值 | Sass 变量 | Css 变量 |
| --- | --- | --- | --- |
| `nijmegen.container.padding-inline-start` | `nijmegen.space.25` | `$nijmegen-container-padding-inline-start` | `var(--nijmegen-container-padding-inline-start)` |
| `nijmegen.container.padding-inline-end` | `nijmegen.space.25` | `$nijmegen-container-padding-inline-end` | `var(--nijmegen-container-padding-inline-end)` |

### 默认容器

```html
<div class="nijmegen-container">
  <!-- Content here -->
</div>
```

### 反应容器

```html
<div class="nijmegen-container-sm">100% wide until small breakpoint</div>
<div class="nijmegen-container-md">100% wide until medium breakpoint</div>
<div class="nijmegen-container-lg">100% wide until large breakpoint</div>
<div class="nijmegen-container-xl">100% wide until extra large breakpoint</div>
<div class="nijmegen-container-xxl">100% wide until extra extra large breakpoint</div>
```

### 流体容器(全宽)

```html
<div class="nijmegen-container-fluid">
  <!-- Content here -->
</div>
```

## 网格

电网系统是执行 [鞋带v5.3 CSS 网格](https://getbootstrap.com/docs/5.3/layout/css-grid/)。默认设置是需要放在 `nijmegen-grid` 键。 网格支持响应分级来调整整个取景口的布局.

| 设计符号 | 默认值 | Sass 变量 | Css 变量 |
| --- | --- | --- | --- |
| `nijmegen.grid.columns` | 第12条 | `$nijmegen-grid-columns` |  |
| `nijmegen.grid.gap` | 1.5雷姆(1.5雷姆) | `$nijmegen-grid-gap` | `var(--nijmegen-grid-gap)` |
| `nijmegen.grid.rows` | 1个 | `$nijmegen-grid-rows` | `var(--nijmegen-grid-rows)` |

### 列数

```html
<div class="nijmegen-grid">
  <div class="nijmegen-g-col-4">col 1/3</div>
  <div class="nijmegen-g-col-4">col 2/3</div>
  <div class="nijmegen-g-col-4">col 3/3</div>
</div>
```

### 响应

以下例子有2个列,但从中断点及以上扩展为3个列.

```html
<div class="nijmegen-grid">
  <div class="nijmegen-g-col-6 nijmegen-g-col-md-4">.nijmegen-g-col-6 .nijmegen-g-col-md-4</div>
  <div class="nijmegen-g-col-6 nijmegen-g-col-md-4">.nijmegen-g-col-6 .nijmegen-g-col-md-4</div>
  <div class="nijmegen-g-col-6 nijmegen-g-col-md-4">.nijmegen-g-col-6 .nijmegen-g-col-md-4</div>
</div>
```

### 开始

有了起步课,您就可以执行(响应)列的起步点.

```html
<div class="nijmegen-grid">
  <div class="nijmegen-g-col-3 nijmegen-g-start-2">start by 2 col with a 3 col width column</div>
  <div class="nijmegen-g-col-4 nijmegen-g-start-6">.start by 6 col with a 4 col width column</div>
</div>
```

### 其它

请检查url=值 (帮助) [Bootstrap v5.3 文档](https://getbootstrap.com/docs/5.3/layout/css-grid/) 详细情况.

## 间距

间距是设定的响应性包装 `margin-inline-start`, (中文(简体) ), `margin-inline-end`, (中文(简体) ), `padding-inline-start` 财务报告和审定财务报表 `padding-inline-end` 基于 [Bootstrap v5.3 间隔工具 api](https://getbootstrap.com/docs/5.3/utilities/spacing/)。 API 生成了自定义( 响应) 类, 并附有以下标记 `nijmegen-{{property}{side}{breakpoint}-{size}`。 。 。 .

**`{property}` 选项:**

-   `margin-inline`,水平边距
-   `padding-inline`横向粘贴
-   `margin-block`垂直比值
-   `padding-block`横向粘贴

**`{side}` 选项:**

-   `-start`
-   `-end`
-   空白, 用于两侧

**`{breakpoint}` 选项:**

-   `-sm`
-   `-md`
-   `-lg`
-   `-xl`
-   `-xxl`
-   空白, 在所有视图中使用

**`{size}` 选项:**

-   `0`
-   `12`
-   `25`
-   `50`
-   `75`
-   `100`
-   `125`
-   `150`
-   `200`
-   `250`
-   `300`
-   `400`
-   `500`
-   `600`

默认情况下 `!important` 语句会添加到所有间距内,以确保如果设置类,则强制添加正确的间距。 您可以通过修改以下 Sass 变量并重编 `layout.scss` 文档.

```scss
$nijmegen-enable-important-utilities-on-spacing: false;
```

### 设计符号

| 设计符号 | 默认值 | Sass 变量 | Css 变量 |
| --- | --- | --- | --- |
| `nijmegen.space.0` | 0 个 | `map.set($nijmegen-space, "0", $new-value);` | `var(--nijmegen-space-0)` |
| `nijmegen.space.12` | 0.125雷姆 | `map.set($nijmegen-space, "12", $new-value);` | `var(--nijmegen-space-12)` |
| `nijmegen.space.25` | 0.25雷姆(0.25雷姆) | `map.set($nijmegen-space, "25", $new-value);` | `var(--nijmegen-space-25)` |
| `nijmegen.space.50` | 0.5雷姆(0.5雷姆) | `map.set($nijmegen-space, "50", $new-value);` | `var(--nijmegen-space-50)` |
| `nijmegen.space.75` | 0.75亿雷姆 | `map.set($nijmegen-space, "75", $new-value);` | `var(--nijmegen-space-75)` |
| `nijmegen.space.100` | 1雷姆( 1雷姆) | `map.set($nijmegen-space, "100", $new-value);` | `var(--nijmegen-space-100)` |
| `nijmegen.space.125` | 1.25雷门 | `map.set($nijmegen-space, "125", $new-value);` | `var(--nijmegen-space-125)` |
| `nijmegen.space.150` | 1.5雷姆(1.5雷姆) | `map.set($nijmegen-space, "150", $new-value);` | `var(--nijmegen-space-150)` |
| `nijmegen.space.200` | 2点 | `map.set($nijmegen-space, "200", $new-value);` | `var(--nijmegen-space-200)` |
| `nijmegen.space.250` | 2.5雷姆(2.5雷姆) | `map.set($nijmegen-space, "250", $new-value);` | `var(--nijmegen-space-250)` |
| `nijmegen.space.300` | 3个雷姆 | `map.set($nijmegen-space, "300", $new-value);` | `var(--nijmegen-space-300)` |
| `nijmegen.space.400` | 4雷姆语 | `map.set($nijmegen-space, "400", $new-value);` | `var(--nijmegen-space-400)` |
| `nijmegen.space.500` | 5雷姆语 | `map.set($nijmegen-space, "500", $new-value);` | `var(--nijmegen-space-500)` |
| `nijmegen.space.600` | 6小时 | `map.set($nijmegen-space, "600", $new-value);` | `var(--nijmegen-space-600)` |

### 水平中枢

这个 `.nijmegen-margin-inline-auto` 分类可用于横向中心内容 `display: block` (单位:千美元) `width` 设置.

```html
<div class="nijmegen-margin-inline-auto" style="width: 200px;">Vertically centered element</div>
```

### 实例

```html
<div class="nijmegen-margin-inline-start-25">start 0.25rem margin</div>

<div class="nijmegen-margin-inline-end-250">end 2.5rem margin</div>

<div class="nijmegen-margin-inline-300">horizonal 3rem margin</div>

<div class="nijmegen-padding-inline-500">horizontal 5rem padding</div>

<div class="nijmegen-margin-block-start-0">vertical 0 margin</div>

<div class="nijmegen-margin-block-end-75">vertical end 0.75rem margin</div>

<div class="nijmegen-margin-block-300">vertical 3rem margin</div>

<div class="nijmegen-padding-block-600">vertical 6rem padding</div>
```

## 自定义

根据前述设计符号可以使用您的 onw 值 。 大多数设计符号都有CSS可变的定制选项,但 **只能使用 Sass 变量来自定义一些符号**。例如,断点被用于媒体查询中,所以只能通过装入设计符号 sass 文件并编译 `layout.scss` 将文件移至您的自定义 Css 文件。 使用 cs 变量选项 `var()` 无法实现,因为此函数只能用于设定元素属性的值, [见 W3 文件](https://www.w3.org/TR/css-variables-1/#using-variables)。 。 。 .

### 通过 Sass 变量示例

自定义。scs :

```scss
@import "~gemeentenijmegen/layout-css/src/layout";

// import or write your variables
@import "~gemeentenijmegen/design-tokens/dist/variables
```

例如通过使用 [滚动](https://rollupjs.org/)

卷起. config.mjs:

```js
export default {
  input: "custom.scss",
  output: {
    file: "dist/my-layout.css",
    format: "esm",
  },
};
```

现在运行 :

```zsh
rollup -c
```

### 通过 CSS 示例 `var()`

```html
<!doctype html>
<html lang="nl">
  <head>
    <title>Example page</title>
    <link rel="stylesheet" href="node_modules/@gemeentenijmegen/layout-css/dist/layout.min.css" />
    <!-- load your custom design tokens -->
    <link rel="stylesheet" href="node_modules/@gemeentenijmegen/design-tokens/dist/index.css'" />
    <!-- or write them in your own "theme" following NL Design System standards -->
    <style>
      .my-theme {
        --nijmegen-space-inline-0: 0.5rem;
      }
    </style>
  </head>
  <body>
    <div class="nijmegen-theme">
      <div class="nijmegen-padding-inline-0">0rem horizontal padding</div>
    </div>
    <div class="my-theme">
      <div class="nijmegen-padding-inline-0">0.5rem horizontal padding</div>
    </div>
  </body>
</html>
```

## 许可证

根据EUPL v1.2 许可证分发.

## 常见问题

### @gemeentenijmegen/layout-css 是什么？

基于 NL 设计系统架构的设计系统的 CSS 版式

### 如何安装 @gemeentenijmegen/layout-css？

在项目目录运行 npm install @gemeentenijmegen/layout-css，或使用 pnpm add / yarn add / bun add。

### @gemeentenijmegen/layout-css 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/gemeentenijmegen\_\_layout-css 是否存在。

### @gemeentenijmegen/layout-css 可以商用吗？

@gemeentenijmegen/layout-css 使用 EUPL-1\.2 许可。声明的许可为 EUPL-1\.2，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @gemeentenijmegen/layout-css 的下载量有多少？

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

### @gemeentenijmegen/layout-css 还在维护吗？

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

