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 的后续兄弟选择器,因此状态源必须出现在被控制元素之前。示例中的复选框位于标签和提示之前,所以两者能读取勾选状态;反向排列则不会生效。

peer 状态源与相邻元素的作用方向

完成一个联动确认卡片

下面示例用隐藏复选框保存状态。点击标签后,边框、背景、勾选图标和提示文字会一起变化;键盘聚焦复选框时,标签会显示焦点环。

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。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 peer 状态

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通