Skip to content

原子样式库 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.css
ts
// 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
10Flexflex-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>

组合约定 ​

  1. display 类里 hidden 排在最后:同一元素同时挂 flex hidden 时以 hidden 为准;需要「某断点以上才显示」就用这套叠加。
  2. break-words 与 break-all 作用于不同属性,可以一起写:前者是 overflow-wrap: break-word(只在单词过长时断),后者是 word-break: break-all(任何位置都断)。只想避免撑破容器,用 break-words。
  3. leading-* 是无单位比值,随字号缩放:leading-1 / leading-1-5 / leading-1-6 / leading-1-75 / leading-2。要固定像素行高,用 nexuspx.css 的 lineht20 / lineht24 / lineht28 / lineht30 / lineht40 / lineht60。
  4. 小数点在类名里写成 -: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。

Released under the MIT License.