Component Library v1
四张卡片,
一枚章节牌。
这一页把 demo 拆成五个组件:唱片、手记、插画、歌词四张卡片各四档版式;
数字 + 标题是一枚固定 2×1 的章节牌,透明、不填满、内容靠下,拖动它就能单独摆放。
内容字段与可变样式都写在 components.css 里,尺寸类只负责内部版式重排。
5 components
4 sizes per card
marker fixed 2×1
BEM fields + CSS vars
2 states
色彩与字体
Design tokens
画布是 #333333,卡片仍是纸面色。每首歌必须指定一个主题色,组件只读取
--cluster-accent / --cluster-soft,没有全局紫色兜底;
页头、面板等页面壳层读 --theme-accent / --theme-accent-soft,由当前曲目决定。
画布--bg-canvas #333333
卡片--surface-card #FFFFFF
纸面--surface-paper #FCF9F5
手记--surface-note #FDFBF7
卡片正文--text-primary #1C1917
弱化--text-muted #8A817C
页面文字--ui-text #F4F0EC
主题色--theme-accent 每首歌指定
大东#A8452C 悲歌
未解忆长安#4F6480 音韵
来春可拟共兰舟#8A5A79 约定
溯流沙#5F7A63 匠心
玉蝴蝶 秋梦#9A7838 旧梦
聚少趁江南#B0756F 联结
字体:--font-serif(Noto Serif SC)负责曲名、引文、歌词;--font-sans(Noto Sans SC)负责说明、界面。
尺寸
Grid 4 columns
卡片按 1180px / 4 列 / 16px 间距的网格出图,1×1 与 1×2 同宽 283px,2×1 与 2×2 同宽 582px;
高度只有 210px 与 436px 两档。demo 的画布用同样的数值,所以组件在两处看起来一致。
1×1 283 × 210
1×2 283 × 436
2×1 582 × 210
2×2 582 × 436
章节牌固定 2×1(582 × 210),不参与四档缩放;它没有卡片背景,内容靠下。
c-marker 章节牌
Fixed 2×1 draggable
数字 + 标题,没有第三行小字。固定占 2×1,没有卡片背景、也不填满,内容自然靠下;
在 demo 里可以拖动,轻点会飞往所属曲目,颜色继承当前歌曲的主题色。
内容字段
| 字段 | 说明 |
c-marker__no | 序号,01–06 |
c-marker__title | 曲名,长曲名加 is-long |
可变样式与状态
| 变量 / 规则 | 说明 |
--cluster-accent | 序号、主题词 |
2×1 | 固定尺寸,无尺寸变体 |
.c-marker__inner | 透明、不填满、内容靠下 |
拖拽区盖住底部内容:轻点飞往曲目,长按拖动章节牌。
c-record 唱机
Slot deck / CD
来自 slot-cd.html:CD 从卡槽里探出来,播放时旋转;暂停时播放键是彩虹圆盘。
1×2 是画布上的标准唱机;2×1 是横向版;2×2 是立式 hero;1×1 是微型,只留 CD、曲名、细进度和播放。
内容字段
| 字段 | 说明 |
c-record__deck | 唱机面板 |
c-record__disc | CD 容器;__disc-spin 旋转,label 固定 |
c-record__slot | CD 卡槽,仅 2×2 / 1×2 显示 |
c-record__eyebrow | EQ + 状态文字 |
c-record__title | 曲名 |
c-record__artist | 词曲 / 演唱署名 |
c-record__credits | 制作名单,仅 2×2 显示,内部是 c-credits |
c-progress | 进度条 + 已播 / 剩余 |
c-record__controls | 上一首 / 播放 / 下一首 |
data-role="disc|play|seek|time|remaining|prev|next" | demo 的播放状态钩子 |
可变样式与状态
| 变量 / 状态 | 说明 |
--cluster-accent | EQ 条、激活描边 |
--cluster-soft | 激活描边外圈 |
--p | 进度填充百分比,由 demo 写入 |
.is-active-cluster | 当前曲目组,面板描边强调色 |
.is-playing | EQ 动、CD 转、彩虹播放键淡出、图标切暂停 |
1 × 1283 × 210
NOW SPINNING
大东
林雨夜 / 木狸奴
词《诗经》小雅曲木猫、林雨夜编曲林雨夜唱ACE小夜出品上海交通大学国学社
1 × 2283 × 436
NOW SPINNING
大东
林雨夜 / 木狸奴
词《诗经》小雅曲木猫、林雨夜编曲林雨夜唱ACE小夜出品上海交通大学国学社
2 × 1582 × 210
NOW SPINNING
大东
林雨夜 / 木狸奴
词《诗经》小雅曲木猫、林雨夜编曲林雨夜唱ACE小夜出品上海交通大学国学社
2 × 2582 × 436
NOW SPINNING
大东
林雨夜 / 木狸奴
词《诗经》小雅曲木猫、林雨夜编曲林雨夜唱ACE小夜出品上海交通大学国学社
c-story 创作手记
Editorial note
纸面 + 和纸胶带。1×1 只保留主题词、曲名和摘要;其余尺寸显示引文与更长摘要。
点右上角的 … 直接把卡片变成 2×2,等同手动拖成 2×2:下方卡片让位,镜头不动,
2×2 就是展开态,没有关闭按钮,全文在卡片内部滚动。
内容字段
| 字段 | 说明 |
c-story__kicker | 主题词,如“悲歌” |
c-story__title | 曲名 |
c-story__quote | 引文,左侧强调色竖线 |
c-story__lead | 故事摘要,按尺寸截断 2–6 行 |
c-story__full | 全文,2×2 时显示 |
c-credits | 制作名单,字段 badge + 值 plaintext |
c-story__expand | 仅 1×1 / 1×2 / 2×1 显示的 … 按钮 |
可变样式与状态
| 变量 / 状态 | 说明 |
--cluster-accent | 主题词、引文竖线、展开按钮 |
--cluster-soft | 激活描边外圈 |
.is-active-cluster | 当前曲目组 |
2×2 | 展开态:下方卡片下移,全文在卡内滚动 |
1 × 1283 × 210
悲歌
大东
“维天有汉,监亦有光”
“人不可能两次踏入一条河流。”对于《大东》的创作者木猫来说,这首歌诞生于一个无法复制的夜晚。 故事始于本科时期一段压抑的时光。那时的木猫正处于生活的低谷,“风波迭起,芳情不度”。在一种强烈的“去国怀乡”的情绪中,他偶然刷到了《诗经》大东的讲解视频。
1 × 2283 × 436
悲歌
大东
“维天有汉,监亦有光”
“人不可能两次踏入一条河流。”对于《大东》的创作者木猫来说,这首歌诞生于一个无法复制的夜晚。 故事始于本科时期一段压抑的时光。那时的木猫正处于生活的低谷,“风波迭起,芳情不度”。在一种强烈的“去国怀乡”的情绪中,他偶然刷到了《诗经》大东的讲解视频。
2 × 1582 × 210
悲歌
大东
“维天有汉,监亦有光”
“人不可能两次踏入一条河流。”对于《大东》的创作者木猫来说,这首歌诞生于一个无法复制的夜晚。 故事始于本科时期一段压抑的时光。那时的木猫正处于生活的低谷,“风波迭起,芳情不度”。在一种强烈的“去国怀乡”的情绪中,他偶然刷到了《诗经》大东的讲解视频。
2 × 2582 × 436
悲歌
大东
“维天有汉,监亦有光”
“人不可能两次踏入一条河流。”对于《大东》的创作者木猫来说,这首歌诞生于一个无法复制的夜晚。 故事始于本科时期一段压抑的时光。那时的木猫正处于生活的低谷,“风波迭起,芳情不度”。在一种强烈的“去国怀乡”的情绪中,他偶然刷到了《诗经》大东的讲解视频。
“人不可能两次踏入一条河流。”对于《大东》的创作者木猫来说,这首歌诞生于一个无法复制的夜晚。
若合一契的悲歌
故事始于本科时期一段压抑的时光。那时的木猫正处于生活的低谷,“风波迭起,芳情不度”。在一种强烈的“去国怀乡”的情绪中,他偶然刷到了《诗经》大东的讲解视频。
这是三千年前殷商遗民的歌谣:天上的银河灿烂,地上的征役无休;贵族享乐,百姓赤贫。这种跨越时空的苦闷,让木猫瞬间产生了一种“若合一契”的战栗——他仿佛听懂了那些仰望星空的古人。
灵感与格律的交响
《大东》的原诗结构奇特,前四段沉郁质实,后三段却瑰丽奇崛,仿佛是由两篇不同的作品拼接而成。创作的过程也呼应了这种结构。
在那次灵感迸发的洗澡间隙,木猫脑海中突然闪过黄霑《沧海一声笑》的豪迈,决定用宫商角徵羽的五声音阶起头,一气呵成谱写了后半段的高潮——既不可张扬宏大,也不能流于琐碎,那是压抑后的爆发。
而前半段的叙事,则由林雨夜(椰椰)深度参与。她用国学社一贯坚持的“依字行腔”原则,对旋律进行了精细的打磨与调整,弥补了原本音准上的瑕疵,让古老的文字在现代的律动中找到了最准确的咬字与呼吸。
四点半的绝响
那是一个疯狂的夜晚。两位创作者,一间小房间,床与钢琴,凌晨四点半。“用情绪的花火拼凑出曲调”,木猫说,即便后来远渡重洋,拥有了更好的独立空间,他也再没能复刻那一晚纯粹的无拘表达。
《大东》不仅是一首复古之作,它更像是一个现代灵魂与古老历史的握手。闭上眼睛,你似乎能听到那来自东方的歌谣:他们痛苦,他们悲歌,但他们依然在星空下,顶天立地地活着。
词《诗经》小雅曲木猫、林雨夜编曲林雨夜唱ACE小夜出品上海交通大学国学社
c-visual 四周年插画
Image / motion
插画本身 + 底部题注 + 播放时的光晕与缓慢推镜。四种尺寸只是裁切与题注位置的变化。
内容字段
| 字段 | 说明 |
c-visual__art | 插画(img,object-fit: cover) |
c-visual__glow | 音频能量光晕,读 --cluster-soft |
c-visual__badge | “正在播放”徽标 |
c-caption__title | 题注(曲名) |
可变样式与状态
| 变量 / 状态 | 说明 |
--cluster-soft | 光晕颜色 |
--cluster-energy | demo 每帧写入 0–1,驱动光晕 |
.is-active-cluster.is-playing | 显示徽标 + 26s 缓慢推镜 |
1 × 1283 × 210
正在播放
大东
1 × 2283 × 436
正在播放
大东
2 × 1582 × 210
正在播放
大东
2 × 2582 × 436
正在播放
大东
c-lyrics 歌词
LRC / multi-line
1×1 与其余尺寸都是可滚动的多行歌词,1×1 字号稍大。当前句在 1×1 用荧光笔下划线,
其他尺寸用底色块;制作名单与日期不进歌词卡。
内容字段
| 字段 | 说明 |
c-lyrics__scroll | 歌词滚动区 |
c-lyrics__line | 单行歌词 |
c-lyrics__line.is-active | 当前句 |
可变样式与状态
| 变量 / 状态 | 说明 |
--cluster-soft | 当前句底色 / 1×1 荧光笔 |
.is-active | 当前句 |
用法
Markup
卡片壳只负责圆角、边框、阴影和裁切;组件根节点同时挂 c-card 和组件类,
再加一个尺寸类。外框宽高由使用页面决定(demo 里由画布的网格计算)。
<article class="c-card c-record sz-1x2"
style="--cluster-accent: #A8452C; --cluster-soft: rgba(168,69,44,.14)">
<div class="c-record__deck">…</div>
<div class="c-record__slot"></div>
<div class="c-record__disc">…</div>
</article>
状态直接加在同一个根节点:.is-active-cluster 表示“当前曲目组”,
.is-playing 表示“正在播放”。歌词行用 .is-active。