lesson-card.md
组件 · COMPONENT

课节卡 LessonCard

一节课:16:9 暗底缩略图,四角是编号、档位角标、时长;未解锁时整卡压暗并居中一把锁;看完后整卡朱染;正在播放的那一节套朱环;还没有视频的课盖半透明罩、整卡不可点,罩中央是催更键(不传 remind 时写「敬请期待」)。

已完成整卡朱染 + 标题行「✓ 已完成」
import { LessonCard } from './screens/v4/course/LessonCard.jsx'

// 课节位置数组:[标题, 时长, 简介, md, 体验课, 源, uid, 课节ID, 行数据]
const lesson = (id, title, level, row = {}) => [title, '15:32', '让想法第一次连起来。', '', level < 2 ? 1 : 0, '', '', id, { cover_url: null, required_level: level, ...row }]
const OPEN = { canWatchCourse: () => true, canWatchLesson: () => true }
const GUEST = { canWatchCourse: () => false, canWatchLesson: (a) => (a[8]?.required_level ?? 0) < 2 }

export function Done() {
  return (
    <div style={{ width: 280 }}>
      <LessonCard si={0} li={3} a={lesson('l-4', '双链与反向链接', 0)} plan={OPEN} done tierTag />
    </div>
  )
}
试看体验课节对未购者显朱色「试看」角标
import { LessonCard } from './screens/v4/course/LessonCard.jsx'

// 课节位置数组:[标题, 时长, 简介, md, 体验课, 源, uid, 课节ID, 行数据]
const lesson = (id, title, level, row = {}) => [title, '15:32', '让想法第一次连起来。', '', level < 2 ? 1 : 0, '', '', id, { cover_url: null, required_level: level, ...row }]
const OPEN = { canWatchCourse: () => true, canWatchLesson: () => true }
const GUEST = { canWatchCourse: () => false, canWatchLesson: (a) => (a[8]?.required_level ?? 0) < 2 }

export function Trial() {
  return (
    <div style={{ width: 280 }}>
      <LessonCard si={0} li={0} a={lesson('l-1', '为什么是 Obsidian', 0)} plan={GUEST} done={false} tierTag />
    </div>
  )
}
会员 · 未解锁暗底锁罩;锁孔是这张卡唯一的朱色
import { LessonCard } from './screens/v4/course/LessonCard.jsx'

// 课节位置数组:[标题, 时长, 简介, md, 体验课, 源, uid, 课节ID, 行数据]
const lesson = (id, title, level, row = {}) => [title, '15:32', '让想法第一次连起来。', '', level < 2 ? 1 : 0, '', '', id, { cover_url: null, required_level: level, ...row }]
const OPEN = { canWatchCourse: () => true, canWatchLesson: () => true }
const GUEST = { canWatchCourse: () => false, canWatchLesson: (a) => (a[8]?.required_level ?? 0) < 2 }

export function Locked() {
  return (
    <div style={{ width: 280 }}>
      <LessonCard si={1} li={1} a={lesson('l-7', 'Dataview:笔记变数据库', 2)} plan={GUEST} done={false} tierTag />
    </div>
  )
}
拓展 · 未解锁传 catName 时脚注带系列名
import { LessonCard } from './screens/v4/course/LessonCard.jsx'

// 课节位置数组:[标题, 时长, 简介, md, 体验课, 源, uid, 课节ID, 行数据]
const lesson = (id, title, level, row = {}) => [title, '15:32', '让想法第一次连起来。', '', level < 2 ? 1 : 0, '', '', id, { cover_url: null, required_level: level, ...row }]
const OPEN = { canWatchCourse: () => true, canWatchLesson: () => true }
const GUEST = { canWatchCourse: () => false, canWatchLesson: (a) => (a[8]?.required_level ?? 0) < 2 }

export function Extension() {
  return (
    <div style={{ width: 280 }}>
      <LessonCard si={4} li={0} a={lesson('l-x', '用笔记管理人脉', 3)} plan={GUEST} done={false} catName="人脉管理" />
    </div>
  )
}
播放中 · 无简介视频页目录用法:current 套朱环 +「▶ 播放中」,desc={false} 去掉简介脚注;与完成态可叠加
import { LessonCard } from './screens/v4/course/LessonCard.jsx'

// 课节位置数组:[标题, 时长, 简介, md, 体验课, 源, uid, 课节ID, 行数据]
const lesson = (id, title, level, row = {}) => [title, '15:32', '让想法第一次连起来。', '', level < 2 ? 1 : 0, '', '', id, { cover_url: null, required_level: level, ...row }]
const OPEN = { canWatchCourse: () => true, canWatchLesson: () => true }
const GUEST = { canWatchCourse: () => false, canWatchLesson: (a) => (a[8]?.required_level ?? 0) < 2 }

export function Current() {
  return (
    <div style={{ width: 280 }}>
      <LessonCard si={0} li={2} a={lesson('l-3', '三库结构初始化', 0)} plan={OPEN} done={false} current tierTag desc={false} />
    </div>
  )
}
敬请期待 · 不可点行数据 has_video === false:半透明黑罩 +「敬请期待」签,有封面时罩下封面仍看得清;无封面时兜底面只留线稿、不叠课名;不响应点击与悬停,先于锁罩
import { LessonCard } from './screens/v4/course/LessonCard.jsx'

// 课节位置数组:[标题, 时长, 简介, md, 体验课, 源, uid, 课节ID, 行数据]
const lesson = (id, title, level, row = {}) => [title, '15:32', '让想法第一次连起来。', '', level < 2 ? 1 : 0, '', '', id, { cover_url: null, required_level: level, ...row }]
const OPEN = { canWatchCourse: () => true, canWatchLesson: () => true }
const GUEST = { canWatchCourse: () => false, canWatchLesson: (a) => (a[8]?.required_level ?? 0) < 2 }

