颜色模式
Nuxt UI 与 Nuxt Color Mode 集成,可轻松在浅色和深色主题之间切换。
用法
Nuxt UI 会自动为你注册 @nuxtjs/color-mode 模块,因此无需额外设置。
组件
你可以使用内置的 ColorModeAvatar 或 ColorModeImage 组件来为浅色和深色模式显示不同图片,也可以使用 ColorModeButton、ColorModeSwitch 或 ColorModeSelect 组件在浅色和深色模式之间切换。
你还可以使用 useColorMode 组合式函数来构建自己的自定义组件:
ColorModeButton.vue
<script setup lang="ts">
const colorMode = useColorMode()
const isDark = computed({
get() {
return colorMode.value === 'dark'
},
set(_isDark) {
colorMode.preference = _isDark ? 'dark' : 'light'
}
})
</script>
<template>
<ClientOnly v-if="!colorMode?.forced">
<UButton
:icon="isDark ? 'i-lucide-moon' : 'i-lucide-sun'"
color="neutral"
variant="ghost"
:aria-label="`Switch to ${isDark ? 'light' : 'dark'} mode`"
@click="isDark = !isDark"
/>
<template #fallback>
<div class="size-8" />
</template>
</ClientOnly>
</template>
配置
你可以通过 nuxt.config.ts 中的 ui.colorMode 选项来禁用 @nuxtjs/color-mode 模块:
nuxt.config.ts
export default defineNuxtConfig({
modules: ['@nuxt/ui'],
css: ['~/assets/css/main.css'],
ui: {
colorMode: false
}
})