创建组件包和组件
开启组件开发
切换到“高级”页签,选中“开启组件开发”,如下图所示
创建组件包
切换回“页面”页签,点击“添加市场组件”的 + 按钮,弹出市场组件窗口,如下图所示
点击“新建组件包”弹出“选择向导模板”窗口,点击“组件包模板”上面的引用按钮,如下图所示
点“确定”按钮,弹出“新建组件包”窗口,输入
- 组件包名:组件包的名称
- 组件包显示名:组件包的中文名
- 组件包类型:选择桌面端或移动端
- 组件包架构:选择 react 或 vue
- 组件包描述:组件包的描述,选填
- 组件包版本:组件包的版本号,选填
点“确定”按钮,创建组件包,IDE 自动切换到组件包对应的端,如下图所示
创建组件
切换到组件包所在的端,如下图所示,点“+”按钮,弹出“新建组件”窗口
在新建组件窗口中,输入
- 组件模板:选择可视组件(例如按钮组件)、不可视组件(例如对话框组件)、数据组件
- 组件名称:组件的名称,首字母大写
- 组件显示名称:组件的中文名称,会显示在组件面板上
- 组件分类:组件显示在组件面板对应的分类中。
点击“确定”按钮,在组件包中创建了一个组件,目录结构如下图所示
切换到组件包相应的端(例如桌面端),组件面板中已经显示出了刚创建的组件,如下图所示
安装第三方组件
如果组件中使用到了第三方组件,第三方组件提供 npm install,可以在组件包高级设置中进行安装。如下图所示,点击组件包右侧的高级…按钮,弹出组件高级设置窗口
点击新增按钮,会在 NPM 依赖管理列表中添加一个空行
- NPM 依赖模块名称:输入安装包名称
- NPM 依赖模块版本号:不输入版本号,会安装最新版本,否则安装指定版本
点击“确定”按钮,开始安装,安装后显示安装结果,安装成功如下图所示
安装失败如下图所示
安装的文件在组件包命名空间目录下的 lib/node_modules 目录中,例如:model\UI2\comp\bizcomps\components\bizcomps\lib\node_modules
特别说明
- 安装的包只能用于运行时,不能用于设计时
- __module.js 文件是一个标志文件,必须有,表示这里有外部包
在组件运行时 JS 文件中引用即可,代码如下图所示
在页面中添加组件,预览效果如下图所示