export function Soon() {
  return (
    <div style={{ width: 280 }}>
      <LessonCard si={0} li={4} a={lesson('l-5', '标签与属性', 2, { has_video: false })} plan={OPEN} done={false} tierTag />
    </div>
  )
}
敬请期待 · 催更传 remind:罩里只有一个朱键「催更」,不叠「敬请期待」签;催过之前不显示人数(键上与悬停提示都没有);点击不冒泡,卡片照旧不可点
import { LessonCard } from './screens/v4/course/LessonCard.jsx'

// 课节位置数组:[标题, 时长, 简介, md, 体验课, 源, uid, 课节ID, 行数据]
const lesson = (id, title, level, row = {}) => [title, '15:32', '让想法第一次连起来。', '', level < 2 ? 1 : 0, '', '', id, { cover_url: null, required_level: level, ...row }]
const OPEN = { canWatchCourse: () => true, canWatchLesson: () => true }
const GUEST = { canWatchCourse: () => false, canWatchLesson: (a) => (a[8]?.required_level ?? 0) < 2 }

export function Remind() {
  return (
    <div style={{ width: 280 }}>
      <LessonCard si={0} li={5} a={lesson('l-6', '模板与日记', 2, { has_video: false })} plan={OPEN} done={false} tierTag
        remind={{ count: 12, mine: false, onRemind: () => {} }} />
    </div>
  )
}
敬请期待 · 已催更remind.mine 为真:键原地换成描边胶囊「✓ 已催更 · N 人」,高度不变,不再可点——人数是催过的人才看到的回馈
import { LessonCard } from './screens/v4/course/LessonCard.jsx'

// 课节位置数组:[标题, 时长, 简介, md, 体验课, 源, uid, 课节ID, 行数据]
const lesson = (id, title, level, row = {}) => [title, '15:32', '让想法第一次连起来。', '', level < 2 ? 1 : 0, '', '', id, { cover_url: null, required_level: level, ...row }]
const OPEN = { canWatchCourse: () => true, canWatchLesson: () => true }
const GUEST = { canWatchCourse: () => false, canWatchLesson: (a) => (a[8]?.required_level ?? 0) < 2 }

export function Voted() {
  return (
    <div style={{ width: 280 }}>
      <LessonCard si={0} li={6} a={lesson('l-7', '工作流与自动化', 2, { has_video: false })} plan={OPEN} done={false} tierTag
        remind={{ count: 13, mine: true, onRemind: () => {} }} />
    </div>
  )
}
骨架态
import { LessonCard } from './screens/v4/course/LessonCard.jsx'

export function Loading() {
  return (
    <div style={{ width: 280 }}>
      <LessonCard loading />
    </div>
  )
}

属性

属性取值默认说明
si / linumber—系列下标 / 课节下标,生成左上 S1 · E04 编号
a课节位置数组—见下表
plan{ canWatchCourse(ci), canWatchLesson(a) }—权限视图:决定角标显隐与是否上锁
doneboolean—已完成 → 整卡朱染
tierTagbooleanfalse标题前显档位胶囊(带反光)
descbooleantruefalse 时不显简介脚注
currentbooleanfalse正在播放 → 朱环 +「▶ 播放中」,先于完成 chip
remind{ count, mine, failed?, onRemind }—敬请期待时罩里的催更键(见 SoonVeil);count 只在 mine 为真时显示;不传就只有「敬请期待」签
catNamestring—脚注前缀系列名
cinumber0课程下标(传给 canWatchCourse)
loadingbooleanfalse骨架态

课节位置数组 a

下标含义
0标题;无封面时截首段(「:」前,≤ 12 字)作卡面短标题
1时长文字,右下角显示
2简介,作脚注
3Markdown 笔记(卡片不用)
4是否体验课(required_level < 2)
5 / 6视频源标签 / 播放器 uid(卡片不用)
7课节 ID
8行数据:cover_url、required_level、source、duration_minutes、has_video

敬请期待

课节还没有绑定视频时,卡片进入敬请期待态。判定只有一条,写在 domain/v4/lessonSoon.js 的 isSoon(a):a[8].has_video === false。字段缺失一律当作有视频——宁可放行到课时页由服务端说明「尚未上线」,也不把已上线的课误锁。

这一态由数据决定,不是属性:卡片自己不挂 onClick、不预取播放凭证,根节点加 .zzm-cardlink--soon 撤掉悬停的上浮与描边,aria-disabled 告诉读屏器不可用。无封面时兜底面只留星座线稿、不叠短标题——罩中央已经是签,两行字会压在一起;课名在卡片下方照常显示。封面上的罩是独立的 .zzm-soon 类,导学封面、播放舞台这类大画面用 .zzm-soon--lg,见「视频播放键」页。

在 edu 里,悬停可看的课节会预取播放凭证(hoverPrefetchProps)。设计系统站用 src/stubs/playUrlCache.js 的空实现顶替,源文件一字未改。

铁律

✓ 要四角元素(编号、时长、角标)各自带深色小底
✗ 不要给整张封面加暗色蒙层
✓ 要有封面就不叠短标题——封面图自己写着课名
✗ 不要锁定用 backdrop 模糊(同屏几十张卡,GPU 吃不消)
✓ 要敬请期待的罩比锁罩浅(.5 对 .7),封面要看得清
✗ 不要把没有视频的课做成可点、进去再报错
✓ 要催更键点了只催更:不冒泡,不把人带进课时页