# 界面布局

当用户在页面列表中点击“设计”,将会在新的标签页进入该页面设计状态,进入设计器,设计器整体布局如下图所示:

editor1

如图中所示,整体Meper的设计页面分为5个区域:

  1. 组件大纲
  2. 组件库
  3. 设计区域
  4. 属性编辑区域
  5. 操作栏

# 组件大纲

componentlist1

组件大纲会将所有添加到该页面的组件以树状结构罗列出来,树状结构表明了组件的层次,在同一个父组件下,从上到下,表示组件的加入顺序,靠上的表示 最先加入父容器。

除此之外,用户可以在组件树中选中一个节点,并进行上移,下移以及删除操作。当用户做对应的操作的时候,区域3中的组件也将同步做相应的变化。

各节点的显示如图中 1 所示,显示的规律为首先显示控件的类型,然后“- >” 后显示他的别名和ID。

用户可以观察图中 2 的眼睛,现在的状态代表组件是显示的,眼睛上带斜线则代表控件被隐藏。

# 组件库

组件库会随着后续版本发布而逐渐丰富,争取涵盖所有常用的组件

componentlibrary1

组件库支持检索,用户输入组件的名称,将会模糊查询系统中支持的组件,将符合条件的组件罗列出来,供用户选择。

系统支持以下两种方式进行组件添加:

  • 拖动一个组件到设计区域,系统会根据拖动的目标对象,将拖动的组件加入目标对象
  • 双击一个组件。 该模式下需要保证已经选择了一个父对象,否则双击的组件将加入到根容器中

不管是拖动组件,还是双击添加,只有在父容器支持的组件才会被加入。比如一个Column组件不能加入到除Grid之外的组件中,如果用户拖动到一个Layout中 那么将没有任何效果,拖动失败。

如图所示,目前组件库分为四大类(后面章节会对各个组件进行介绍,这里仅仅对分类做大致介绍):

  • Basic 基础控件,如表格,按钮,column,Label等组件

  • Input 所有输入类型的组件,如text field,password field,combo box,Radio Button, Check Box等等

  • Layout 所有布局类型的组件,如VerticalLayout,HorizontalLayout,FormLayout等。这些组件内部可以再放入其他的组件

  • Extend 所有已经创建的页面在此显示,用户可以直接将页面拖入当前设计页面中。该功能对于结构化设计页面比较有用。 例如:对于一个CRUD页面,用户可以将顶部的ToolBar设计为一个页面,然后拖入到其他页面中,保证所有页面样式的统一。

将另外页面拖入当前页面后,会将原来页面所有的“样式属性”信息带入新的页面,用户只能在新页面中定义原来页面的事件,数据源等信息

样式信息会每次在页面初始化的时候,从原有页面去读取,所以尽管将原有页面拖入到新的页面中,用户依然可以通过修改原有页面的样式属性, 在新页面中 进行体现。比如颜色,大小等。

  • Chart 设计器中提供基本的图形展示控件,如常用的柱状图,饼图,曲线图,区域图等,用户可以通过这些控件快速设计页面。

# 属性编辑

attribute

属性编辑分为如下五部分:

  • 基本样式
    针对组件所有的显示属性进行设定,如size,背景,padding(内边距),margin(外边距),显示文本,标题等等。

  • 数据源
    设定组件加载数据时所需要的数据源的相关设定,如表格加载数据时是来自于系统表,还是自定义表,还是通过SQL直接拿值等。 另外对于一些组件的备选项也在这里设定,如combo box,list box等组件下拉框里面的值也在可以在这里进行设定。

  • 事件
    针对各个组件支持的事件,来定义事件触发时应该激发的动作,如按钮的点击事件,页面的加载事件等。

  • parameter
    设置传参的参数(包含参数类型、参数对象、变量名称),当前页面引用由其他页面传过来的值。

    参数类型支持系统表、自定义表、以及常用的数据类型(Long、String、Boolean等)

attribute

  • GlobalEvent
    添加发布事件,且发布事件下可再添加要传参的参数,将当前页面的值传出去。

# 设计区

designerarea

设计区和组件大纲会联动,任何在组件大纲中做的操作,如上移,下移,删除等操作都会在设计区进行展现。

# 工具栏

toolbar

工具栏用于对当前编辑页面的各种操作以及显示状态信息,其按钮含义如下:

  • 保存 保存当前所做的编辑,一旦保存,不支持回退
  • 预览 对于保存后的页面,进行预览操作。预览将打开新的页面,以运行的状态来查看页面效果
  • 发布 将页面发布,可以允许系统的最终用户进行访问
  • Check Out 对于已经发布的页面,如果需要更改,那么需要将其首先Check out,然后进行修改。
  • Check In 对于Check Out的页面,如果要更改生效,让最终用户访问,那么需要执行Check In操作。

# 快捷键

用户可以通过鼠标点击选中某个组件,对于选中的组件,支持以下快捷键:

  • CTRL+C: 复制
  • CTRL_V: 粘贴
  • CTRL_S: 保存
  • DEL: 删除

也可以通过选中组件,鼠标右击选择对应的快捷方式。

“移出”代表将当前组件移到父级组件同一层级。

toolbar