API 参考 · 基础色

@oriatheme/colors

不随主题切换的稳定基础色库，以及 Tailwind v4 兼容的公开 CSS 子路径。

包与运行环境

静态值；可在任意 JavaScript、CSS 与 SSR 环境使用。

bash

pnpm add @oriatheme/colors

bash

npm install @oriatheme/colors

bash

yarn add @oriatheme/colors

bash

bun add @oriatheme/colors

选择使用方项目已有的一种包管理器和 lockfile；示例只使用 package root export，不要从 src、dist 或 registry template 深层导入。

Exports

出口	签名	描述
`oriaColors`	`OriaColors`	26 个不可变的命名尺度以及黑色、白色、继承、透明和当前。
`oriaColorFamilies`	`readonly OriaColorFamily[]`	26个稳定的姓氏。
`oriaColorSteps`	`readonly OriaColorStep[]`	50 到 950，分十一个步骤。
`toOriaColorVariable`	(family, step) => `--oria-palette-${family}-${step}`	返回稳定的基色自定义属性名称。

import { oriaColors, toOriaColorVariable } from "@oriatheme/colors";

const blue = oriaColors.blue[500];
const variable = toOriaColorVariable("blue", 500);

CSS

css

@import "@oriatheme/colors/styles.css";
@import "tailwindcss";
@import "@oriatheme/colors/tailwind.css";

基础色不会随 OriaTheme 切换。需要随主题变化的界面值应使用 Runtime 写入的语义 --oria-* 变量。