@gemeentenijmegen/layout-css

中文文档
0.1.23发布于 2026/11/12EUPL-1.2零依赖近 30 天下载 2368

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

中文使用文档
文档目录18 节
  1. 断点
  2. 集装箱
  3. 默认容器
  4. 反应容器
  5. 流体容器(全宽)
  6. 网格
  7. 列数
  8. 响应
  9. 开始
  10. 其它
  11. 间距
  12. 设计符号
  13. 水平中枢
  14. 实例
  15. 自定义
  16. 通过 Sass 变量示例
  17. 通过 CSS 示例 var()
  18. 许可证

Nijmegen 设计系统布局

此套件包含了尼梅根市政府设计系统的 Cs 版式选项(断点,容器,网格和间隔). 此软件包的设置基于 NL 设计系统原则 并受到 Bootstrap v5.3 版式。 。 。 .

断点

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

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

集装箱

集装箱是执行 5.3 集装箱。执行中包含所有三个不同的集装箱,并有定制类别名称:

  • .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-startnijmegen.space.25$nijmegen-container-padding-inline-startvar(--nijmegen-container-padding-inline-start)
nijmegen.container.padding-inline-endnijmegen.space.25$nijmegen-container-padding-inline-endvar(--nijmegen-container-padding-inline-end)

默认容器

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

反应容器

<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>

流体容器(全宽)

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

网格

电网系统是执行 鞋带v5.3 CSS 网格。默认设置是需要放在 nijmegen-grid 键。 网格支持响应分级来调整整个取景口的布局.

设计符号默认值Sass 变量Css 变量
nijmegen.grid.columns第12条$nijmegen-grid-columns
nijmegen.grid.gap1.5雷姆(1.5雷姆)$nijmegen-grid-gapvar(--nijmegen-grid-gap)
nijmegen.grid.rows1个$nijmegen-grid-rowsvar(--nijmegen-grid-rows)

列数

<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个列.

<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>

开始

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

<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 文档 详细情况.

间距

间距是设定的响应性包装 margin-inline-start, (中文(简体) ), margin-inline-end, (中文(简体) ), padding-inline-start 财务报告和审定财务报表 padding-inline-end 基于 Bootstrap v5.3 间隔工具 api。 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 文档.

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

设计符号

设计符号默认值Sass 变量Css 变量
nijmegen.space.00 个map.set($nijmegen-space, "0", $new-value);var(--nijmegen-space-0)
nijmegen.space.120.125雷姆map.set($nijmegen-space, "12", $new-value);var(--nijmegen-space-12)
nijmegen.space.250.25雷姆(0.25雷姆)map.set($nijmegen-space, "25", $new-value);var(--nijmegen-space-25)
nijmegen.space.500.5雷姆(0.5雷姆)map.set($nijmegen-space, "50", $new-value);var(--nijmegen-space-50)
nijmegen.space.750.75亿雷姆map.set($nijmegen-space, "75", $new-value);var(--nijmegen-space-75)
nijmegen.space.1001雷姆( 1雷姆)map.set($nijmegen-space, "100", $new-value);var(--nijmegen-space-100)
nijmegen.space.1251.25雷门map.set($nijmegen-space, "125", $new-value);var(--nijmegen-space-125)
nijmegen.space.1501.5雷姆(1.5雷姆)map.set($nijmegen-space, "150", $new-value);var(--nijmegen-space-150)
nijmegen.space.2002点map.set($nijmegen-space, "200", $new-value);var(--nijmegen-space-200)
nijmegen.space.2502.5雷姆(2.5雷姆)map.set($nijmegen-space, "250", $new-value);var(--nijmegen-space-250)
nijmegen.space.3003个雷姆map.set($nijmegen-space, "300", $new-value);var(--nijmegen-space-300)
nijmegen.space.4004雷姆语map.set($nijmegen-space, "400", $new-value);var(--nijmegen-space-400)
nijmegen.space.5005雷姆语map.set($nijmegen-space, "500", $new-value);var(--nijmegen-space-500)
nijmegen.space.6006小时map.set($nijmegen-space, "600", $new-value);var(--nijmegen-space-600)

水平中枢

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

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

实例

<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 文件。 。 。 .

通过 Sass 变量示例

自定义。scs :

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

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

例如通过使用 滚动

卷起. config.mjs:

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

现在运行 :

rollup -c

通过 CSS 示例 var()

<!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 共发布 142 个版本,首次发布于 2025/04/10;过去 12 个月发布了 91 个版本。

版本发布日期距今
0.1.23latest2026/11/123 天前
0.1.222026/11/114 天前
0.1.212026/11/114 天前
0.1.202026/11/105 天前
0.1.192026/11/105 天前
0.1.182026/11/105 天前

关于 @gemeentenijmegen/layout-css 的常见问题

@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 和提交记录判断。