HTML / CSS / 系统课时

设计按钮组件

设计按钮组件

按钮组件需要同时保证视觉一致、交互反馈和可访问性。本课将用受控的 variant、size、loading 与图标参数生成按钮,避免调用方随意拼接类名,并通过完整页面验证默认、次要、加载和禁用状态。

学习目标

  • 设计有限且语义清晰的按钮变体 API
  • 统一处理尺寸、颜色、焦点、加载和禁用状态
  • 验证文字按钮与图标组合的对齐效果

先定义按钮的公共契约

按钮的稳定部分包括圆角、字重、焦点环、过渡效果和禁用规则;颜色与尺寸则属于有限变体。调用方应该选择 primary、secondary、sm 或 md,而不是直接传入一串互相冲突的 Tailwind 类。

加载状态不仅要显示旋转图标,还要阻止重复点击,并通过 aria-busy 告知辅助技术。纯图标按钮必须提供 aria-label,否则视觉上可理解的图标对屏幕阅读器没有可用名称。

按钮组件的变体与状态组合关系

用映射表组合类名

变体映射应写成静态字符串,让 Tailwind 能在源码扫描阶段发现完整类名。公共类、颜色类和尺寸类分别维护,再由组件函数组合。这样可以明确控制允许的组合,也方便在设计系统调整时集中修改。

下面示例是可直接运行的完整 HTML。它生成主按钮、次要按钮、加载按钮和禁用按钮,并为图标与文字保留统一间距。

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 按钮组件</title>
  <script src="https://cdn.tailwindcss.com"></script>
</head>
<body class="bg-slate-100 p-8">
  <main id="button-demo" class="mx-auto flex max-w-3xl flex-wrap items-center gap-4"></main>

  <script>
    const variants = {
      primary: "bg-sky-600 text-white hover:bg-sky-700 focus-visible:ring-sky-500",
      secondary: "border border-slate-300 bg-white text-slate-800 hover:bg-slate-50 focus-visible:ring-slate-400"
    };

    const sizes = {
      sm: "min-h-9 px-3 text-sm",
      md: "min-h-11 px-4 text-sm"
    };

    // 只允许预定义变体,避免调用方传入冲突或无法被扫描的动态类名。
    function button({ label, variant = "primary", size = "md", icon = "", loading = false, disabled = false }) {
      const isDisabled = loading || disabled;
      const spinner = loading
        ? '<span class="h-4 w-4 animate-spin rounded-full border-2 border-current border-r-transparent" aria-hidden="true"></span>'
        : icon;

      return `
        <button
          type="button"
          class="inline-flex items-center justify-center gap-2 rounded-lg font-medium transition
                 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-offset-2
                 disabled:cursor-not-allowed disabled:opacity-50 ${variants[variant]} ${sizes[size]}"
          ${isDisabled ? "disabled" : ""}
          aria-busy="${loading}"
        >
          ${spinner}
          <span>${loading ? "处理中" : label}</span>
        </button>
      `;
    }

    const saveIcon = '<span aria-hidden="true">✓</span>';
    document.querySelector("#button-demo").innerHTML = [
      button({ label: "保存", icon: saveIcon }),
      button({ label: "取消", variant: "secondary" }),
      button({ label: "提交", loading: true }),
      button({ label: "已结束", variant: "secondary", disabled: true, size: "sm" })
    ].join("");
  </script>
</body>
</html>

预期结果

页面显示四个对齐一致的按钮。主按钮为蓝色,次要按钮为白底描边;加载按钮显示旋转图标并不可点击,禁用按钮降低透明度且鼠标指针变为不可操作状态。

text
页面可见:保存、取消、处理中、已结束四个按钮
保存按钮:左侧带勾选图标
处理中按钮:显示旋转图标并处于 disabled 状态
已结束按钮:较小尺寸且处于禁用状态

处理状态、图标与验收

hover、focus-visible 和 disabled 应在组件内部完整定义。特别是键盘焦点不能只依赖颜色变化,清晰的 ring 能让使用 Tab 导航的用户确认当前位置。加载时应保持按钮宽度尽量稳定,避免文案变化导致布局明显跳动。

图标与文字组合适合使用 inline-flex items-center gap-2。只有图标而没有文字时,应增加固定宽高并提供 aria-label;若图标只是装饰,应设置 aria-hidden="true",避免辅助技术重复朗读。

检查组件时,不要只看默认样式。至少用鼠标、键盘和禁用状态分别验证:悬停颜色是否清晰,Tab 聚焦是否出现焦点环,加载与禁用是否阻止点击,图标与文字是否垂直居中。

还应测试较长文案与窄容器。按钮可根据产品需求选择不换行、允许伸展或占满宽度,但该策略应由组件明确提供,而不是让调用方临时覆盖内部布局。

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

目录与阅读设置

阅读设置

17

记录一个想法

设计按钮组件

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

登录哪都通