助手
扣子 AI 帮助与支持
你好,我是 扣子 文档问答助手 🎉 你在阅读当前文档的过程中,无论对文档概念的解释,还是文档内容方面的疑问,都可以随时向我提问,我会全力为你解答
推荐问题
如何快速了解这个空间的核心内容?
有哪些近期更新的重点文档?
我应该从哪些文档开始阅读?
文档反馈

设置界面变量

更新于: 2026-06-24 15:44:40

界面变量主要用于存储低代码应用页面的临时数据,实现组件与页面之间的信息传递以及交互联动。例如,要快速复制文本内容,只需将目标文本赋值给界面变量,然后通过调用数据设置方法,即可轻松完成操作。界面变量的作用范围覆盖当前低代码应用内的所有页面,这使得它在跨页面的数据共享和交互中非常实用。本文将详细介绍如何为低代码应用设置界面变量。

变量类型

低代码应用的界面变量与应用变量、系统变量、用户变量是不同使用维度的变量。

  • 界面变量:界面变量用于临时存储页面数据,是比较灵活的变量配置方式,开发者可根据页面交互逻辑随时修改变量值。
  • 系统变量:系统为低代码应用自动创建用户信息、飞书等类别的系统变量,默认全部关闭,为不可用状态,你可以根据实际业务需求选择开启需要的系统变量。开启后,系统在用户请求时自动产生变量数据,这些数据是只读的,不可由用户或开发者修改。
  • 应用变量:应用变量本质是内存变量,每执行一次工作流,应用变量就会自动恢复到最初设定的默认值,就像游戏中的生命值,每次开始新的一局游戏时,生命值都会重置为游戏设定的初始值。
  • 用户变量:用户变量用于存储每个用户在使用低代码应用过程中,需要持久化存储和读取的数据,例如用户的个性化设置、语言偏好、历史交互记录等。

关于系统变量、应用变量和用户变量的详细说明,请参考为低代码应用设置变量

定义变量

在低代码应用用户界面数据页签下,单击 + 图标,定义变量。其中,默认值为可选配置。

说明

  • 定义界面变量时,每个界面变量名需在低代码应用内唯一,可与应用变量、系统变量、用户变量同名。
  • 修改界面变量名称,可能会对已引用该变量的组件产生影响。因此,如果要修改变量名称,请同步更新组件中的界面变量配置。

Image
页面变量无需设置数据类型,将自动根据变量值格式自动设置,支持的数据类型如下:

  • String:字符串,用于存储文本数据,例如单词、句子或字符序列。
  • Integer:整数,用于存储整数,例如 -3、0、1024 等。
  • Boolean:布尔值,用于逻辑判断和条件控制,可选值为 true 和 false。
  • Number:数值,用于存储带小数部分的数值,包括整数和浮点数,例如 3.14、-0.001 等。
  • Object:对象,用于存储键值对集合,可以表示复杂的数据结构,例如 JSON 对象。
  • Array:字符串数组,用于存储一系列字符串,每个元素都是 String 类型。
  • Array:整数数组,用于存储一系列整数,每个元素都是 Integer 类型。
  • Array:布尔值数组,用于存储一系列布尔值,每个元素都是 Boolean 类型。
  • Array:数值数组,用于存储一系列数值,每个元素都是 Number 类型。
  • Array:对象数组,用于存储一系列对象,每个元素都是 Object 类型。

    为变量赋值

    在定义变量时,你可以为变量设置一个默认值。你也可以通过事件动作,为变量赋予动态值,即添加一个组件,在组件的事件配置中,完成如下配置。

    • 执行动作:选择界面变量赋值
    • 选择界面变量:选择为需要赋值的界面变量。
    • 变量值:包括输入值或默认值。
      • 输入值:支持输入静态值或动态变量值,例如 {{translation.data}}
      • 默认值:固定为定义变量时的默认值。

    Image

    配置示例

    例如在图像生成类应用中,若要根据内置提示词生成同款图像时,可通过为界面变量赋值方式快速复制内置提示词,并填入到提示词输入框中,配置如下:

    • 数据页签中定义一个名为 prompt 的变量。
    • 为内置提示词所在文本框 Text9 组件添加一个事件,单击该文本框时,将提示词内容赋值给为prompt变量。
      • 事件类型:选择点击时
      • 执行动作:选择界面变量赋值
      • 选择界面变量:选择 prompt
      • 变量值:选择输入值,并输入 {{Text9.content}}
        Image
    • 为提示词输入框 Textarea1 组件添加一个事件,当鼠标聚焦在输入框时,自动将 prompt 变量值填入该组件内。
      • 事件类型:选择数据聚焦时
      • 执行动作:选择控制组件
      • 选择组件:选择 Textarea1
      • 组件方法:选择设置数据
      • 数据:输入 {{prompt.value}}
        Image