@bluecateng/pelagos

中文文档
12.28.6发布于 2026/10/30ISCTypeScriptCommonJS构建来源已验证近 30 天下载 3483

UI 组件

中文使用文档
文档目录8 节
  1. 安装
  2. 开始
  3. 固定主题
  4. 用户选择的主题
  5. 版式
  6. 故事书
  7. 示例应用程序
  8. AI 编码代理的说明

@bluecateng/ pelagos (英语) GitHub license npm version

UI组件.

安装

npm i -S @bluecateng/pelagos

开始

在应用程序条目中添加共享组件样式 .less 文档. 下面选择一个主题设置; 核心和旋转主题必须使用相同的 光或暗变相.

固定主题

对于总是使用一个主题的应用程序,导入固定核心和 旋转主题文件 :

@import '@bluecateng/pelagos/less/core';
@import '@bluecateng/pelagos/less/core-dark'; // or core-light
@import '@bluecateng/pelagos/less/inputs';
@import '@bluecateng/pelagos/less/scrollbar';
@import '@bluecateng/pelagos/less/spinner-dark'; // or spinner-light

用户选择的主题

对于运行时间主题选择, 导入主题和自旋器基础, 然后绑定 他们的混入到根属性。 这是示例使用的设置 应用.

@import '@bluecateng/pelagos/less/core';
@import '@bluecateng/pelagos/less/themes';
@import '@bluecateng/pelagos/less/inputs';
@import '@bluecateng/pelagos/less/scrollbar';
@import '@bluecateng/pelagos/less/spinner';

[data-theme='light'],
[data-theme='auto'] {
    .theme-light();
}

[data-theme='dark'] {
    .theme-dark();
}

[data-theme='auto'] {
    @media (prefers-color-scheme: dark) {
        .theme-dark();
    }
}

.CssSpinner {
    .css-spinner();

    [data-theme='light'] &,
    [data-theme='auto'] & {
        animation-name: spinner-light;
    }

    [data-theme='dark'] & {
        animation-name: spinner-dark;
    }

    [data-theme='auto'] & {
        @media (prefers-color-scheme: dark) {
            animation-name: spinner-dark;
        }
    }
}

将属性设置在根元素上( R)<html data-theme="auto">)和更新 document.documentElement.dataset.theme 在运行时切换。 这个 auto 上方绑定遵循操作系统偏好。 部件从CSS取出颜色 主题提供的自定义属性; 导入 core 没有两个主题 设置让它们无色或无外形.

版式

核心样式采用有意见的重置(内置) @layer pelagos: div, (中文(简体) ), form, (中文(简体) ), main, (中文(简体) ), header,以及 footer 默认为

display: flex;
flex-direction: column;
flex: none;

每个平地 div 因此,已经是一列弹性容器——列出 行为 flex-direction: row 而不是在 对抗默认. flex: none 也意味着儿童不会成长; 设置 flex: 1 明确内容应填入可用空间.

故事书

实例和文件请参见: 故事书网站

示例应用程序

种族实例 是一个 小型可运行应用程序,其示例按每个实例索引 演示——包括描述的主题切换和布局模式 见上文.

AI 编码代理的说明

一般事务人员(其他职等) 是一份非明显合同的紧凑清单—— 重置布局,主题线, 克隆孩子的组件, 标签规则——即代理人(和人类)否则从源头重新发现. 它与 npm 包,所以它是可用的在 node_modules 地点 使用点.

版本与发布记录

@bluecateng/pelagos 共发布 82 个版本,首次发布于 2022/10/19;过去 12 个月发布了 16 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
12.28.6latest2026/10/309 天前
12.28.52026/10/0930 天前
12.28.42026/09/171 个月前
12.28.32026/08/282 个月前
12.28.22026/08/152 个月前
12.28.12026/08/053 个月前

其他发布通道:alpha → 12.3.0-alpha.0。

关于 @bluecateng/pelagos 的常见问题

@bluecateng/pelagos 是什么?

UI 组件

如何安装 @bluecateng/pelagos?

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

@bluecateng/pelagos 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@bluecateng/pelagos 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@bluecateng/pelagos 可以商用吗?

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

@bluecateng/pelagos 的下载量有多少?

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

@bluecateng/pelagos 还在维护吗?

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