# @bluecateng/pelagos 中文文档

规范地址：https://npmcn.com/package/%40bluecateng/pelagos/

版本：12\.28\.6
npm 元数据更新时间：2026-10-29T22:00:41.842Z
中文译文更新时间：2026-11-08T08:21:58.637Z
软件包许可：ISC

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

原始 npm 页面：https://www.npmjs.com/package/%40bluecateng/pelagos
原文对照：https://npmcn.com/package/%40bluecateng/pelagos/?lang=original
项目主页：https://github.com/bluecatengineering/pelagos-packages#readme
源码仓库：https://github.com/bluecatengineering/pelagos-packages

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

- 包体积（解压后）：700 kB，329 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：6 个
- 首次发布：2022-10-18T18:54:56.566Z
- 最新版本发布：2026-10-29T22:00:41.443Z
- 近 30 天下载量：3483（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：82（近 12 个月 16 个）

## 中文简介

UI 组件

## 安装

```sh
npm install @bluecateng/pelagos
```

也可以使用：`pnpm add @bluecateng/pelagos`、`yarn add @bluecateng/pelagos`、`bun add @bluecateng/pelagos`

## README

# @bluecateng/ pelagos (英语) [![GitHub license](https://img.shields.io/badge/license-ISC-blue.svg)](https://github.com/bluecatengineering/pelagos-packages/blob/master/LICENSE) [![npm version](https://img.shields.io/npm/v/@bluecateng/pelagos.svg?style=flat)](https://www.npmjs.com/package/@bluecateng/pelagos)

UI组件.

## 安装

```bash
npm i -S @bluecateng/pelagos
```

## 开始

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

### 固定主题

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

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

### 用户选择的主题

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

```less
@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` 默认为

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

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

## 故事书

实例和文件请参见: [故事书网站](https://storybook.dnsedge.tools/)

## 示例应用程序

[种族实例](https://github.com/bluecatengineering/pelagos-example) 是一个 小型可运行应用程序,其示例按每个实例索引 演示——包括描述的主题切换和布局模式 见上文.

## AI 编码代理的说明

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

## 常见问题

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