@3mo/theme

中文文档
0.5.6发布于 2026/10/08MITTypeScriptES Module构建来源已验证近 30 天下载 3401

用于主题的设计标志和公用设施,有从一种口音颜色衍生出轻而暗的调色板并坚持偏好.

中文使用文档
文档目录6 节
  1. 安装
  2. 使用量
  3. API 密码
  4. 出口
  5. 链接
  6. 许可证

主题

用于主题的设计标志和公用设施,有从一种口音颜色衍生出轻而暗的调色板并坚持偏好.

npm Documentation

安装

npm install @3mo/theme
import { Theme } from '@3mo/theme'

使用量

<div class='swatch' style='background: var(--mo-color-background); color: var(--mo-color-foreground)'>Background / Foreground</div>
<div class='swatch' style='background: var(--mo-color-surface); color: var(--mo-color-on-surface)'>Surface</div>
<div class='swatch' style='background: var(--mo-color-surface-container-lowest); color: var(--mo-color-on-surface)'>Surface Container Lowest</div>
<div class='swatch' style='background: var(--mo-color-surface-container-low); color: var(--mo-color-on-surface)'>Surface Container Low</div>
<div class='swatch' style='background: var(--mo-color-surface-container); color: var(--mo-color-on-surface)'>Surface Container</div>
<div class='swatch' style='background: var(--mo-color-surface-container-high); color: var(--mo-color-on-surface)'>Surface Container High</div>
<div class='swatch' style='background: var(--mo-color-surface-container-highest); color: var(--mo-color-on-surface)'>Surface Container Highest</div>
<div class='swatch' style='background: var(--mo-color-red)'>Red</div>
<div class='swatch' style='background: var(--mo-color-green)'>Green</div>
<div class='swatch' style='background: var(--mo-color-yellow)'>Yellow</div>
<div class='swatch' style='background: var(--mo-color-blue)'>Blue</div>
<div class='swatch' style='background: var(--mo-color-gray); color: black'>Gray</div>
<div class='swatch' style='background: var(--mo-color-gray-transparent)'>Gray Transparent</div>
<div class='swatch' style='background: var(--mo-color-transparent-gray-3)'>Transparent Gray</div>
<div class='swatch' style='background: var(--mo-color-accent); color: var(--mo-color-on-accent)'>Accent / On Accent</div>
<div class='swatch' style='background: var(--mo-color-accent-container); color: var(--mo-color-on-accent-container)'>Accent Container / On Accent Container</div>

API 密码

出口

名称仁爱说明
BackgroundStorage类
AccentStorage类
Theme类控制应用程序主题的公用事业 .
ThemeController类
colorContrast函数计算与给定的颜色相对的 CSS 颜色,结果为白色或黑色
Background语句

许可证

麻省理工学院 3MO GmbH

版本与发布记录

@3mo/theme 共发布 32 个版本,首次发布于 2023/04/15;过去 12 个月发布了 9 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.5.6latest2026/10/0829 天前
0.5.52026/09/281 个月前
0.5.42026/09/131 个月前
0.5.32026/09/091 个月前
0.5.22026/09/042 个月前
0.5.12026/09/042 个月前

关于 @3mo/theme 的常见问题

@3mo/theme 是什么?

用于主题的设计标志和公用设施,有从一种口音颜色衍生出轻而暗的调色板并坚持偏好.

如何安装 @3mo/theme?

在项目目录运行 npm install @3mo/theme,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@a11d/lit(x)、@3mo/color(x)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@3mo/theme 支持 TypeScript 吗?

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

@3mo/theme 支持 ESM 还是 CommonJS?

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

@3mo/theme 可以商用吗?

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

@3mo/theme 的下载量有多少?

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

@3mo/theme 还在维护吗?

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