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布局和居中样式,确保图标在容器中居中显示,适应不同的布局环境。
实现原理
组件通过发布/订阅模式与主题设置系统进行通信:
- 用户点击主题图标按钮
- 组件调用
$pub('wit-vite-open-theme')发布主题打开事件 - 系统中监听该事件的模块(通常是主题设置面板相关组件)接收事件并显示主题设置面板
样式结构
组件采用简洁的样式设计:
- 使用Flex布局实现图标居中
- 应用了
right-tool-box、flex和all-center类名 - 图标使用了
ri-t-shirt-line,代表主题相关功能
TIP
- 组件需要配合系统的主题设置模块使用,确保有相应的事件监听器存在
- 可以通过自定义容器类名来调整组件的显示位置和样式
- 组件图标使用了Element Plus的图标系统,可以根据需要进行替换
