跳到主要内容

Composite Components

在ChatGPT中打开
23.06
Java API

开发人员通常希望创建包含组成组件的组件，以供应用程序级别使用。Composite 组件为开发人员提供创建自己的组件所需的工具，同时控制他们选择向用户公开的内容。

它允许开发人员管理特定类型的 Component 实例，提供一种封装其行为的方法。它要求任何扩展的子类指定它打算管理的 Component 类型，从而确保 Composite 的子类与其底层 Component 本质上是相链接的。

提示

强烈建议通过利用 Composite 组件来创建自定义组件，而不是扩展基础的 Component 组件。

要使用 Composite 组件，请首先创建一个新的 Java 类，扩展 Composite 组件。将要管理的 Component 类型指定为泛型类型参数。

public class ApplicationComponent extends Composite<Div> {
	//实现
}

组件绑定​

Composite 类要求开发人员指定它管理的 Component 类型。这种强关联确保 Composite 组件本质上与其底层组件链接。这也提供了相比传统继承的好处，因为它允许开发人员精确决定公开给公共 API 的功能。

默认情况下，Composite 组件利用其子类的泛型类型参数来识别和实例化绑定的组件类型。这是基于组件类具有无参数构造函数的假设。开发人员可以通过重写 initBoundComponent() 方法自定义组件初始化过程。这为创建和管理绑定组件提供了更大的灵活性，包括调用带参数的构造函数。

以下代码片段重写了 initBoundComponent 方法，以使用 FlexLayout 类的带参数构造函数：

public class OverrideComposite extends Composite<FlexLayout> {
	
	TextField nameField;
	Button submit;

	@Override
	protected FlexLayout initBoundComponent() {
		nameField = new TextField();
		submit = new Button("Submit");
		return new FlexLayout(nameField, submit);
	}
}

生命周期管理​

与 Component 不同，开发人员在使用 Composite 组件时不需要实现 onCreate() 和 onDestroy() 方法。Composite 组件为您处理这些方面。

如果您需要在其生命周期各个阶段访问绑定组件，onDidCreate() 和 onDidDestroy() 钩子允许开发人员访问这些生命周期阶段以执行额外功能。利用这些钩子是可选的。

onDidCreate() 方法在绑定组件被创建并添加到窗口后立即调用。使用此方法设置组件、修改所需的任何配置，并在适用时添加子组件。虽然 Component 类的 onCreate() 方法接受一个 Window 实例，但 onDidCreate() 方法则接受绑定组件，从而去除了直接调用 getBoundComponent() 方法的需要。例如：

public class ApplicationComponent extends Composite<Div> {
	@Override
	protected void onDidCreate(Div container) {
		// 向容器添加子组件
		container.add(new CheckBox());
		container.add(new Paragraph());
		// ...
	}
}
提示

此逻辑也可以在构造函数中实现，通过调用 getBoundComponent()。

类似地，onDidDestroy() 方法在绑定组件被销毁后触发，并允许在销毁时执行其他行为（如有需要）。

示例 Composite 组件​

在以下示例中，创建了一个简单的待办事项应用程序，列表中添加的每个项目都是一个 Composite 组件，由一个样式为开关的 RadioButton 和一个带文本的 Div 组成。

此组件的逻辑在构造函数中设置，设置样式并使用 getBoundComponent 方法将组成组件添加到绑定组件，并添加事件逻辑。

提示

这也可以在 onDidCreate() 方法中实现，这将直接访问绑定的 FlexLayout 组件。

然后在应用程序中实例化并使用此组件，使其可以在多个位置使用，使其成为创建自定义组件的强大工具。

显示代码