组件 · COMPONENT
视频播放键 VideoPlay
全站唯一允许为圆形的交互键。圆形不是装饰例外,而是「点按即开始播放」这个媒体语义的通用符号——导学封面与所有课时海报共用这一个原件。
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>
)
}<button type="button" class="zzm-video-play" aria-label="播放">
<svg class="zzm-video-play__icon" viewBox="0 0 20 20" aria-hidden="true">
<path d="M7 4.5 L15.5 10 L7 15.5 Z"></path>
</svg>
</button>/* controls.css */
.zzm-v4 .zzm-video-play {
display: grid;
place-items: center;
width: 72px;
height: 72px;
padding: 0;
border: 1px solid rgba(0, 0, 0, .16);
border-radius: 50%;
cursor: pointer;
color: #1D1D1B;
background: linear-gradient(180deg, #FFFFFF 0%, #F2F2EF 100%);
box-shadow:
0 0 0 4px rgba(255, 255, 255, .24),
0 2px 4px rgba(0, 0, 0, .16),
0 6px 16px rgba(0, 0, 0, .22),
inset 0 1px 0 rgba(255, 255, 255, .96),
inset 0 -1px 0 rgba(0, 0, 0, .08);
transition: transform .16s ease, box-shadow .16s ease, border-color .16s ease;
}
.zzm-v4 .zzm-video-play:hover {
border-color: rgba(0, 0, 0, .3);
box-shadow:
0 0 0 5px rgba(255, 255, 255, .3),
0 3px 6px rgba(0, 0, 0, .18),
0 9px 22px rgba(0, 0, 0, .28),
inset 0 1px 0 rgba(255, 255, 255, .98),
inset 0 -1px 0 rgba(0, 0, 0, .08);
}
.zzm-v4 .zzm-video-play:active {
transform: scale(.98);
background: linear-gradient(180deg, #E9E9E6 0%, #F4F4F1 100%);
box-shadow:
0 0 0 4px rgba(255, 255, 255, .24),
inset 0 2px 5px rgba(0, 0, 0, .16),
inset 0 1px 2px rgba(0, 0, 0, .10);
}
.zzm-v4 .zzm-video-play:focus-visible {
outline: none;
box-shadow:
0 0 0 4px rgba(166, 64, 47, .28),
0 2px 4px rgba(0, 0, 0, .16),
0 6px 16px rgba(0, 0, 0, .22),
inset 0 1px 0 rgba(255, 255, 255, .96);
}
.zzm-v4 .zzm-video-play__icon {
width: 24px;
height: 24px;
margin-left: 4px;
fill: currentColor;
}在海报上居中
加 --center 修饰:绝对定位到父容器正中,悬停 / 按压的缩放也由它接管。父容器需要 position: relative。
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>
)
}<div
style="
position: relative;
width: 480px;
max-width: 100%;
aspect-ratio: 16/9;
border-radius: 12px;
background: #131316;
overflow: hidden;
"
>
<button type="button" class="zzm-video-play zzm-video-play--center" aria-label="播放本节">
<svg class="zzm-video-play__icon" viewBox="0 0 20 20" aria-hidden="true">
<path d="M7 4.5 L15.5 10 L7 15.5 Z"></path>
</svg>
</button>
</div>/* controls.css */
.zzm-v4 .zzm-video-play {
display: grid;
place-items: center;
width: 72px;
height: 72px;
padding: 0;
border: 1px solid rgba(0, 0, 0, .16);
border-radius: 50%;
cursor: pointer;
color: #1D1D1B;
background: linear-gradient(180deg, #FFFFFF 0%, #F2F2EF 100%);
box-shadow:
0 0 0 4px rgba(255, 255, 255, .24),
0 2px 4px rgba(0, 0, 0, .16),
0 6px 16px rgba(0, 0, 0, .22),
inset 0 1px 0 rgba(255, 255, 255, .96),
inset 0 -1px 0 rgba(0, 0, 0, .08);
transition: transform .16s ease, box-shadow .16s ease, border-color .16s ease;
}
.zzm-v4 .zzm-video-play--center {
position: absolute;
left: 50%;
top: 50%;
transform: translate(-50%, -50%);
}
.zzm-v4 .zzm-video-play:hover {
border-color: rgba(0, 0, 0, .3);
box-shadow:
0 0 0 5px rgba(255, 255, 255, .3),
0 3px 6px rgba(0, 0, 0, .18),
0 9px 22px rgba(0, 0, 0, .28),
inset 0 1px 0 rgba(255, 255, 255, .98),
inset 0 -1px 0 rgba(0, 0, 0, .08);
}
.zzm-v4 .zzm-video-play--center:hover { transform: translate(-50%, -50%) scale(1.06); }
.zzm-v4 .zzm-video-play:active {
transform: scale(.98);
background: linear-gradient(180deg, #E9E9E6 0%, #F4F4F1 100%);
box-shadow:
0 0 0 4px rgba(255, 255, 255, .24),
inset 0 2px 5px rgba(0, 0, 0, .16),
inset 0 1px 2px rgba(0, 0, 0, .10);
}
.zzm-v4 .zzm-video-play--center:active { transform: translate(-50%, -50%) scale(.98); }
.zzm-v4 .zzm-video-play:focus-visible {
outline: none;
box-shadow:
0 0 0 4px rgba(166, 64, 47, .28),
0 2px 4px rgba(0, 0, 0, .16),
0 6px 16px rgba(0, 0, 0, .22),
inset 0 1px 0 rgba(255, 255, 255, .96);
}
.zzm-v4 .zzm-video-play__icon {
width: 24px;
height: 24px;
margin-left: 4px;
fill: currentColor;
}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>
)
}<div
style="
position: relative;
width: 360px;
max-width: 100%;
aspect-ratio: 16/9;
border-radius: 12px;
background: #0e0e10;
overflow: hidden;
"
>
<button type="button" class="zzm-video-play zzm-video-play--center" aria-label="播放导学">
<svg class="zzm-video-play__icon" viewBox="0 0 20 20" aria-hidden="true">
<path d="M7 4.5 L15.5 10 L7 15.5 Z"></path>
</svg>
</button>
</div>/* controls.css */
.zzm-v4 .zzm-video-play {
display: grid;
place-items: center;
width: 72px;
height: 72px;
padding: 0;
border: 1px solid rgba(0, 0, 0, .16);
border-radius: 50%;
cursor: pointer;
color: #1D1D1B;
background: linear-gradient(180deg, #FFFFFF 0%, #F2F2EF 100%);
box-shadow:
0 0 0 4px rgba(255, 255, 255, .24),
0 2px 4px rgba(0, 0, 0, .16),
0 6px 16px rgba(0, 0, 0, .22),
inset 0 1px 0 rgba(255, 255, 255, .96),
inset 0 -1px 0 rgba(0, 0, 0, .08);
transition: transform .16s ease, box-shadow .16s ease, border-color .16s ease;
}
.zzm-v4 .zzm-video-play--center {
position: absolute;
left: 50%;
top: 50%;
transform: translate(-50%, -50%);
}
.zzm-v4 .zzm-video-play:hover {
border-color: rgba(0, 0, 0, .3);
box-shadow:
0 0 0 5px rgba(255, 255, 255, .3),
0 3px 6px rgba(0, 0, 0, .18),
0 9px 22px rgba(0, 0, 0, .28),
inset 0 1px 0 rgba(255, 255, 255, .98),
inset 0 -1px 0 rgba(0, 0, 0, .08);
}
.zzm-v4 .zzm-video-play--center:hover { transform: translate(-50%, -50%) scale(1.06); }
.zzm-v4 .zzm-video-play:active {
transform: scale(.98);
background: linear-gradient(180deg, #E9E9E6 0%, #F4F4F1 100%);
box-shadow:
0 0 0 4px rgba(255, 255, 255, .24),
inset 0 2px 5px rgba(0, 0, 0, .16),
inset 0 1px 2px rgba(0, 0, 0, .10);
}
.zzm-v4 .zzm-video-play--center:active { transform: translate(-50%, -50%) scale(.98); }
.zzm-v4 .zzm-video-play:focus-visible {
outline: none;
box-shadow:
0 0 0 4px rgba(166, 64, 47, .28),
0 2px 4px rgba(0, 0, 0, .16),
0 6px 16px rgba(0, 0, 0, .22),
inset 0 1px 0 rgba(255, 255, 255, .96);
}
.zzm-v4 .zzm-video-play__icon {
width: 24px;
height: 24px;
margin-left: 4px;
fill: currentColor;
}视频还没上线:敬请期待罩
课节还没有绑定视频时,不放播放键,改盖 .zzm-soon 罩:半透明黑 .5(比锁罩 .7 浅一档,封面要看得清)+ 居中描边签「敬请期待」。罩挡住下面的点击,光标是默认箭头。签用白字白线,不用朱色——朱色在本站表示「可以行动」。课节卡里的小号版见「课节卡」页;导学封面、课时播放舞台用 --lg。
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>
)
}<div
style="
position: relative;
width: 480px;
max-width: 100%;
aspect-ratio: 16/9;
border-radius: 12px;
background: linear-gradient(135deg, #1d1d1b 0%, #1d1d1b 48%, #a6402f 48%, #a6402f 100%);
overflow: hidden;
"
>
<div class="zzm-soon zzm-soon--lg"><span class="zzm-soon__tag">敬请期待</span></div>
</div>/* controls.css */
.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--lg { gap: 12px; }
.zzm-v4 .zzm-soon__tag {
/* 字距在末字后多留一份空白:右内距少一份字距,文字才在胶囊里视觉居中 */
padding: 4px 9px 4px 12px;
border: 1px solid rgba(255, 255, 255, .56);
border-radius: 999px;
background: rgba(0, 0, 0, .24);
color: #FFFFFF;
font-size: 12px;
font-weight: 600;
line-height: 16px;
letter-spacing: 3px;
white-space: nowrap;
text-shadow: 0 1px 2px rgba(0, 0, 0, .4);
}
.zzm-v4 .zzm-soon--lg .zzm-soon__tag {
padding: 8px 16px 8px 20px;
font-size: 16px;
line-height: 24px;
letter-spacing: 4px;
}
.zzm-v4 .zzm-soon--lg .zzm-soon__voted { padding: 7px 16px; font-size: 14px; line-height: 20px; }罩由组件 components/v4/SoonVeil 渲染(v0.8.0 起),课节卡、课程卡与消费方的导学封面、播放舞台、收藏卡共用,不再各自手写罩的结构。传 remind={{ count, mine, failed, onRemind }} 时罩里只放一个催更键(v0.9.0 起不再叠「敬请期待」签):朱键(朱色=可以行动),键上与悬停提示都不带人数——人数是催过的人才看到的回馈;点击不冒泡,下面的卡片或海报不会被触发。mine 为真时键原地换成描边胶囊「✓ 已催更 · N 人」(与签同一种非交互徽章,高度与键相同)——这是状态,不画成键;failed 为真时键上写「催更失败,重试」。一人一票、能不能催更由消费方的服务端判定,组件只呈现。
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>
)
}<div
style="
position: relative;
width: 480px;
max-width: 100%;
aspect-ratio: 16/9;
border-radius: 12px;
background: linear-gradient(135deg, #1d1d1b 0%, #1d1d1b 48%, #a6402f 48%, #a6402f 100%);
overflow: hidden;
"
>
<div class="zzm-soon zzm-soon--lg">
<button
type="button"
class="zzm-btn zzm-btn--accent zzm-soon__remind"
title="催更:按催更人数从高到低安排录制"
>
催更
</button>
</div>
</div>/* tokens.css · 用到的令牌 */
:root {
--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-muted-2: #85847C;
--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-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--lg { gap: 12px; }
.zzm-v4 .zzm-soon--lg .zzm-soon__tag {
padding: 8px 16px 8px 20px;
font-size: 16px;
line-height: 24px;
letter-spacing: 4px;
}
.zzm-v4 .zzm-soon__remind { letter-spacing: 1px; }
.zzm-v4 .zzm-soon--lg .zzm-soon__voted { padding: 7px 16px; font-size: 14px; line-height: 20px; }类名
| 类 | 作用 |
|---|---|
.zzm-video-play | 72×72 圆形纸面凸键,墨色三角,键盘焦点为朱色光晕 |
.zzm-video-play--center | 绝对居中于父容器(translate -50% -50%) |
.zzm-video-play__icon | 24px 三角图标,左移 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 人都在劝退)
✗ 不要催更键点了顺带把人带进课时页