操作

Action 接口是对可视化组件内部的一个操作(或者说,某些功能)的抽象。当同一个操作可以由不同的可视化组件调用时(例如,通过按钮和表格的右键菜单调用),这个接口非常有用。Action 也可以用于定义一些通用的配置,例如,标题、快捷键、可访问性(a11y)和可见性(visibility)的标签等。

可以在视图的 XML 中声明式创建操作,或通过继承 BaseAction 类编程式创建。另外,对于视图、列表和选取组件,框架也提供了一组标准的操作。

关联操作的可视化组件分为两类:

  • 带有单一操作的可视化组件,实现了 HasAction 接口。例如,button 按钮

    通过调用 HasAction.setAction() 方法将操作与组件关联。

  • 带有多个操作的可视化组件,实现了 HasActions 接口。例如,dataGrid 数据网格entityComboBox 实体下拉框entityPicker 实体选择器

    使用 HasActions.addAction() 方法为组件添加操作。组件内实现的该方法会先检查是否已经存在相同标识符的操作。如果已存在,会用新的操作替换已存在的。因此,可以先在视图的 XML 中定义一个标准的操作,然后在控制器代码中编程式创建一个不同配置的新操作,然后设置给组件,替换掉 XML 中声明的标准操作。

  • 视图本身也可以包含操作。可以在 XML 的顶级元素 <actions> 定义,或者使用视图类的 getViewActions.addAction() 方法编程式添加。