kwgt 中文文档 下载 App

kwgt Globals 全局变量 跨元素跨预设共享数据

什么是全局变量

全局变量(Globals)是 kwgt 中一个预设内所有元素都可以读取和写入的"共享状态"。类比:

典型用法

  1. 统一颜色主题:在 Root 层设 $gv(theme_color, '#3388FF')$ → 整个预设的颜色都读 $gv(theme_color)$ → 改一处就全站变色
  2. 条件触发:某个按钮点击时设 $gv(show_sidebar, 1)$ → 其他元素根据这个值决定显示 / 隐藏
  3. 动画计时:在一个元素里递增时间计数 → 其他元素读这个计数做联动动画

怎么创建 Globals

在属性面板的 Globals 标签页:

  1. 点 + 添加一个新变量
  2. 起名(英文,别用中文和空格)
  3. 设初始值(数字、字符串、颜色都可以)

比如创建一个叫 mycolor 的变量,初始值是 #3388FF。

怎么读 Globals

在任意属性里写:

$gv(mycolor)$

kwgt 会把它解析成 #3388FF。如果后面你在别处改变了 mycolor 的值,所有读它的地方会自动变。

怎么写 Globals(赋值)

在函数里:

$gv(mycolor, '#FF0000')$

第二个参数是新值。赋值操作通常放在 Touch 动作里("点击这个按钮时把 theme_color 改成红色")。

跨 App 共享

kwgt 的 Globals 和 KLWP 的 Globals 可以互相访问。这意味着:

Tasker 也能读写

如果你装了 Tasker,可以通过 Kustom 的 Tasker 插件从外部设置 / 读取 Globals。这是自动化发烧友的进阶玩法。