首页 > 文章 > 前端

纯CSS实现SVG开关图标切换

时间：2025-11-07 14:33:37 133浏览收藏

偷偷努力，悄无声息地变强，然后惊艳所有人！哈哈，小伙伴们又来学习啦~今天我将给大家介绍《纯CSS实现可切换SVG图标开关组件》，这篇文章主要会讲到等等知识点，不知道大家对其都有多少了解，下面我们就一起来看一吧！当然，非常希望大家能多多评论，给出合理的建议，我们一起学习，一起进步！

使用CSS和SVG实现可切换图标的纯CSS开关组件

本教程详细讲解如何利用CSS和隐藏的`input[type="checkbox"]`来构建一个带有动态SVG图标的纯CSS开关组件。通过巧妙运用CSS选择器和`visibility`属性，我们可以在不依赖JavaScript的情况下，实现图标根据开关状态自动切换，并提供完整的HTML和SCSS代码示例。

在现代Web开发中，创建交互式UI组件是常见的需求。开关（Toggle Switch）作为一种直观的交互元素，常用于控制设置或模式切换。本教程将引导您如何仅使用HTML和SCSS（CSS预处理器）来构建一个功能完善、外观精美的开关组件，其特色在于能够根据开关状态动态切换内部的SVG图标，例如从太阳图标切换到月亮图标，以模拟日夜模式切换。

核心原理：隐藏的复选框作为状态管理器

实现纯CSS交互的关键在于利用HTML的语义化元素和CSS的伪类选择器。input[type="checkbox"] 是一个天然的状态管理器，它有两个状态：选中（checked）和未选中（unchecked）。即使我们将其在视觉上隐藏，其状态仍然可以通过CSS的 :checked 伪类进行检测。通过将这个隐藏的复选框与视觉上的开关组件关联起来，我们可以完全通过CSS来控制组件的外观和内部元素的显示。

HTML 结构

开关组件的HTML结构设计旨在提供清晰的语义和灵活的样式控制。一个元素包裹着隐藏的 <input type="checkbox"> 和一个包含视觉元素的

。图标（SVG）则嵌套在

内部。

