Appearance
原子样式库 nexus.css
一套与 Tailwind 命名对齐的原子类,覆盖 Tailwind 里「不涉及具体尺寸」的那部分:显示类型、布局、文本、定位、背景透明度、百分比宽高、层级、鼠标、透明度。 带 px 尺寸的类(字号、行高、宽高、内外边距、圆角、边框宽度)在 nexuspx.css 里,两者分工不重叠。
引入
bash
npx taibai@latest add base-styles # → src/styles/modules/nexus.css
npx taibai@latest add base-styles-px # → src/styles/modules/nexuspx.cssts
// main.ts
import '@/styles/modules/nexus.css'
import '@/styles/modules/nexuspx.css'nexus.css 建议先于业务样式引入。多数组件依赖它提供的原子类;AiText 自带一份 atoms.css 子集,单装也能直接显示。
模块一览(共 13 个)
| 编号 | 模块 | 主要类 |
|---|---|---|
| 01 | 字体 | font-family-pingfang、fonts-italic、fontw400~fontw900 |
| 02 | 文本 | txtellipsis / txtellipsis2 / txtellipsis3、text-indent-2em、leading-*、whitespace-pre-wrap、break-words、break-all、text-center |
| 03 | 滚动条与溢出 | hide-scrollbar-y、hide-scrollbar-x、overflow-hidden、overflow-x-auto |
| 04 | 交互控制 | disabled-area、no-copy |
| 05 | 尺寸 | w-bai-10~w-bai-100、max-w-bai-*、min-h-bai-*、w-full、h-screen |
| 06 | 定位 | relative、absolute、fixed、sticky、absolutecenter |
| 07 | 背景 | bg-white-5~bg-white-95、bg-black-*、bg-purple-*、bg-red-*、bg-blue-*、bg-white、bg-cover |
| 08 | 边框与圆角 | radius-bai50、border-solid、border-dashed、border-none |
| 09 | 显示类型 | block、inline-block、inline、flex、inline-flex、hidden |
| 10 | Flex | flex-row / flex-col、justify-between、items-center、flex-1、grow、shrink-0、order-first |
| 11 | 层级 | z-0~z-9、z-minus-1~z-minus-10 |
| 12 | 鼠标 | cursor-pointer |
| 13 | 透明度 | opacity-100、opacity-60 |
常用类速查
html
<!-- 显示与布局 -->
<div class="flex items-center justify-between">…</div>
<div class="inline-block">…</div>
<span class="hidden">仅在断点外显示时用</span>
<!-- 文本 -->
<p class="txtellipsis">单行省略</p>
<p class="txtellipsis2">两行省略,超出打点</p>
<p class="whitespace-pre-wrap break-words leading-1-6">保留换行、长单词不撑破、行高 1.6</p>
<!-- 尺寸与定位 -->
<div class="w-bai-50 max-w-bai-80 h-full relative">…</div>
<div class="absolutecenter">绝对定位居中</div>
<!-- 背景与层级 -->
<div class="bg-black-50 z-5">遮罩</div>
<div class="bg-white radius-bai50">圆形头像</div>
<!-- 其他 -->
<div class="no-copy hide-scrollbar-y cursor-pointer opacity-60">…</div>组合约定
- display 类里
hidden排在最后:同一元素同时挂flex hidden时以hidden为准;需要「某断点以上才显示」就用这套叠加。 break-words与break-all作用于不同属性,可以一起写:前者是overflow-wrap: break-word(只在单词过长时断),后者是word-break: break-all(任何位置都断)。只想避免撑破容器,用break-words。leading-*是无单位比值,随字号缩放:leading-1/leading-1-5/leading-1-6/leading-1-75/leading-2。要固定像素行高,用nexuspx.css的lineht20/lineht24/lineht28/lineht30/lineht40/lineht60。- 小数点在类名里写成
-:1.6→leading-1-6,33%→w-bai-33,负数层级 →z-minus-1。
与 Tailwind 并存
nexus.css后加载时会覆盖同名类;flex、items-center、text-center、hidden这类语义与 Tailwind 完全一致,混用不会打架。- 已知差异两处:
.bg-white是#fff硬编码(Tailwind 走主题变量--color-white);.bg-cover是100% 100%拉伸(Tailwind 是等比裁切)。 - 项目已经装了 Tailwind 的话,
nexus.css可以不装,只补base-styles-px与base-animations。
组件里的实际用法
组件把「能表达成原子类的样式」全写成类,不在组件内重复定义。以 AiText 为例:
vue
<div class="ai-text-container inline-block relative">
<div class="ai-typing inline whitespace-pre-wrap break-words leading-1-6" v-html="displayedContent" />
</div>用到的 inline-block、relative、inline、whitespace-pre-wrap、break-words、leading-1-6 六个类在 nexus.css 中都有定义,组件本身不需要再写一段本地原子样式。
组件目录里的 atoms.css 是这件事的兜底:它只把该组件用到的 10 条声明(含 mglf2 与 anim-cursor-blink)就近放一份,通过 index.vue 末尾的 <style src="./atoms.css"></style> 挂进组件,所以宿主不装 nexus.css 也能直接显示;装了全局库的项目,同名声明值完全一致,重复定义不会打架。改原子值时要两处同步。
维护约定
- 类名与属性值保持稳定,只增不改;新增类按其类型放进对应模块(显示类进 09、行高进 02)。
- 涉及具体像素的类不要放进
nexus.css,统一进nexuspx.css。