本页采用了机器翻译。点击此处可查看最新英文版本。

Web App 的浅色和深色模式

R2025b

MATLAB® Web App Server™ 支持根据用户的桌面主题（可以是 'dark' 或 'light'）来渲染 Web App。默认情况下，如果 App 设计者没有指定主题，则 App 将采用用户当前的桌面主题。不过，App 设计者可以使用 App 设计工具中提供的属性来强制使用特定主题。

在 App 设计工具中创建 App 时，app.UIFigure 元素有两个关键属性：Theme 和 ThemeMode 。

Theme

此属性指定 App 的视觉主题。用户可以将其设置为 'light' 或 'dark'，这些字符串值解析为 GraphicsTheme 对象。这可确保 App 中的所有组件都采用与所选主题一致的颜色和样式。

ThemeMode

该属性决定主题的应用方式。有两个选项：'auto' 和 'manual' 。

  • auto:自动将桌面当前主题应用于 App。该设置可确保与用户的系统主题首选项同步。在此模式下，任何对主题属性的手动设置都会被系统主题覆盖。

  • manual:允许用户明确指定 App 的主题，与桌面设置无关。这种模式为希望强制使用特定主题的开发人员提供了灵活性。

当 ThemeMode 设置为 'auto' 时，App 会自动调整其主题以匹配桌面主题。在这种情况下，任何将 Theme 属性手动设置为 'dark' 或 'light' 的尝试都会被忽略，因为系统主题优先。要强制使用特定主题，请将 ThemeMode 设置为 'manual'，然后指定所需的 Theme 。

在 App 设计工具中设置 Theme 和 ThemeMode 属性

在 App 设计工具中设置 Theme 和 ThemeMode：

  1. 从 App 设计工具中的 Component Browser 中选择 app.UIFigure 。

  2. 导航至 Window Appearance 部分。

  3. 点击 Theme 旁边的下拉菜单，选择 light 或 dark 作为您喜欢的主题。

  4. 找到 ThemeMode 下拉菜单，就在 Theme 设置的下方，选择 auto 进行基于系统的调整，或选择 manual 进行手动控制。

另请参阅

(MATLAB)