组件 · COMPONENT
课程卡 CourseCard
综合首页与落地页共用的课程卡:16:9 暗底头图(封面或星座线稿)+ 名称、简介、适合人群、元数据与脚注动作。还没开放的课盖半透明罩写「敬请期待」,整卡不可点。
登录后的综合首页卡就是基准形态;落地页不再维护变体,只换脚注文案与颜色。
import { CourseCard } from './components/v4/CourseCard.jsx'
const DEMO = {
num: '01',
name: 'Obsidian 知识管理',
intro: '从零搭建一套以你为中心、能用十年的知识管理系统。',
aud: '刚开始整理数字笔记的知识工作者',
cover: null,
art: {
pl: [{ pts: '28,78 84,30 132,62 186,22 214,52', c: 'rgba(255,255,255,.28)', w: '1.2' }],
dt: [
{ x: 28, y: 78, r: 2.4, f: '#FFFFFF' }, { x: 84, y: 30, r: 2.4, f: '#FFFFFF' },
{ x: 132, y: 62, r: 3.2, f: '@' }, { x: 186, y: 22, r: 2.4, f: '#FFFFFF' }, { x: 214, y: 52, r: 2.4, f: '#FFFFFF' },
],
},
}
export function Hub() {
return (
<div style={{ width: 300 }}>
<CourseCard course={DEMO} meta="6 系列 · 67 节" />
</div>
)
}<div style="width: 300px">
<div
class="zzm-hovercard"
style="
border: 1px solid var(--zzm-hairline-2);
border-radius: 16px;
background: var(--zzm-surface);
overflow: hidden;
cursor: pointer;
"
>
<div
style="
aspect-ratio: 16/9;
background: var(--zzm-dark-card);
position: relative;
overflow: hidden;
"
>
<svg
viewBox="0 0 240 135"
preserveAspectRatio="xMidYMid slice"
style="position: absolute; inset: 0; width: 100%; height: 100%"
>
<polyline
points="28,78 84,30 132,62 186,22 214,52"
fill="none"
stroke="rgba(255,255,255,.28)"
stroke-width="1.2"
stroke-linecap="round"
stroke-linejoin="round"
></polyline>
<circle cx="28" cy="78" r="2.4" fill="#FFFFFF"></circle>
<circle cx="84" cy="30" r="2.4" fill="#FFFFFF"></circle>
<circle cx="132" cy="62" r="3.2" fill="var(--zzm-accent,#A6402F)"></circle>
<circle cx="186" cy="22" r="2.4" fill="#FFFFFF"></circle>
<circle cx="214" cy="52" r="2.4" fill="#FFFFFF"></circle>
</svg>
<div
style="
position: absolute;
top: 10px;
left: 11px;
font-family: var(--zzm-mono);
font-size: 10px;
letter-spacing: 2px;
padding: 3px 7px;
border-radius: 4px;
background: rgba(0, 0, 0, 0.55);
color: rgba(255, 255, 255, 0.82);
"
>
01
</div>
</div>
<div style="padding: 16px 18px 17px">
<div style="font-size: 16px; font-weight: 650">Obsidian 知识管理</div>
<div style="margin-top: 6px; font-size: 13px; line-height: 1.65; color: var(--zzm-text-5)">
从零搭建一套以你为中心、能用十年的知识管理系统。
</div>
<div style="margin-top: 10px; font-size: 11.5px; color: var(--zzm-muted-2)">
适合 · 刚开始整理数字笔记的知识工作者
</div>
<div style="margin-top: 13px; display: flex; align-items: center; gap: 8px">
<span style="font-family: var(--zzm-mono); font-size: 10.5px; color: var(--zzm-muted)">
6 系列 · 67 节
</span>
<span style="flex: 1"></span>
<span style="font-size: 12px; font-weight: 600; color: var(--zzm-ink); white-space: nowrap">
进入课程 →
</span>
</div>
</div>
</div>
</div>/* tokens.css · 用到的令牌 */
:root {
--zzm-hairline-2: rgba(255, 255, 255, 0.1);
--zzm-surface: #1C1C1B;
--zzm-dark-card: #0F0F10;
--zzm-accent: #A6402F;
--zzm-mono: ui-monospace, "SF Mono", Menlo, monospace;
--zzm-text-5: #9C9B95;
--zzm-muted-2: #85847C;
--zzm-muted: #8D8C86;
--zzm-ink: #E6E5DF;
--zzm-line-hover: rgba(255, 255, 255, 0.3);
--zzm-hover-shadow: 0 10px 30px rgba(0, 0, 0, .45);
}
/* base.css */
.zzm-v4 .zzm-hovercard { transition: all .16s ease; }
.zzm-v4 .zzm-hovercard:hover {
transform: translateY(-3px);
border-color: var(--zzm-line-hover) !important;
box-shadow: var(--zzm-hover-shadow);
}import { CourseCard } from './components/v4/CourseCard.jsx'
const DEMO = {
num: '01',
name: 'Obsidian 知识管理',
intro: '从零搭建一套以你为中心、能用十年的知识管理系统。',
aud: '刚开始整理数字笔记的知识工作者',
cover: null,
art: {
pl: [{ pts: '28,78 84,30 132,62 186,22 214,52', c: 'rgba(255,255,255,.28)', w: '1.2' }],
dt: [
{ x: 28, y: 78, r: 2.4, f: '#FFFFFF' }, { x: 84, y: 30, r: 2.4, f: '#FFFFFF' },
{ x: 132, y: 62, r: 3.2, f: '@' }, { x: 186, y: 22, r: 2.4, f: '#FFFFFF' }, { x: 214, y: 52, r: 2.4, f: '#FFFFFF' },
],
},
}
export function Landing() {
return (
<div style={{ width: 300 }}>
<CourseCard course={DEMO} meta="6 系列 · 67 节" cta="查看课程 →" ctaColor="var(--zzm-accent,#A6402F)" />
</div>
)
}<div style="width: 300px">
<div
class="zzm-hovercard"
style="
border: 1px solid var(--zzm-hairline-2);
border-radius: 16px;
background: var(--zzm-surface);
overflow: hidden;
cursor: pointer;
"
>
<div
style="
aspect-ratio: 16/9;
background: var(--zzm-dark-card);
position: relative;
overflow: hidden;
"
>
<svg
viewBox="0 0 240 135"
preserveAspectRatio="xMidYMid slice"
style="position: absolute; inset: 0; width: 100%; height: 100%"
>
<polyline
points="28,78 84,30 132,62 186,22 214,52"
fill="none"
stroke="rgba(255,255,255,.28)"
stroke-width="1.2"
stroke-linecap="round"
stroke-linejoin="round"
></polyline>
<circle cx="28" cy="78" r="2.4" fill="#FFFFFF"></circle>
<circle cx="84" cy="30" r="2.4" fill="#FFFFFF"></circle>
<circle cx="132" cy="62" r="3.2" fill="var(--zzm-accent,#A6402F)"></circle>
<circle cx="186" cy="22" r="2.4" fill="#FFFFFF"></circle>
<circle cx="214" cy="52" r="2.4" fill="#FFFFFF"></circle>
</svg>
<div
style="
position: absolute;
top: 10px;
left: 11px;
font-family: var(--zzm-mono);
font-size: 10px;
letter-spacing: 2px;
padding: 3px 7px;
border-radius: 4px;
background: rgba(0, 0, 0, 0.55);
color: rgba(255, 255, 255, 0.82);
"
>
01
</div>
</div>
<div style="padding: 16px 18px 17px">
<div style="font-size: 16px; font-weight: 650">Obsidian 知识管理</div>
<div style="margin-top: 6px; font-size: 13px; line-height: 1.65; color: var(--zzm-text-5)">
从零搭建一套以你为中心、能用十年的知识管理系统。
</div>
<div style="margin-top: 10px; font-size: 11.5px; color: var(--zzm-muted-2)">
适合 · 刚开始整理数字笔记的知识工作者
</div>
<div style="margin-top: 13px; display: flex; align-items: center; gap: 8px">
<span style="font-family: var(--zzm-mono); font-size: 10.5px; color: var(--zzm-muted)">
6 系列 · 67 节
</span>
<span style="flex: 1"></span>
<span
style="
font-size: 12px;
font-weight: 600;
color: var(--zzm-accent, #a6402f);
white-space: nowrap;
"
>
查看课程 →
</span>
</div>
</div>
</div>
</div>/* tokens.css · 用到的令牌 */
:root {
--zzm-hairline-2: rgba(255, 255, 255, 0.1);
--zzm-surface: #1C1C1B;
--zzm-dark-card: #0F0F10;
--zzm-accent: #A6402F;
--zzm-mono: ui-monospace, "SF Mono", Menlo, monospace;
--zzm-text-5: #9C9B95;
--zzm-muted-2: #85847C;
--zzm-muted: #8D8C86;
--zzm-line-hover: rgba(255, 255, 255, 0.3);
--zzm-hover-shadow: 0 10px 30px rgba(0, 0, 0, .45);
}
/* base.css */
.zzm-v4 .zzm-hovercard { transition: all .16s ease; }
.zzm-v4 .zzm-hovercard:hover {
transform: translateY(-3px);
border-color: var(--zzm-line-hover) !important;
box-shadow: var(--zzm-hover-shadow);
}import { CourseCard } from './components/v4/CourseCard.jsx'
export function Soon() {
return (
<div style={{ width: 300 }}>
<CourseCard course={{ ...DEMO, num: '02', name: 'Vibe Coding', open: false }} meta="0 系列 · 0 节"
remind={{ count: 9, mine: false, onRemind: () => {} }} />
</div>
)
}<div style="width: 300px">
<div
aria-disabled="true"
title="敬请期待:这门课还未开放"
style="
border: 1px solid var(--zzm-hairline-2);
border-radius: 16px;
background: var(--zzm-surface);
overflow: hidden;
cursor: default;
"
>
<div
style="
aspect-ratio: 16/9;
background: var(--zzm-dark-card);
position: relative;
overflow: hidden;
"
>
<svg
viewBox="0 0 240 135"
preserveAspectRatio="xMidYMid slice"
style="position: absolute; inset: 0; width: 100%; height: 100%"
>
<polyline
points="28,78 84,30 132,62 186,22 214,52"
fill="none"
stroke="rgba(255,255,255,.28)"
stroke-width="1.2"
stroke-linecap="round"
stroke-linejoin="round"
></polyline>
<circle cx="28" cy="78" r="2.4" fill="#FFFFFF"></circle>
<circle cx="84" cy="30" r="2.4" fill="#FFFFFF"></circle>
<circle cx="132" cy="62" r="3.2" fill="var(--zzm-accent,#A6402F)"></circle>
<circle cx="186" cy="22" r="2.4" fill="#FFFFFF"></circle>
<circle cx="214" cy="52" r="2.4" fill="#FFFFFF"></circle>
</svg>
<div class="zzm-soon">
<button
type="button"
class="zzm-btn zzm-btn--accent zzm-soon__remind zzm-btn--sm"
title="催更:按催更人数从高到低安排录制"
>
催更
</button>
</div>
<div
style="
position: absolute;
top: 10px;
left: 11px;
font-family: var(--zzm-mono);
font-size: 10px;
letter-spacing: 2px;
padding: 3px 7px;
border-radius: 4px;
background: rgba(0, 0, 0, 0.55);
color: rgba(255, 255, 255, 0.82);
"
>
02
</div>
</div>
<div style="padding: 16px 18px 17px">
<div style="font-size: 16px; font-weight: 650">Vibe Coding</div>
<div style="margin-top: 6px; font-size: 13px; line-height: 1.65; color: var(--zzm-text-5)">
从零搭建一套以你为中心、能用十年的知识管理系统。
</div>
<div style="margin-top: 10px; font-size: 11.5px; color: var(--zzm-muted-2)">
适合 · 刚开始整理数字笔记的知识工作者
</div>
<div style="margin-top: 13px; display: flex; align-items: center; gap: 8px">
<span style="font-family: var(--zzm-mono); font-size: 10.5px; color: var(--zzm-muted)">
0 系列 · 0 节
</span>
<span style="flex: 1"></span>
<span
style="font-size: 12px; font-weight: 600; color: var(--zzm-muted-2); white-space: nowrap"
>
敬请期待
</span>
</div>
</div>
</div>
</div>/* tokens.css · 用到的令牌 */
:root {
--zzm-hairline-2: rgba(255, 255, 255, 0.1);
--zzm-surface: #1C1C1B;
--zzm-dark-card: #0F0F10;
--zzm-accent: #A6402F;
--zzm-mono: ui-monospace, "SF Mono", Menlo, monospace;
--zzm-text-5: #9C9B95;
--zzm-muted-2: #85847C;
--zzm-muted: #8D8C86;
--zzm-key-line: rgba(255, 255, 255, .12);
--zzm-key-ink: #D6D5CF;
--zzm-key-face: linear-gradient(180deg, #2D2D2B 0%, #232322 100%);
--zzm-key-shadow: 0 0 0 3px rgba(255, 255, 255, .02), 0 1px 2px rgba(0, 0, 0, .5), 0 2px 6px rgba(0, 0, 0, .32), inset 0 1px 0 rgba(255, 255, 255, .07), inset 0 -1px 0 rgba(0, 0, 0, .3);
--zzm-key-line-hover: rgba(255, 255, 255, .2);
--zzm-key-shadow-hover: 0 0 0 4px rgba(255, 255, 255, .035), 0 2px 4px rgba(0, 0, 0, .5), 0 4px 12px rgba(0, 0, 0, .4), inset 0 1px 0 rgba(255, 255, 255, .09), inset 0 -1px 0 rgba(0, 0, 0, .3);
--zzm-key-face-active: linear-gradient(180deg, #1A1A19 0%, #212120 100%);
--zzm-key-shadow-active: 0 0 0 3px rgba(255, 255, 255, .02), 0 1px 0 rgba(255, 255, 255, .04), inset 0 2px 4px rgba(0, 0, 0, .55), inset 0 1px 2px rgba(0, 0, 0, .4);
--zzm-key-shadow-focus: 0 0 0 3px rgba(226, 125, 103, .35), 0 1px 2px rgba(0, 0, 0, .5), 0 2px 6px rgba(0, 0, 0, .32), inset 0 1px 0 rgba(255, 255, 255, .07);
--zzm-key-off: #1E1E1D;
--zzm-key-off-line: rgba(255, 255, 255, .06);
--zzm-key-off-shadow: none;
}
/* controls.css */
.zzm-v4 .zzm-btn {
-webkit-appearance: none;
appearance: none;
display: inline-flex;
align-items: center;
justify-content: center;
gap: 8px;
height: 36px;
padding: 0 16px;
font-family: inherit;
font-size: 13px;
font-weight: 600;
letter-spacing: .2px;
white-space: nowrap;
cursor: pointer;
user-select: none;
border-radius: 8px; /* 圆角矩形——按钮禁胶囊 */
border: 1px solid var(--zzm-key-line);
color: var(--zzm-key-ink);
background: var(--zzm-key-face);
box-shadow: var(--zzm-key-shadow); /* ④光晕 ③近影远影 ②顶部反光 ①底缘收沉 */
transition: box-shadow .16s ease, transform .16s ease, background .16s ease,
border-color .16s ease, filter .16s ease, opacity .16s ease;
}
.zzm-v4 .zzm-btn:hover {
transform: translateY(-1px);
border-color: var(--zzm-key-line-hover);
box-shadow: var(--zzm-key-shadow-hover);
}
.zzm-v4 .zzm-btn:active {
transform: translateY(0);
background: var(--zzm-key-face-active); /* ⑤ 凹面翻转 */
box-shadow: var(--zzm-key-shadow-active);
}
.zzm-v4 .zzm-btn:focus-visible {
outline: none;
box-shadow: var(--zzm-key-shadow-focus); /* 键盘焦点=朱色光晕 */
}
.zzm-v4 .zzm-btn:disabled {
cursor: not-allowed;
transform: none;
}
.zzm-v4 .zzm-btn:disabled:not(.zzm-btn--busy) {
color: var(--zzm-muted-2);
background: var(--zzm-key-off);
border-color: var(--zzm-key-off-line);
box-shadow: var(--zzm-key-off-shadow);
}
.zzm-v4 .zzm-btn--accent {
color: #FFFFFF;
border-color: rgba(122, 42, 29, .9);
background: linear-gradient(180deg, #C25743 0%, #A6402F 56%, #99392A 100%);
box-shadow:
0 0 0 3px rgba(166, 64, 47, .10), /* 朱色反光光晕 */
0 1px 2px rgba(0, 0, 0, .14),
0 3px 10px rgba(166, 64, 47, .28),
inset 0 1px 0 rgba(255, 255, 255, .32),
inset 0 -1px 0 rgba(0, 0, 0, .20);
}
.zzm-v4 .zzm-btn--accent:hover {
filter: brightness(1.06);
border-color: rgba(122, 42, 29, .9);
box-shadow:
0 0 0 4px rgba(166, 64, 47, .16),
0 2px 4px rgba(0, 0, 0, .16),
0 5px 14px rgba(166, 64, 47, .34),
inset 0 1px 0 rgba(255, 255, 255, .36),
inset 0 -1px 0 rgba(0, 0, 0, .20);
}
.zzm-v4 .zzm-btn--accent:active {
filter: none;
background: linear-gradient(180deg, #8E3425 0%, #A03D2C 100%);
box-shadow:
0 0 0 3px rgba(166, 64, 47, .10),
inset 0 2px 5px rgba(0, 0, 0, .34),
inset 0 1px 2px rgba(0, 0, 0, .24);
}
.zzm-v4 .zzm-btn--sm { height: 28px; padding: 0 12px; font-size: 12px; gap: 4px; }
.zzm-v4 .zzm-btn--icon.zzm-btn--sm { width: 28px; }
@media (pointer: coarse) {
.zzm-v4 .zzm-btn--sm:not(.zzm-btn--busy) { position: relative; }
}
@media (pointer: coarse) {
.zzm-v4 .zzm-btn--sm:not(.zzm-btn--busy)::after { content: ""; position: absolute; inset: -8px; }
}
.zzm-v4 .zzm-soon {
position: absolute;
inset: 0;
z-index: 2;
display: flex;
flex-direction: column;
align-items: center;
justify-content: center;
gap: 8px;
background: rgba(0, 0, 0, .5);
cursor: default;
}
.zzm-v4 .zzm-soon__remind { letter-spacing: 1px; }import { CourseCard } from './components/v4/CourseCard.jsx'
export function Loading() {
return (
<div style={{ width: 300 }}>
<CourseCard loading />
</div>
)
}<div style="width: 300px">
<div
style="
border: 1px solid var(--zzm-hairline-2);
border-radius: 16px;
background: var(--zzm-surface);
overflow: hidden;
"
>
<div
style="
aspect-ratio: 16/9;
background: var(--zzm-dark-card);
position: relative;
overflow: hidden;
"
></div>
<div style="padding: 16px 18px 17px">
<div class="zzm-skel" style="width: 62%; height: 16px; border-radius: 8px"></div>
<div
class="zzm-skel"
style="width: 92%; height: 13px; border-radius: 8px; margin-top: 6px"
></div>
<div
class="zzm-skel"
style="width: 40%; height: 11.5px; border-radius: 8px; margin-top: 10px"
></div>
<div style="margin-top: 13px; display: flex; align-items: center; gap: 8px">
<div class="zzm-skel" style="width: 86px; height: 10.5px; border-radius: 8px"></div>
<span style="flex: 1"></span>
<div class="zzm-skel" style="width: 58px; height: 12px; border-radius: 8px"></div>
</div>
</div>
</div>
</div>/* tokens.css · 用到的令牌 */
:root {
--zzm-hairline-2: rgba(255, 255, 255, 0.1);
--zzm-surface: #1C1C1B;
--zzm-dark-card: #0F0F10;
--zzm-chip: #272725;
--zzm-shimmer: rgba(255, 255, 255, .05);
}
/* base.css */
.zzm-v4 .zzm-skel {
position: relative;
overflow: hidden;
background: var(--zzm-chip);
border-radius: 8px;
}
.zzm-v4 .zzm-skel::after {
content: '';
position: absolute;
inset: 0;
transform: translateX(-100%);
background: linear-gradient(90deg, transparent, var(--zzm-shimmer), transparent);
animation: zzmShimmer 1.4s ease infinite;
}
/* keyframes */
@keyframes zzmShimmer { 100% { transform: translateX(100%) } }属性
| 属性 | 取值 | 默认 | 说明 |
|---|---|---|---|
| course | { num, name, intro, aud, cover?, open?, art: { pl, dt } } | — | art 是星座线稿:pl 折线、dt 圆点;颜色 "@" 表示品牌朱。open 为 false 即敬请期待 |
| meta | string | — | 左下 mono 元数据,如「6 系列 · 67 节」 |
| cta | string | '进入课程 →' | 右下动作文案 |
| ctaColor | string | '#161616' | 动作文案颜色 |
| onClick | () => void | — | 整卡点击 |
| remind | { count, mine, failed?, onRemind } | — | 敬请期待时罩里的催更键(见 SoonVeil);count 只在 mine 为真时显示 |
| loading | boolean | false | 骨架态(同一段布局) |
敬请期待
课程后台的「开放」开关关着时(course.open === false,判定写在 domain/v4/lessonSoon.js 的 isCourseSoon),卡片进入敬请期待态:头图盖 .zzm-soon 半透明罩(与课节卡同一原件),封面仍看得清;整卡不调 onClick、不挂悬停、光标默认,脚注动作换成灰字「敬请期待」。字段缺失当作已开放——这只是入口闸,不是权限。
铁律
✓ 要封面按上传原图呈现,不叠蒙层
✗ 不要为了一行小字压暗整幅封面
✓ 要编号用深色小底自持可读性
✗ 不要用 textShadow 救浅字——白底海报上一样糊
✓ 要没开放的课照常露出封面与名称,只是不能点
✗ 不要让人点进一门空课再看到「暂无课时」