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

设置组件内容参数

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

用户界面搭建过程中,某些组件例如文本组件支持输入和编辑内容。为了灵活地设置这些组件的内容参数,用户界面编辑器提供了两种配置方式:设置常量和引用变量。本文将详细介绍如何配置组件的内容参数,包括常量设置和变量引用。
支持设置内容参数的组件种类繁多,包括但不限于文本、按钮、表单、列表、开关、多行文本、徽章、代码展示器、Markdown、下拉选项、数字输入框、文件上传、图片上传。
Image

设置常量

设置常量是一种在组件中直接指定固定值的方法,适用于内容不需要动态更新的场景。
以文本组件为例,演示如何设置常量。

  1. 在低代码应用的用户界面页签,从组件栏中拖动一个文本组件到画布。
  2. 在右侧属性面板,找到内容参数,配置所需的文本内容。
    Image

配置完成后,在画布查看文本组件的内容。
Image

引用变量

引用变量是一种动态设置内容参数的方法,可以根据运行时的数据动态更新组件内容,适用于需要与其他组件或数据源交互的场景。引用变量的基本语法是在变量名前加上双大括号 {{}}。例如,如果你有一个名为 username 的变量,你可以在组件中这样引用它:{{username}}
目前,支持引用工作流的返回数据、组件的 content、URL 参数和局部上下文。

注意

引用变量时,请注意:

  • 变量作用域:确保引用的变量在当前组件或页面的作用域内是可访问的。如果变量未定义或不在作用域内,将导致显示错误或空白。
  • 变量更新:当变量的值发生变化时,引用该变量的组件应该自动更新其显示内容。确保正确设置组件的引用变量,以响应变量值的变化。

在组件中引用变量时,支持引用工作流输出节点的输出内容,可以在用户界面中呈现类似“Loading 中”的效果,避免某个节点处理时间过长,影响用户体验。目前仅支持引用主工作流的输出节点,暂不支持引用子工作流中的输出节点。此外,引用循环节点或批处理节点中的输出节点时,不可引用其中某次循环或某次批处理流程中的输出节点。
例如以下示例,表示引用工作流 solve_problem输出节点_1 的输出内容。
Image

示例

以文本组件A引用文本组件B的content为例,演示如何引用变量:

  1. 在画布中,选中需要设置内容参数的文本组件A。
  2. 在右侧属性面板,找到内容参数,单击展开图标。
    Image
  3. 在弹窗中,找到文本组件B,然后单击其content方法,即可引用文本组件B的文本内容。
    Image

引用完成后,在画布中查看文本组件A的内容。
Image