<label class="ThemeToggler" for="ThemeTogglerID">
  <!-- 隐藏的复选框，作为状态管理器 -->
  &lt;input id=&quot;ThemeTogglerID&quot; class=&quot;ThemeTogglerInput&quot; type=&quot;checkbox&quot; data-toggle-theme=&quot;dark,light&quot; data-act-class=&quot;ACTIVECLASS&quot; checked /&gt;

  <!-- 开关的视觉填充区域，包含滑块和图标 -->
  <div class="ThemeTogglerFill" >
    <!-- 太阳图标容器 -->
    <div class="SunIcon">
      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" >
        <path d="M12,18c-3.3,0-6-2.7-6-6s2.7-6,6-6s6,2.7,6,6S15.3,18,12,18zM12,8c-2.2,0-4,1.8-4,4c0,2.2,1.8,4,4,4c2.2,0,4-1.8,4-4C16,9.8,14.2,8,12,8z" />
        <path d="M12,4c-0.6,0-1-0.4-1-1V1c0-0.6,0.4-1,1-1s1,0.4,1,1v2C13,3.6,12.6,4,12,4z" />
        <path d="M12,24c-0.6,0-1-0.4-1-1v-2c0-0.6,0.4-1,1-1s1,0.4,1,1v2C13,23.6,12.6,24,12,24z" />
        <path d="M5.6,6.6c-0.3,0-0.5-0.1-0.7-0.3L3.5,4.9c-0.4-0.4-0.4-1,0-1.4s1-0.4,1.4,0l1.4,1.4c0.4,0.4,0.4,1,0,1.4C6.2,6.5,5.9,6.6,5.6,6.6z" />
        <path d="M19.8,20.8c-0.3,0-0.5-0.1-0.7-0.3l-1.4-1.4c-0.4-0.4-0.4-1,0-1.4s1-0.4,1.4,0l1.4,1.4c0.4,0.4,0.4,1,0,1.4C20.3,20.7,20,20.8,19.8,20.8z" />
        <path d="M3,13H1c-0.6,0-1-0.4-1-1s0.4-1,1-1h2c0.6,0,1,0.4,1,1S3.6,13,3,13z" />
        <path d="M23,13h-2c-0.6,0-1-0.4-1-1s0.4-1,1-1h2c0.6,0,1,0.4,1,1S23.6,13,23,13z" />
        <path d="M4.2,20.8c-0.3,0-0.5-0.1-0.7-0.3c-0.4-0.4-0.4-1,0-1.4l1.4-1.4c0.4-0.4,1-0.4,1.4,0s0.4,1,0,1.4l-1.4,1.4C4.7,20.7,4.5,20.8,4.2,20.8z" />
        <path d="M18.4,6.6c-0.3,0-0.5-0.1-0.7-0.3c-0.4-0.4-0.4-1,0-1.4l1.4-1.4c0.4-0.4,1-0.4,1.4,0s0.4,1,0,1.4l-1.4,1.4C18.9,6.5,18.6,6.6,18.4,6.6z" />
      </svg>
    </div>
    <!-- 月亮图标容器 -->
    <div class="MoonIcon">
      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
        <path d="M12.1,22c-0.3,0-0.6,0-0.9,0c-5.5-0.5-9.5-5.4-9-10.9c0.4-4.8,4.2-8.6,9-9c0.4,0,0.8,0.2,1,0.5c0.2,0.3,0.2,0.8-0.1,1.1c-2,2.7-1.4,6.4,1.3,8.4c2.1,1.6,5,1.6,7.1,0c0.3-0.2,0.7-0.3,1.1-0.1c0.3,0.2,0.5,0.6,0.5,1c-0.2,2.7-1.5,5.1-3.6,6.8C16.6,21.2,14.4,22,12.1,22zM9.3,4.4c-2.9,1-5,3.6-5.2,6.8c-0.4,4.4,2.8,8.3,7.2,8.7c2.1,0.2,4.2-0.4,5.8-1.8c1.1-0.9,1.9-2.1,2.4-3.4c-2.5,0.9-5.3,0.5-7.5-1.1C9.2,11.4,8.1,7.7,9.3,4.4z" />
      </svg>
    </div>
  </div>
</label>

SCSS 样式实现

SCSS 允许我们使用变量、混合（mixins）和嵌套规则，使样式代码更具组织性和可维护性。

1. 变量定义

我们首先定义一系列SCSS变量，用于控制开关的尺寸、颜色和间距，便于统一管理和修改。

$width: 80px;
$height: 44px;
$border-radius: 50px;
$circle-size: $height - 4px; // 滑块大小
$icon-size: $circle-size - 2px; // 图标大小
$neutral: red; // 开关背景色
$secondary: white; // 悬停边框色
$base-100: white; // 默认边框色
$base-200: gray;
$base-300: black; // 滑块颜色
$base-content: white; // 图标填充色

2. 基本布局与外观

.ThemeToggler 是整个开关组件的容器，它定义了开关的整体尺寸、圆角、背景和边框。.ThemeTogglerFill 是内部的填充区域，通过其伪元素 ::before 来创建可滑动的“滑块”（thumb）。

.ThemeToggler {
  width: $width;
  height: $height;
  flex-shrink: 0;
  border-radius: $border-radius;
  background-color: $neutral;
  border: 1px solid $base-100;
  display: inline-block;
  cursor: pointer; // 鼠标样式
  &:hover {
    border-color: $secondary; // 悬停效果
  }
}

.ThemeTogglerFill {
  position: relative; // 为内部绝对定位的滑块和图标提供定位上下文
  &:before {
    content: "";
    position: absolute;
    top: 1px;
    left: 1px;
    height: $circle-size;
    width: $circle-size;
    background: $base-300;
    box-shadow: 1px 0px 4px rgba(0, 0, 0, 0.15);
    border-radius: $border-radius;
    transition: background-color 0.25s, transform 0.25s; // 滑块的动画效果
  }
}

3. 图标样式

我们定义一个 icon 混合（mixin）来封装图标的通用样式，例如尺寸、圆角和填充色。然后，.SunIcon 和 .MoonIcon 分别应用这个 mixin 并设置各自的定位，确保它们在开关内部的正确位置。

