Skip to content

witTheme 主题切换组件

witTheme是一个用于打开主题设置面板的组件,提供了一个简洁的图标按钮,点击后可触发主题设置面板的显示,方便用户切换系统主题样式。

用法实列

vue
<template>
  <div>
    <!-- 基础用法 -->
    <witTheme />
    
    <!-- 自定义容器 -->
    <div class="custom-theme-container">
      <witTheme />
    </div>
  </div>
</template>

<script lang="ts" setup>
// 无需额外配置,组件会自动触发主题设置面板
</script>

API

组件

属性名类型默认值描述
---无额外属性配置

插槽

插槽名描述
-无插槽配置

事件

事件名描述参数
-无直接暴露事件-

功能特性

1. 主题设置入口

组件提供了一个直观的图标按钮作为主题设置的入口,用户点击即可打开主题设置面板。

2. 事件驱动

点击组件时,会通过$pub方法发布wit-vite-open-theme事件,系统监听该事件后会打开主题设置面板。

3. 样式适配

组件使用了Flex布局和居中样式,确保图标在容器中居中显示,适应不同的布局环境。

实现原理

组件通过发布/订阅模式与主题设置系统进行通信:

  1. 用户点击主题图标按钮
  2. 组件调用$pub('wit-vite-open-theme')发布主题打开事件
  3. 系统中监听该事件的模块(通常是主题设置面板相关组件)接收事件并显示主题设置面板

样式结构

组件采用简洁的样式设计:

  • 使用Flex布局实现图标居中
  • 应用了right-tool-boxflexall-center类名
  • 图标使用了ri-t-shirt-line,代表主题相关功能

TIP

  1. 组件需要配合系统的主题设置模块使用,确保有相应的事件监听器存在
  2. 可以通过自定义容器类名来调整组件的显示位置和样式
  3. 组件图标使用了Element Plus的图标系统,可以根据需要进行替换

湘ICP备2024070110号