门户开发-组件介绍-部件、部件元素-门户管理-O2OA企业应用开发平台-人人都是协同系统开发专家

门户开发-组件介绍-部件、部件元素

时间：2023-03-21

O2OA(翱途)开发平台[下称O2OA开发平台或者O2OA]拥有门户页面定制与集成的能力，平台通过门户定制，可以根据企业的文化，业务需要设计符合企业需要的统一信息门户，系统首页等UI界面。从本篇讲的是页面设计器元素组件中部件、部件元素组件。

一、先决条件

1、O2Server服务器正常运行，系统安装部署请参考文档《如何在服务器上安装部署O2OA》

2、以拥有管理员权限或拥有门户管理员（PortalManager角色）的用户账号登录O2OA(翱途)开发平台，如：xadmin

3、可以进入门户管理平台并且有开发权限，请参考《门户开发-门户设计开发入口和权限说明》

二、部件

image (46).png

部件是门户中的一个设计元素。在页面中，我们会设计一些组件集合，形成一些可被重复使用的功能，我们希望在别的页面中直接使用它，而不需要重新设计，这时我们可以把这写组件放入一个容器中，就可以把容器保存为一个部件。当然，您也可以到“部件”管理视图中直接新建一个部件。具体可以查看文档《如何创建部件》

部件类似与子表单，在很多时候可以减少我们设计页面的工作量，比如统一的banner条，统一的菜单栏等。

部件被加入到页面中后，您不能在当前页面中修改部件内的设计；而当改变部件设计时，所有使用改部件的页面也会相应改变，这是和“部件元素”最大的区别。

image (47).png

部件特有的属性如下：

属性	描述	备注
选择部件	通过下面的下拉框选择当前门户的部件
计算部件	通过脚本返回要使用的部件名称、别名或ID
参数	可以通过直接配置或脚本方式给部件传递参数	当部件中使用了脚本，而脚本又需要外部传入参数时使用。参数是json格式，在部件中，可以通过this.page.getWidgetPrameters().id获取（id为部件元素的标识）。这样虽然使用同一个部件，也可以有不同的个性化展现。

image (48).png

当部件元素被拖动到页面时，会出现一个对话框，要求选择一个部件：

然后系统会将所选部件的所有内容插入到当前页面中。

部件元素并不是一个真正的页面元素，因为当部件被插入时，部件内的元素已经被打散了，和我们在表单上添加的元素一样。插入的部件内的元素您可以在页面上继续编辑，而部件本身如果发生修改，不会影响到当前页面了。它有点类似与一个快速的拷贝部件元素的一种方式。

logo_all@1.5x.png