颜色模式开关PRO

开关GitHub
用于在亮色模式和暗色模式之间切换的开关。

用法

ColorModeSwitch 组件继承自 Switch 组件，因此你可以传入任意属性，例如 color、size 等。

<template>
  <UColorModeSwitch />
</template>

示例

使用自定义图标

使用 app.config.ts 通过 ui.icons 属性自定义图标

app.config.ts
export default defineAppConfig({
  ui: {
    icons: {
      light: 'i-ph-sun',
      dark: 'i-ph-moon'
    }
  }
})

使用 vite.config.ts 通过 ui.icons 属性自定义图标

vite.config.ts
import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'
import ui from '@nuxt/ui/vite'

export default defineConfig({
  plugins: [
    vue(),
    ui({
      ui: {
        icons: {
          light: 'i-ph-sun',
          dark: 'i-ph-moon'
        }
      }
    })
  ]
})

API

Props

属性默认值类型
as

'div'

任意类型

该组件应渲染为的元素或组件。

disabled

boolean

当为 true 时，阻止用户与开关交互。

color

'primary'

"error" | "primary" | "secondary" | "success" | "info" | "warning" | "neutral"

size

'md'

"md" | "xs" | "sm" | "lg" | "xl"

ui

{ root?: ClassNameValue; base?: ClassNameValue; container?: ClassNameValue; thumb?: ClassNameValue; icon?: ClassNameValue; wrapper?: ClassNameValue; label?: ClassNameValue; description?: ClassNameValue; }

颜色模式选择框

用于在系统、暗色和亮色模式之间切换的选择框。

颜色选择器

用于选择颜色的组件。