# 主题、语言和水印 Hooks
## 交互示例
::: details 查看示例源码
<<< @/../admin/src/views/demo/template-hooks/index.tsx
:::
## useTheme
`useTheme()` 返回下列方法。颜色覆盖由设置 Store 和全局 Provider 一起管理。
| 方法 | 行为 |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------ |
| `lightTheme()` / `darkTheme()` | 切换为手动浅色或深色,更新 Naive UI 的主题覆盖。 |
| `toggleTheme()` | 根据当前实际明暗状态切换到相反的手动主题。 |
| `syncSystemTheme()` | 读取浏览器偏好并切换到 `auto`,之后由设置 Store 跟随系统变化。 |
| `getAppTheme()` | 返回 `{ theme, themeLabel, themeI18nLabel }`;`theme` 为 `true` 表示深色,`themeLabel` 是固定的 `Dark` / `Light`。 |
`getAppTheme()` 返回一次读取的对象。界面要跟随语言或主题变化时,在 computed 或渲染中调用。自定义主色请使用 [Setting Store](../store/setting) 的 `changePrimaryColor`。
## useI18n
::: details 查看语言切换示例源码
<<< @/../admin/src/views/demo/hooks/web-hooks.tsx
:::
`useI18n(namespace?)` 返回 `t(key, ...args)`、`locale(lang)` 和初始化时可用的 Vue I18n 全局能力。`useI18n('menu').t('Dashboard')` 与 `useI18n('menu').t('menu.Dashboard')` 指向同一翻译键。未指定命名空间时,裸字符串原样返回。初始化前,`t` 返回解析后的键;初始化后同一个翻译函数会读取最新实例。
`@/hooks` 还导出独立的 `t(key)`,它只返回原始键,可供路由元数据和翻译工具静态识别。切换整个应用语言用 `useSettingActions().updateLocale(lang)`,以同步 Day.js、组件库和持久化语言;直接调用 `useI18n().locale` 只操作 Vue I18n 和 HTML 语言属性。
```ts
import { useI18n, useTheme } from '@/hooks'
import { useSettingActions } from '@/store'
import { computed } from 'vue'
export function useAppearanceSettings() {
const { t } = useI18n('menu')
const theme = useTheme()
const { updateLocale } = useSettingActions()
const title = computed(() => t('Dashboard'))
return {
title,
followSystem: theme.syncSystemTheme,
switchToEnglish: () => updateLocale('en-US'),
}
}
```
## useWatermark
`setWatermarkContent(content)` 合并水印文字;空字符串直接忽略。`showWatermark()`、`hiddenWatermark()`、`toggleWatermark()` 修改共享显隐状态。要清除显示,请调用 `hiddenWatermark()`。字体、旋转和间距从 Setting Store 的 `watermarkConfig` 修改,显示范围由 `AppWatermarkProvider` 所在位置决定。
```ts
import { useWatermark } from '@/hooks'
export function useReportWatermark() {
const { setWatermarkContent, showWatermark, hiddenWatermark } = useWatermark()
return {
enable() {
setWatermarkContent('内部报表')
showWatermark()
},
disable: hiddenWatermark,
}
}
```
源码:[useTheme](https://github.com/XiaoDaiGua-Ray/ray-template/blob/main/apps/admin/src/hooks/template/useTheme.ts) · [useI18n](https://github.com/XiaoDaiGua-Ray/ray-template/blob/main/apps/admin/src/hooks/template/useI18n.ts) · [useWatermark](https://github.com/XiaoDaiGua-Ray/ray-template/blob/main/apps/admin/src/hooks/template/useWatermark.ts)