卡片组件:从结构到状态的完整写法
一个能复用的卡片需要处理图片比例、内容弹性、整卡可点击、悬停与焦点态,这里一次写完。
卡片是最常见的组件,也是最容易被写坏的组件。典型的坏味道:图片高度写死导致不同比例变形、标题长度不一导致按钮错位、整卡可点击却用 div + onclick。
结构:链接包裹整卡#
<article class="card">
<a class="card-link" href="/post/1">
<div class="card-media"><img src="cover.jpg" alt="" loading="lazy"></div>
<div class="card-body">
<span class="card-tag">布局</span>
<h3 class="card-title">标题最多两行,超出省略</h3>
<p class="card-desc">描述文字,控制在三行以内。</p>
<span class="card-more">阅读全文</span>
</div>
</a>
</article>用 <a> 包住整张卡片,而不是给 div 绑点击事件。这样中键新开标签、键盘 Tab 聚焦、右键复制链接全都天然可用,不需要补 tabindex 和 role。
样式:让内容自己撑开,按钮贴底#
.card {
border: 1px solid #e5e9f0;
border-radius: 16px;
background: #fff;
overflow: hidden;
transition: border-color .2s, transform .2s, box-shadow .2s;
}
.card:hover { border-color: #b9c6ff; transform: translateY(-2px); box-shadow: 0 16px 36px -24px rgb(13 17 23 / .4); }
.card:focus-within { outline: 2px solid #2b57ff; outline-offset: 2px; }
.card-link { display: flex; flex-direction: column; height: 100%; }
.card-media { aspect-ratio: 16 / 9; background: #f2f5fa; }
.card-media img { width: 100%; height: 100%; object-fit: cover; display: block; }
.card-body { display: flex; flex-direction: column; gap: 8px; padding: 18px; flex: 1; }
.card-title {
font-size: 16px; line-height: 1.45; margin: 0;
display: -webkit-box; -webkit-line-clamp: 2; -webkit-box-orient: vertical; overflow: hidden;
}
.card-desc {
font-size: 13.5px; color: #6b7482; margin: 0; line-height: 1.7;
display: -webkit-box; -webkit-line-clamp: 3; -webkit-box-orient: vertical; overflow: hidden;
}
.card-more { margin-top: auto; font-size: 13px; color: #2b57ff; font-weight: 600; }三个关键点:aspect-ratio 固定图片比例,line-clamp 限制文字行数,margin-top: auto 把底部元素推到最后。这样不管标题一行还是两行,卡片高度一致、按钮永远对齐。
栅格:让卡片自己决定列数#
.cards {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(min(260px, 100%), 1fr));
gap: 20px;
}min(260px, 100%) 这个细节是为了 320px 以下的小屏——否则 minmax(260px, 1fr) 会在比 260px 还窄的容器里溢出。
悬停之外:焦点态同样重要#
键盘用户看不到 :hover。用 :focus-within 让整卡在内部链接获得焦点时也有反馈,再加 :focus-visible 处理按钮类元素:
.card-link:focus-visible { outline: 2px solid #2b57ff; outline-offset: 2px; border-radius: 16px; }
/* 移除默认轮廓是错的,除非你给了替代方案 */深色模式下的两处调整#
@media (prefers-color-scheme: dark) {
.card { background: #111725; border-color: #222b3b; }
.card:hover { border-color: #3a4a6b; box-shadow: 0 16px 36px -24px rgb(0 0 0 / .9); }
}深色下不要用纯黑背景配纯白文字,对比过强会「发光」。用 #0b0f17 配 #eef2f8,再把阴影换成更深更散的形式。