@mixin icon {
  position: relative; // 图标容器相对定位，方便内部SVG定位
  display: block;
  width: $icon-size;
  height: $icon-size;
  border-radius: 50%;
  overflow: hidden; // 隐藏溢出部分
  fill: $base-content; // SVG的填充色
}

.SunIcon {
  @include icon;
  top: 1.8px;
  left: 1.7px;
  // SVG图标的默认定位
}

.MoonIcon {
  @include icon;
  top: -35px; // 初始时将月亮图标定位在可见区域之外
  left: $circle-size + 2px;
}

4. 核心：图标的条件显示与隐藏

这是实现动态图标切换的核心部分。我们利用 .ThemeTogglerInput 的 :checked 伪类和相邻兄弟选择器 + 来控制滑块的位移以及太阳/月亮图标的 visibility 属性。

.ThemeTogglerInput {
  display: none; // 隐藏实际的复选框

  // 当复选框被选中时，滑块向右移动
  &:checked ~ .ThemeTogglerFill::before {
    transform: translateX($circle-size);
  }

  // 默认状态（复选框未选中）
  // 使用 + 选择器定位到紧邻的兄弟元素 .ThemeTogglerFill
  & + .ThemeTogglerFill {
    .MoonIcon {
      visibility: hidden; // 隐藏月亮图标
    }
    .SunIcon {
      visibility: visible; // 显示太阳图标
    }
  }

  // 选中状态（复选框被选中）
  // 再次使用 + 选择器，但这次是针对 :checked 状态的 input
  &:checked + .ThemeTogglerFill {
    .SunIcon {
      visibility: hidden; // 隐藏太阳图标
    }
    .MoonIcon {
      visibility: visible; // 显示月亮图标
    }
  }
}

解释：

display: none;：将实际的 input 复选框隐藏起来，使其不占用任何布局空间，但其状态仍然可被CSS访问。
&:checked ~ .ThemeTogglerFill::before：当 input 被选中时，通过通用兄弟选择器 ~ 找到其后的 .ThemeTogglerFill 元素，并作用于其 ::before 伪元素，实现滑块的 transform 动画。
& + .ThemeTogglerFill：这个选择器表示当 input 处于未选中状态时，其紧邻的兄弟元素 .ThemeTogglerFill 内部的 .MoonIcon 应该 visibility: hidden (隐藏)，而 .SunIcon 应该 visibility: visible (显示)。
&:checked + .ThemeTogglerFill：当 input 处于选中状态时，其紧邻的兄弟元素 .ThemeTogglerFill 内部的 .SunIcon 应该 visibility: hidden (隐藏)，而 .MoonIcon 应该 visibility: visible (显示)。

这里使用 visibility 属性而非 display: none 的原因是，visibility: hidden 会保留元素所占据的布局空间，而 display: none 则会完全移除元素。在本例中，由于图标是绝对定位的，两者在视觉效果上可能差异不大，但 visibility 可以为将来的过渡效果提供更多可能性（尽管 visibility 属性本身通常不能平滑过渡）。

完整的 SCSS 代码

将上述所有 SCSS 片段整合，形成完整的样式代码：

$width: 80px;
$height: 44px;
$border-radius: 50px;
$circle-size: $height - 4px;
$icon-size: $circle-size - 2px;
$neutral: red;
$secondary: white;
$base-100: white;
$base-200: gray;
$base-300: black;
$base-content: white;

.ThemeToggler {
  width: $width;
  height: $height;
  flex-shrink: 0;
  border-radius: $border-radius;
  background-color: $neutral;
  border: 1px solid $base-100;
  display: inline-block;
  cursor: pointer;
  &:hover {
    border-color: $secondary;
  }
}

.ThemeTogglerFill {
  position: relative;
  &:before {
    content: "";
    position: absolute;
    top: 1px;
    left: 1px;
    height: $circle-size;
    width: $circle-size;
    background: $base-300;
    box-shadow: 1px 0px 4px rgba(0, 0, 0, 0.15);
    border-radius: $border-radius;
    transition: background-color 0.25s, transform

好了，本文到此结束，带大家了解了《纯CSS实现SVG开关图标切换》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！