跳到主要内容

常量

JadeView 易语言 SDK 中定义了一些常量，用于简化代码编写和提高代码可读性。以下是所有公开的常量：

主题常量​

JadeView 易语言 SDK 提供了三个主题常量，用于设置 WebView 窗口的主题。

主题_亮色​

常量：#主题_亮色

值："Light"

描述：设置 WebView 窗口使用浅色主题。

使用场景：

  • 当需要固定使用浅色主题时
  • 当应用程序默认使用浅色主题时

示例代码：

.局部变量 窗口设置, JadeView窗口设置
窗口设置.窗口主题 ＝ #主题_亮色

主题_暗色​

常量：#主题_暗色

值："Dark"

描述：设置 WebView 窗口使用深色主题。

使用场景：

  • 当需要固定使用深色主题时
  • 当应用程序默认使用深色主题时

示例代码：

.局部变量 窗口设置, JadeView窗口设置
窗口设置.窗口主题 ＝ #主题_暗色

主题_自动​

常量：#主题_自动

值："System"

描述：设置 WebView 窗口跟随系统主题自动切换亮色和暗色。

使用场景：

  • 当希望应用程序跟随系统主题时
  • 当需要提供更好的用户体验时

示例代码：

.局部变量 窗口设置, JadeView窗口设置
窗口设置.窗口主题 ＝ #主题_自动

使用建议​

  • 优先使用主题常量，而不是直接使用字符串字面量，这样可以提高代码的可读性和可维护性
  • 在设置窗口主题时，考虑用户的系统偏好，建议默认使用 #主题_自动
  • 可以根据用户的设置动态切换主题，例如提供主题切换选项

注意事项​

  • 主题常量的值是字符串类型，直接使用字符串字面量也可以达到相同的效果，但不推荐
  • 主题切换可能会触发 WebView 的重新渲染，可能会有短暂的闪烁
  • 某些系统或浏览器版本可能不支持自动主题切换，此时会回退到默认主题

相关 API​

  • set_window_theme - 动态设置窗口主题
  • get_window_theme - 获取当前窗口主题

总结​

JadeView 易语言 SDK 提供的主题常量简化了主题设置的代码编写，提高了代码的可读性和可维护性。建议在开发过程中优先使用这些常量，而不是直接使用字符串字面量。