@anyblades/blades

中文文档
3.1.1发布于 2026/11/04MIT零依赖近 30 天下载 2.9万

Pico CSS的现代接班人.

中文使用文档
文档目录11 节
  1. 快开始
  2. A类. 手动安装
  3. B类. 来自 CDN 的使用
  4. C C. 与国家预防机制安装
  5. D类. 正式启动
  6. 启动 HTML 模板
  7. 文档
  8. 没有闪光的黑暗模式
  9. 缩合大小(可选入)
  10. 委托人
  11. 🥷✨

叶片✨

最小 CSS 框架 页:1 语义 HTML

刀锋CSS是现代的接班人 Pico CSS 软件。 。 。 .

切换一下 pico.css 改为 blades.css- 还有!

开始吧  二. 支助  受到皮克的启发

快开始

有四个开始的方法:

A类. 手动安装

下载 CSS 归档 和链接 css/blades.css 输入 <head> 您的网站.

<link rel="stylesheet" href="css/blades.css" />

B类. 来自 CDN 的使用

<link rel="stylesheet" href="
  https://cdn.jsdelivr.net/npm/@anyblades/blades@3/css/blades.min.css
"/>

现场实例 : https://github.com/pallets/website/blob/main/src/pallets/templates/layout.html 页面存档备份,存于互联网档案馆

CDN上的CSS文件完整列表:https://cdn.jsdelivr.net/npm/@anyblades/blades@3/css/

C C. 与国家预防机制安装

npm install @anyblades/blades

接下来, @import CSS 文件中的刀片 :

@import "@anyblades/blades";

或者,只导入所需的部件,例如每页或每个组件。 他们进来了 @layer blades,所以你的无层风格 胜过他们:

@import "@anyblades/blades/variables";
@import "@anyblades/blades/layout/document";
@import "@anyblades/blades/content/typography";
@import "@anyblades/blades/components/card";
@import "@anyblades/blades/components/modal";
  • variables 财务报告和审定财务报表 layout/document 是最小值; 保持与 src/pico/ index.css (中文(简体) )。 。 。 .
  • 有些部分以其他部分为基础,例如:. components/modal 预期 components/card,以及 components/group 财务报告和审定财务报表 components/dropdown 预期 forms/basics 财务报告和审定财务报表 content/button。 。 。 .
  • 见 分层模块 ,并用捆绑器和组件框架(SvelteKit, Next.js, Nuxt, Astro,...)从JavaScript中导入.
  • 见 软件包.json 用于列出所有出口部件.

D类. 正式启动


启动 HTML 模板

<!doctype html>
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <meta name="color-scheme" content="light dark" />
    <link rel="stylesheet" href="css/blades.css" />
    <title>Hello world!</title>
  </head>
  <body>
    <main class="container">
      <h1>Hello world!</h1>
    </main>
  </body>
</html>

使用Nunjucks,Twig或液体? 检查一下内置 基础 HTML 模板 每个引擎,准备用于您的项目.


文档

如果你知道皮克,你已经知道刀锋:

没有闪光的黑暗模式

有了基于 Pico 的构建, Blades 默认遵循 OS 设置, 没有 JavaScript 和 没有闪光 (参见 暗图) (中文(简体) ). 要强制主题, 设置 data-theme="light" 或者说 "dark" 打开 <html>。在一个嵌入式元素上,当元素绘制出自己的背景时,例如 <article>; 否则添加 background-color: var(--pico-background-color); color: var(--pico-color);。 。 。 .

如果你坚持用户的选择,例如: localStorage 键 theme属性 在第一次油漆之前 内含小脚本 <head>,例如,在SvelteKit's src/app.html数字 :

<script>
  try {
    const theme = localStorage.getItem("theme");
    if (theme === "light" || theme === "dark") document.documentElement.dataset.theme = theme;
  } catch {}
</script>
  • 稍后设置,例如: onMount 或者说 useEffect,使操作系统主题先切换.
  • 在Next.js App路由器布局中,通过与模板文字相同的代码, <script dangerouslySetInnerHTML={{ __html: `try { … } catch {}` }} />,并添加 suppressHydrationWarning 改为 <html>,因为属性在水合之前会改变.

缩合大小(可选入)

添加 <html data-compact> 对于整页,或者将属性放入单个元素上,例如. <form data-compact> 一个表格。 没有属性,没有什么变化.

  • 在那里:
    • 列入 blades.css
    • 也在 blades.layered.css
    • 每部分进口,加上 @anyblades/blades/compact 其他部分之后
    • 与 pico.conditional.css,添加 @anyblades/blades/src/compact 紧接着
  • 哪些变化:
    • 较小的控制垫和1.5雷姆区块间距
    • 0.5雷姆半径和3px焦点环
    • 500重标签和按钮,600重标题
    • 光模式下的白色字段背景
    • 1px卡环而不是模糊的阴影,没有灰色卡片头/脚带
  • 根字体大小 : 打开 <html>,它也将根字体大小保持在100%,而不是随取景口而增长. 在宽度为1280px时,控制为38px而不是62px. 在一个单一的元素上,它们大约是48px,因为每件东西都大小于 rem 而根相续.
  • 字段文本大小 : 窗体控件保持在16px, 因为低于iOS Safari 放大到焦点.

委托人


🥷✨

版本与发布记录

@anyblades/blades 共发布 42 个版本,首次发布于 2026/04/07;过去 12 个月发布了 42 个版本。

版本发布日期距今
3.1.1latest2026/11/042 天前
3.1.02026/11/033 天前
3.1.0-rc.12026/10/298 天前
3.1.0-beta.7canary2026/10/2611 天前
3.1.0-beta.62026/10/2512 天前
3.1.0-beta.52026/10/2314 天前

其他发布通道:alpha → 0.28.0-alpha.8,canary → 3.1.0-beta.7。

关于 @anyblades/blades 的常见问题

@anyblades/blades 是什么?

Pico CSS的现代接班人.

如何安装 @anyblades/blades?

在项目目录运行 npm install @anyblades/blades,或使用 pnpm add / yarn add / bun add。

@anyblades/blades 支持 TypeScript 吗?

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

@anyblades/blades 可以商用吗?

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

@anyblades/blades 的下载量有多少?

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

@anyblades/blades 还在维护吗?

最新版本 3.1.1 发布于 2026/11/04(2 天前);至今共发布 42 个版本,其中过去 12 个月发布了 42 个;首次发布于 2026/04/07。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。