3.6.1.1.1. 界面子框架

子框架（Frame）是可重用的界面。界面子框架通过 frame XML 元素添加在别的界面中。

子框架的控制器必须扩展 AbstractFrame 类。



在 Studio 里面可以使用 Blank frame 模板创建界面框架。

以下是一些界面框架和框架内包含的其它界面交互的规则：

  • 框架内的界面组件可以通过“.”来获得引用：frame_id.component_id。

  • 框架内的界面组件也可以在控制器中通过调用 getComponent(component_id) 方法获得，但是这个方法只有在框架内没有相同 id 的组件才能用。比如，frame 内的组件名称会覆盖界面的组件名称。

  • 界面的数据源可以在子界面框架内访问，有三种途径：通过调用 getDsContext().get(ds_id) 方法获得、通过依赖注入获得、通过数据源查询中的 ds$ds_id 获得。但是只有在子框架没有声明同名的数据源情况下才能取到（跟组件的情况类似）。

  • 从界面上想要获取子框架的数据源，只能通过遍历 getDsContext().getChildren() 集合的方法得到。

界面的提交会促使界面内所有子框架内有更改的 datasource 一起提交。