video-play.md
组件 · COMPONENT

视频播放键 VideoPlay

全站唯一允许为圆形的交互键。圆形不是装饰例外,而是「点按即开始播放」这个媒体语义的通用符号——导学封面与所有课时海报共用这一个原件。

72px 纸面凸键悬停外圈变亮、居中版放大 1.06;按下内陷
export function PlayButton() {
  return (
    <button type="button" className="zzm-video-play" aria-label="播放">
      <svg className="zzm-video-play__icon" viewBox="0 0 20 20" aria-hidden="true">
        <path d="M7 4.5 L15.5 10 L7 15.5 Z" />
      </svg>
    </button>
  )
}

在海报上居中

加 --center 修饰:绝对定位到父容器正中,悬停 / 按压的缩放也由它接管。父容器需要 position: relative。

课时海报 16:9
export function OnPoster() {
  return (
    <div style={{ position: 'relative', width: 480, maxWidth: '100%', aspectRatio: '16/9', borderRadius: 12, background: '#131316', overflow: 'hidden' }}>
      <button type="button" className="zzm-video-play zzm-video-play--center" aria-label="播放本节">
        <svg className="zzm-video-play__icon" viewBox="0 0 20 20" aria-hidden="true">
          <path d="M7 4.5 L15.5 10 L7 15.5 Z" />
        </svg>
      </button>
    </div>
  )
}
导学封面 16:9导学封面位与课节封面同为 16:9,封面图 contain 完整展示、不裁切
export function GuideCover() {
  return (
    <div style={{ position: 'relative', width: 360, maxWidth: '100%', aspectRatio: '16/9', borderRadius: 12, background: '#0E0E10', overflow: 'hidden' }}>
      <button type="button" className="zzm-video-play zzm-video-play--center" aria-label="播放导学">
        <svg className="zzm-video-play__icon" viewBox="0 0 20 20" aria-hidden="true">
          <path d="M7 4.5 L15.5 10 L7 15.5 Z" />
        </svg>
      </button>
    </div>
  )
}

视频还没上线:敬请期待罩

课节还没有绑定视频时,不放播放键,改盖 .zzm-soon 罩:半透明黑 .5(比锁罩 .7 浅一档,封面要看得清)+ 居中描边签「敬请期待」。罩挡住下面的点击,光标是默认箭头。签用白字白线,不用朱色——朱色在本站表示「可以行动」。课节卡里的小号版见「课节卡」页;导学封面、课时播放舞台用 --lg。

敬请期待 · 大画面`<SoonVeil lg />`;父容器需要 position: relative
敬请期待
import { SoonVeil } from './components/v4/SoonVeil.jsx'

export function SoonStage() {
  return (
    <div style={{ position: 'relative', width: 480, maxWidth: '100%', aspectRatio: '16/9', borderRadius: 12, background: 'linear-gradient(135deg, #1D1D1B 0%, #1D1D1B 48%, #A6402F 48%, #A6402F 100%)', overflow: 'hidden' }}>
      <SoonVeil lg />
    </div>
  )
}

罩由组件 components/v4/SoonVeil 渲染(v0.8.0 起),课节卡、课程卡与消费方的导学封面、播放舞台、收藏卡共用,不再各自手写罩的结构。传 remind={{ count, mine, failed, onRemind }} 时罩里只放一个催更键(v0.9.0 起不再叠「敬请期待」签):朱键(朱色=可以行动),键上与悬停提示都不带人数——人数是催过的人才看到的回馈;点击不冒泡,下面的卡片或海报不会被触发。mine 为真时键原地换成描边胶囊「✓ 已催更 · N 人」(与签同一种非交互徽章,高度与键相同)——这是状态,不画成键;failed 为真时键上写「催更失败,重试」。一人一票、能不能催更由消费方的服务端判定,组件只呈现。

敬请期待 · 催更`<SoonVeil lg remind={…} />`:大画面用默认高度的朱键
import { SoonVeil } from './components/v4/SoonVeil.jsx'

export function RemindStage() {
  return (
    <div style={{ position: 'relative', width: 480, maxWidth: '100%', aspectRatio: '16/9', borderRadius: 12, background: 'linear-gradient(135deg, #1D1D1B 0%, #1D1D1B 48%, #A6402F 48%, #A6402F 100%)', overflow: 'hidden' }}>
      <SoonVeil lg remind={{ count: 26, mine: false, onRemind: () => {} }} />
    </div>
  )
}

类名

类作用
.zzm-video-play72×72 圆形纸面凸键,墨色三角,键盘焦点为朱色光晕
.zzm-video-play--center绝对居中于父容器(translate -50% -50%)
.zzm-video-play__icon24px 三角图标,左移 4px 做视觉居中
.zzm-soon敬请期待罩:铺满父容器的半透明黑(.5),居中放签,挡住下层点击
.zzm-soon__tag「敬请期待」描边签:12px 白字、3px 字距、半透明白线胶囊
.zzm-soon--lg大画面版:签放大到 16px、4px 字距
.zzm-soon__remind催更键:叠在 .zzm-btn--accent 朱键上,只补字距
.zzm-soon__voted已催更:描边胶囊(与签同语言),与对应的键同高(28px,大画面 36px),点完原地换形不跳
.zzm-cardlink--soon卡片的不可点手感:撤掉悬停上浮、描边高亮与柔影,光标为默认

铁律

✓ 要只用于「点按即开始播放」
✗ 不要借它的圆形去做别的按钮——文字按钮仍然是圆角矩形
✓ 要导学封面与课时海报用同一个原件
✗ 不要在不同页面给同一个动作画不同的播放键
✓ 要视频还没上线就不放播放键,改盖敬请期待罩
✗ 不要放一个点了才报「尚未上线」的播放键
✓ 要催更键用朱键;已催更换成描边胶囊,不画成键
✗ 不要催过之前就亮出人数(0 人、3 人都在劝退)
✗ 不要催更键点了顺带把人带进课时页