HTML / CSS / 系统课时
使用 peer 状态
使用 peer 状态
本课解决表单控件变化后,标签与提示如何同步更新的问题。你将用 peer 把复选框设为状态源,再通过 peer-checked 和 peer-focus-visible 驱动后续兄弟元素,完成无需 JavaScript 的交互。
学习目标
- 理解
peer状态源与后续兄弟元素之间的选择器关系。 - 使用
peer-*变体同步更新标签、图标和提示文本。 - 识别元素顺序、命名 peer 与可访问性方面的常见问题。
peer 的工作机制
peer 本身不改变样式,它只把元素标记为可被兄弟元素引用的状态源。状态仍由复选框、单选框或输入框等原生控件产生。
后续元素使用 peer-checked:*、peer-focus:*、peer-disabled:* 或 peer-invalid:*,在相应状态成立时应用工具类。
底层机制接近 CSS 的后续兄弟选择器,因此状态源必须出现在被控制元素之前。示例中的复选框位于标签和提示之前,所以两者能读取勾选状态;反向排列则不会生效。

完成一个联动确认卡片
下面示例用隐藏复选框保存状态。点击标签后,边框、背景、勾选图标和提示文字会一起变化;键盘聚焦复选框时,标签会显示焦点环。
html
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Tailwind peer 示例</title>
<script src="https://cdn.tailwindcss.com"></script>
</head>
<body class="grid min-h-screen place-items-center bg-slate-100 p-6">
<div class="w-full max-w-md rounded-2xl bg-white p-6 shadow-lg">
<h1 class="text-xl font-semibold text-slate-900">发布前确认</h1>
<!-- peer 必须位于所有需要读取其状态的兄弟元素之前 -->
<input id="confirm" name="confirm" value="yes" type="checkbox" class="peer sr-only">
<label for="confirm"
class="mt-4 flex cursor-pointer items-center gap-3 rounded-xl border border-slate-300 p-4 transition-colors peer-checked:border-blue-600 peer-checked:bg-blue-50 peer-focus-visible:ring-2 peer-focus-visible:ring-blue-500 peer-focus-visible:ring-offset-2">
<span
class="grid size-6 place-items-center rounded-md border border-slate-400 text-transparent transition-colors peer-checked:border-blue-600 peer-checked:bg-blue-600 peer-checked:text-white">
✓
</span>
<span class="font-medium text-slate-800">我已检查标题、链接和发布时间</span>
</label>
<p class="mt-3 text-sm text-amber-700 peer-checked:text-emerald-700">
勾选后即可进入发布流程。
</p>
</div>
</body>
</html>预期结果
text
页面初始显示灰色确认卡片和橙色提示。点击卡片后,卡片变为蓝色强调状态,勾选框显示白色对勾,提示文字变为绿色。使用 Tab 键聚焦时,卡片外侧出现蓝色焦点环。关键边界与排查顺序
peer 适合同级元素间的轻量联动,例如复选框控制提示、单选按钮切换卡片样式、输入框校验后显示错误。跨多层容器或需要修改祖先元素时,应改用 group、:has() 对应变体或 JavaScript 状态。
样式不生效时,先确认状态源含有 peer,再检查目标是否位于其后且处于同一父级。多个状态源并存时,可使用 peer/name 与 peer-checked/name:*,避免读取错误控件。
不要用 hidden 隐藏需要键盘操作的原生控件,否则它通常无法获得焦点。控件应保留 id、name、value,标签使用匹配的 for,视觉隐藏优先选择 sr-only。
按自己的节奏,确认真正理解。