3.6.1.1.1. 界面子框架
这是旧版本的 API。对于从 7.0 开始的新 API,请参阅 界面控制器。 |
子框架(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 一起提交。