警告
Microsoft Graph 工具包已弃用。 停用期从 2025 年 9 月 1 日开始，计划于 2026 年 8 月 28 日完全停用。 开发人员应迁移到使用 Microsoft Graph SDK 或其他受支持的Microsoft Graph 工具来构建 Web 体验。 有关详细信息，请参阅 弃用公告。
主题切换组件允许用户使用切换将文档主题从浅色设置为深色。
用户可以使用主题切换组件将默认主题设置为 light 或 dark。 然后，用户可以使用切换开关来切换这些模式。
示例
以下示例演示主题切换如何根据用户的首选项设置浅色或深色模式。
属性
| 属性 | 属性 | 说明 |
|---|---|---|
| mode | mode | 用于设置主题切换的默认模式的字符串。 默认值为 light。 |
以下示例显示将 dark 模式设置为默认模式。
<mgt-theme-toggle mode="dark"></mgt-theme-toggle>
自定义 CSS 变量
主题切换组件没有自定义 CSS 变量。
事件
| 事件 | 何时发出 | 自定义数据 | 可取消 | 泡沫 | 使用自定义模板 |
|---|---|---|---|---|---|
darkmodechanged |
当用户作触发深色模式时触发。 |
boolean 价值。
true 如果为深色模式，则为 false |
否 | 否 | 否 |
有关处理事件的详细信息，请参阅 事件。
模板
主题切换组件没有自定义模板。
Microsoft Graph 权限
主题切换组件不需要任何Microsoft Graph 权限才能正常工作。
身份验证
主题切换组件不需要身份验证才能正常工作。
缓存
主题切换组件不缓存任何数据。
本地化
控件公开以下可本地化的变量。 有关如何设置本地化的详细信息，请参阅 本地化组件。
| 字符串名称 | 默认值 |
|---|---|
| 标签 | Color mode: |
| on | Dark |
| 关 | Light |