@cplieger/ui

中文文档
1.2.0发布于 2026/11/11Apache-2.0ES Module零依赖构建来源已验证近 30 天下载 4127

一种设计语言和它上建的组件,用于浏览器应用程序绘制其与平版 HTML 和 DOM 代码的接口

中文使用文档
文档目录10 节
  1. 为什么用它
  2. 安装
  3. 使用量
  4. 子路径
  5. API 密码
  6. 文档
  7. 贷项
  8. 捐款
  9. 免责声明
  10. 许可证

欧

npm JSR Mutation (TS)

@cplieger/ui 是一种设计语言和它上所建的组件,用于浏览器应用程序绘制其与平版HTML和DOM代码的接口.

A library screen in the design language: a coloured header with destinations, a rail of filters with counts, a table of entries with posters, chips and row actions, and a status line

样式表样式为浏览器自己的元素和一组 .cp-* 课,光和暗, 从几色种子 每个应用程序集。 每个脚本只添加浏览器所缺少的东西,如菜单的密钥或祝酒会队列. 它没有运行时间依赖和船舶作为只使用无害环境管理的TypeScript源,因此它需要一个编译TypeScript 6或更晚的捆绑器. 它需要Chrome或Edge 147,Firefox 147或Safari 26.4或后期.

为什么用它

  • 对话框、弹出和披露是浏览器自己的 <dialog>, (中文(简体) ), popover 财务报告和审定财务报表 <details>,所以聚焦, Escape, 弹出器外的媒体 和顶层的工作 没有脚本.
  • 每个控件都为鼠标或从上个正指针取出指针的一高一大小本身,因此一行字段和按钮会排列在桌面上和拇指下.
  • 样式表计算出每个颜色步骤,主题和和谐的颜色都来自口音和中和的花色,测试时会保存出每对文字并填充到它的对比.
  • 每个组件都从你打的电话开始,在装入时不碰任何东西,所以一个捆绑器会掉入你没有导入的东西. 留在页面上的人需要 AbortSignal 在它的一生中.

考虑 Pico CSS 软件 用于内容页面上的无类样式,或 肖莱斯 用于网络组件.

安装

npm i @cplieger/ui
# or
npx jsr add @cplieger/ui

使用量

导入样式表, 设置 class="cp" 打开 <html> 并设定种子:

import "@cplieger/ui/css/system";
:root {
  --cp-accent-h: 255;
  --cp-accent-c: 0.137;
}

以其类和浏览器的元素来构建,然后在启动时添加页面所需的脚本 :

<button class="cp-button" type="button" popovertarget="sort">Sort</button>
<div class="cp-popover cp-menu" popover id="sort" role="menu">
  <button role="menuitemradio" aria-checked="true" type="button">Name</button>
  <button role="menuitemradio" aria-checked="false" type="button">Added</button>
</div>
import { installAnchors } from "@cplieger/ui/anchor";
import { enhanceMenu } from "@cplieger/ui/menu";
import { installPress } from "@cplieger/ui/press";
import { toast } from "@cplieger/ui/toast";

const page = new AbortController();
installPress({ signal: page.signal });
installAnchors({ signal: page.signal });
enhanceMenu(sortMenu, { signal: page.signal, onSelect: (item) => sortBy(item.textContent) });

toast({ kind: "success", title: "Saved" });

子路径

从它所持有的
@cplieger/ui/css/system设计语言的样式表,仅在 npm 上
@cplieger/ui/fonts/*其两个字体, 仅在 npm 上
@cplieger/ui/icons卢西德在包裹中的线条 自己画的几幅画 还有画的工厂
@cplieger/ui/<module>一个组件的脚本

API 密码

每个模块都是一个子路径,按其用途分类如下:

本文全文取自文件评论 日 尔。对于信号,按键 DOM 渲染、请求和服务器动作,使用 @cplieger/reactive上面的应用程序通过它的主人 signal 这里每个组件.

文档

  • 这个 原则 是否决定每一部分如下.
  • 这个 设计语言 覆盖类型、布局、触摸、形状和运动,以及 颜色 种子、台阶、音调和和谐的颜色.
  • 构成部分 列出每一类样式表船.
  • 设计模式 覆盖加载、表单、表格、标签、对话框、通知、第一运行、导航和单词 设置 财务报告和审定财务报表 账户屏幕 在他们自己的页面.
  • 从早期的子路径移动 绘制每个子路径 之前的释放带到它的替换.

贷项

捐款

见 捐款额。 。 。 .

免责声明

这个项目是精心设计的,遵循安全最佳做法,但打算供个人/自发使用。 不保证生产环境的适宜性. 自己冒险使用.

这个项目是在大赦国际的协助下建立的。 人类维护者定义建筑,监督执行,并作出所有最终决定.

许可证

阿帕奇2.0 (英语). 见 自由主义。 。 。 .

第三方的归属 第三次议会 NoTICES.md。 。 。 .

版本与发布记录

@cplieger/ui 共发布 27 个版本,首次发布于 2026/11/04;过去 12 个月发布了 27 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.2.0latest2026/11/11今天
1.2.0-dev.11dev2026/11/11今天
1.2.0-dev.102026/11/11今天
1.2.0-dev.92026/11/11今天
1.2.0-dev.82026/11/11今天
1.2.0-dev.72026/11/11今天

关于 @cplieger/ui 的常见问题

@cplieger/ui 是什么?

一种设计语言和它上建的组件,用于浏览器应用程序绘制其与平版 HTML 和 DOM 代码的接口

如何安装 @cplieger/ui?

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

@cplieger/ui 支持 TypeScript 吗?

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

@cplieger/ui 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@cplieger/ui 可以商用吗?

@cplieger/ui 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@cplieger/ui 的下载量有多少?

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

@cplieger/ui 还在维护吗?

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