和诗以歌 UI COMPONENTS
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透明、不填满、内容靠下
2 × 1582 × 210 透明 / 内容靠下
01 大东

拖拽区盖住底部内容:轻点飞往曲目,长按拖动章节牌。

c-record 唱机

Slot deck / CD

来自 slot-cd.html:CD 从卡槽里探出来,播放时旋转;暂停时播放键是彩虹圆盘。 1×2 是画布上的标准唱机;2×1 是横向版;2×2 是立式 hero;1×1 是微型,只留 CD、曲名、细进度和播放。

内容字段

字段说明
c-record__deck唱机面板
c-record__discCD 容器;__disc-spin 旋转,label 固定
c-record__slotCD 卡槽,仅 2×2 / 1×2 显示
c-record__eyebrowEQ + 状态文字
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-accentEQ 条、激活描边
--cluster-soft激活描边外圈
--p进度填充百分比,由 demo 写入
.is-active-cluster当前曲目组,面板描边强调色
.is-playingEQ 动、CD 转、彩虹播放键淡出、图标切暂停
1 × 1283 × 210
NOW SPINNING

大东

林雨夜 / 木狸奴
词《诗经》小雅曲木猫、林雨夜编曲林雨夜唱ACE小夜出品上海交通大学国学社
1:412:32
1 × 2283 × 436
NOW SPINNING

大东

林雨夜 / 木狸奴
词《诗经》小雅曲木猫、林雨夜编曲林雨夜唱ACE小夜出品上海交通大学国学社
1:412:32
2 × 1582 × 210
NOW SPINNING

大东

林雨夜 / 木狸奴
词《诗经》小雅曲木猫、林雨夜编曲林雨夜唱ACE小夜出品上海交通大学国学社
1:412:32
2 × 2582 × 436
NOW SPINNING

大东

林雨夜 / 木狸奴
词《诗经》小雅曲木猫、林雨夜编曲林雨夜唱ACE小夜出品上海交通大学国学社
1:412:32

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-energydemo 每帧写入 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当前句
1 × 1283 × 210
有饛簋飧 有捄棘匕
周道如砥 其直如矢
君子所履 小人所视
睠言顾之 潸焉出涕
小东大东 杼柚其空
纠纠葛屦 可以履霜
佻佻公子 行彼周行
既往既来 使我心疚
1 × 2283 × 436
有饛簋飧 有捄棘匕
周道如砥 其直如矢
君子所履 小人所视
睠言顾之 潸焉出涕
小东大东 杼柚其空
纠纠葛屦 可以履霜
佻佻公子 行彼周行
既往既来 使我心疚
2 × 1582 × 210
有饛簋飧 有捄棘匕
周道如砥 其直如矢
君子所履 小人所视
睠言顾之 潸焉出涕
小东大东 杼柚其空
纠纠葛屦 可以履霜
佻佻公子 行彼周行
既往既来 使我心疚
2 × 2582 × 436
有饛簋飧 有捄棘匕
周道如砥 其直如矢
君子所履 小人所视
睠言顾之 潸焉出涕
小东大东 杼柚其空
纠纠葛屦 可以履霜
佻佻公子 行彼周行
既往既来 使我心疚

用法

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。