开发和管理自定义组件

更新时间:
复制为 MD 格式

您可以通过自定义组件功能上传在线下开发的自定义组件,上传后的自定义组件可以在页面设计器中使用。本文介绍如何开发和管理自定义组件。

开发自定义组件流程说明

开发自定义组件流程说明如下:q1

环境要求

  • node版本:14.20.X

  • npm版本: 6.14.X

开发自定义组件操作步骤

步骤一:下载示例代码

关于如何下载开发模板,请参见下载示例代码

步骤二:安装依赖

解压下载的zip包,进入工程根目录,执行npm install命令安装依赖。

npm install

步骤三:启动本地应用

执行npm start命令启动本地应用。

D:\xxx>npm start

> @ali/bwf-test-materials@1.0.0 start
> gulp start

[15:40:20] Starting 'start'...
Starting the development server...
Version: webpack 4.46.0
Time: 3520ms
Built at: 2023/02/15 15:40:24
         Asset      Size   Chunks             Chunk Names
  design-view.js   6.19 KiB  design-view  [emitted]  design-view
design-view.js.map  4.45 KiB  design-view  [emitted] [dev]  design-view
        meta.js   7.8 KiB     meta  [emitted]        meta
      meta.js.map  6.39 KiB     meta  [emitted] [dev]     meta
        view.js   6.09 KiB     view  [emitted]        view
      view.js.map  4.41 KiB     view  [emitted] [dev]     view
Compiled successfully.
http://localhost:3200
页面URL后面追加    &__bwfInjectFrom__=http%3A%2F%2Flocalhost
[15:40:24] Finished 'start' after 3.82 s

步骤四:调试自定义组件

在应用开发过程中,您无需上传本地组件至平台,即可在任意页面设计器中发起对自定义组件的预览及调试。调试步骤如下:

  1. 打开任意页面编排设计器。页面编排设计器左侧为组件面板,包含布局基础表单等分类,中间为画布区域,可将组件拖拽至画布进行页面编排。

  2. 复制&__bwfInjectFrom__=http%3A%2F%2Flocalhost%3A3200,追加在设计器页面URL的末尾,回车刷新页面后您可以在组件面板区域的自定义组件页签下看到已经加载的自定义的组件。其中自定义组件页签与标准组件页签并列显示,加载的自定义组件出现在基础分类下。

步骤五:生成自定义组件zip

执行npm run build命令构建JS文件,脚本会在根目录生成component.zip

D:\xxx>npm run build

> @ali/bwf-test-materials@1.0.0 build D:\xxx
> gulp build

[15:46:09] Starting 'build'...
Using typescript@3.9.10 from typescript
[15:46:13] Finished 'build' after 3.61 s

> @ali/bwf-test-materials@1.0.0 postbuild
> gulp zip

[15:46:17] Starting 'zip'...
[15:46:17] Finished 'zip' after 25 ms
D:\test-materials>

步骤六:发布自定义组件(新增自定义组件)

  1. 登录BizWorks,在选择平台下拉列表中选中轻应用组装平台image.png

  2. 单击页面右上角a7.png图标或其文本框区域,在下拉列表中单击目标项目名称后,单击应用页签。在应用列表页面单击目标轻应用名称。image.png

  3. 在目标轻应用导航栏中,单击扩展管理,在扩展管理页面单击自定义组件页签。

  4. 扩展管理自定义组件页签,单击新增自定义组件

  5. 新增自定义组件面板,单击虚线框区域或拖拽目标zip包至虚线框区域内,完成文件上传。上传文件大小不超过50 MB

  6. 填写自定义组件名称编码描述(可选)。

  7. 单击确认

    自定义组件页面,您可查看所新增的定义组件。

编辑自定义组件

  1. 自定义组件页面,单击目标自定义组件或目标自定义组件右侧操作列下的编辑

  2. 编辑自定义组件面板,完成自定义组件名称描述信息修改后,单击确认

下载自定义组件

自定义组件页面,单击目标自定义组件名称右侧操作列下的下载

删除自定义组件

  1. 自定义组件页面,单击目标自定义组件名称右侧操作列下的删除

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

下载示例代码

自定义组件页面,单击下载示例代码