管理和编排组件

更新时间:
复制为 MD 格式

通过低代码可视化方式搭建可跨页面复用的组件,该组件内部可包含变量、逻辑流、JS方法等构成复杂的组件逻辑。本文介绍如何新建、编排、使用和删除组件等操作。

前提条件

  • 当前应用为轻应用。

  • 当前应用版本处于开发状态,尚未发布。

  • 当前账号具有应用开发权限。

新建组件

  1. 应用列表页面,单击目标轻应用名称。

  2. 在目标轻应用导航栏中,选择应用开发 > 组件编排

  3. 组件编排页面,单击新建组件

  4. 新建组件面板,完成组件名称组件编码描述(非必填)设置后,单击创建

    说明

    组件编码英文字母和数字的组合,以字母开头,且项目内唯一,创建后不支持修改。编码长度不得超过80个字符。

编排组件

  1. 组件编排页面,单击目标组件或其右侧操作列下的编排组件

    如果您在创建轻应用时应用场景配置为PC端+H5,您可以单击image.pngimage.png图标切换端侧。进入低代码编辑器界面,左侧工具栏提供组件、变量等工具,中间画布区域展示当前组件内容,右侧属性面板提示请在左侧画布选中节点后可编辑属性。顶部可切换桌面端与移动端预览,并提供组件定义保存按钮。

    说明

    本文以仅应用场景配置为PC为例说明如何编排组件。

  2. 在新打开的编排组件画布,构建业务组件。单击画布左侧的1图标,在标准组件自定义组件页签下,您可以拖拽目标组件至画布右侧然后构建业务组件。在右侧组件定义面板中,勾选低代码组件复选框,在属性定义区域添加属性项(如 titleintroimage),在事件定义区域添加事件项(如 onClick)。

    业务组件是根据场景需求,将多个基本组件按照一定顺序、样式或逻辑组合成为一个可在多处重复利用的组件。在后续开发过程中如果遇到类似需求,您可以直接使用该业务组件,而不需要从基本组件重新开始构建。

  3. 配置组件属性。单击组件编排画布右上角的组件定义,您可以参考以下步骤配置组件属性。

    • 属性页签下的属性定义区域,您可以通过单击添加一项添加组件属性。页面下方事件定义区域包含事件当点击时(事件编码 onClick),同样支持编辑、删除和通过添加一项 +新增事件。

      例如,下图添加了titleintroimage三个属性,您可以单击目标属性名称左侧的1图标编辑属性类型设置器支持动态配置默认值等。单击属性右侧的编辑图标,在左侧弹出的属性编辑面板中配置以下字段:属性名称(例如图片)、属性编码(例如image)、属性类型(例如String)、设置器(例如StringSetter)、支持动态配置开关及默认值等。

      业务组件支持属性自定义操作,丰富了组件的属性,您可以通过配置的属性来定制符合业务需求的组件。

    • 属性页签下的事件定义区域,您可以通过单击添加一项添加事件类型的属性。

      单击属性名称左侧的1图标编辑事件标题事件入参等。添加事件后,单击事件行右侧的编辑图标,可在弹出的编辑浮层中配置事件标题(如 当点击时)、事件编码(如 onClick),以及事件入参(包括入参编码入参类型)。

      业务组件在触发某一事件时会执行该属性。

  4. 绑定属性。

    • 绑定基础属性。将步骤3中设置的属性绑定到业务组件内部需要外部控制的基础组件的属性上。例如,将业务组件的title属性绑定到其内部卡片组件的标题属性上。

      单击卡片组件标题属性右侧的1图标,在绑定变量对话框中,选择props > title,完成后单击确定。您后续如果再配置更新该业务组件的title属性,则该卡片组件的标题属性也会同步更新。

    • 绑定事件属性(您需进入到逻辑流面板绑定事件属性)。

      1. 单击目标基础组件的事件页签,选择新建动作 > onClick点击时。在画布中选中目标组件(如卡片内的图片),在右侧属性面板中单击 事件 标签页,在 onClick 点击时 区域中单击 新建动作

      2. onClick点击时对话框中,单击逻辑编排,页面会自动跳转至逻辑流编排页面。

      3. 在逻辑流编排画布右侧的流程图中单击1图标,在弹出的编排节点框中,选择执行组件事件。在逻辑流编排页面,单击流程节点下方的 + 按钮添加动作,在弹出的动作选择面板中选择 执行组件事件

      4. 执行组件事件面板,选择步骤3中已配置的目标业务组件事件,且完成入参相关配置项设置后,单击保存。在 执行组件事件 配置弹窗中,将 组件事件 设置为 onClick,在 入参赋值 区域将 paramName 参数的赋值方式设置为 变量,值选择 props.title,然后单击 保存

        上图中被绑定的组件在触发点击动作时,就会执行该事件属性。

      5. 完成业务组件构建后,单击组件编排页面右上角的保存

使用组件

  1. 页面编排页面,单击目标页面名称或目标页面名称右侧操作列下的编排页面

  2. 在页面编排画布中,单击画布左侧的1图标,在区块面板低代码组件页签下,您可以拖拽目标业务组件至画布右侧然后进行页面编排。

    具体操作,请参见可视化编排页面

    根据具体场景的需要,配置业务组件的属性,通过给每一个属性传入具体的值,内部接收到后会将值传入到被绑定的具体属性上。拖入卡片组件后,选中该组件,右侧将出现配置面板,包含 属性样式事件 三个页签。在 属性 页签中可设置 唯一标识是否显示(开关控制)、标题简介图片(填写图片 URL)等字段,每个字段右侧提供数据绑定按钮。

编辑组件属性

  1. 组件编排页面,单击目标组件右侧操作列下的编辑属性

  2. 编辑组件面板,按需完成相关设置后,单击保存

删除组件

  1. 组件编排页面,单击目标组件右侧操作列下的删除

    重要

    删除组件****,会导致调用了该组件的页面在运行时无法正常渲染,请您谨慎操作。

  2. 在二次确认对话框中,单击删除