动态标签分类

创建控件时，开发者可以定义控件是否接受动态数据。若控件接受动态数据，则必须设置数据类型（如文本值、颜色、图像）。而动态标签需要定义其向控件返回的数据类型。

这正是分类发挥作用之处。Elementor Pro 提供按数据类型排列的分类列表，动态标签通过这些分类向控件返回数据。

可用分类常量

Elementor Pro 提供以下预定义的动态标签分类常量：

::: warning 请注意 在旧版 Elementor 中，您可以将返回值定义为简单文本，如 url、number、text、media 等。随着 Elementor 的发展，它已将这些基于文本的值替换为预定义的大写常量。我们强烈建议您将旧的文本基值替换为新的分类常量。 :::

在动态标签上应用分类

创建新的动态标签时，您需要定义该标签将返回的数据类型。这通过 get_categories() 方法实现：

class Elementor_Test_Tag extends \Elementor\Core\DynamicTags\Tag {

	public function get_categories(): array {
		return [ \Elementor\Modules\DynamicTags\Module::TEXT_CATEGORY ];
	}

}

该方法返回一个数组，意味着动态标签可以向控件返回多种数据类型：

class Elementor_Test_Tag extends \Elementor\Core\DynamicTags\Tag {

	public function get_categories(): array {
		return [
			\Elementor\Modules\DynamicTags\Module::URL_CATEGORY,
			\Elementor\Modules\DynamicTags\Module::TEXT_CATEGORY,
			\Elementor\Modules\DynamicTags\Module::NUMBER_CATEGORY
		];
	}

}

在控件中使用动态分类

另一方面，当您创建控件时，需要通过 get_default_settings() 方法在定义控件设置时支持动态标签，并选择要显示的分类：

class Elementor_Test_Control extends \Elementor\Base_Control {

	public function get_type(): string {}

	public function content_template(): void {}

	protected function get_default_settings(): array {

		return [
			'show_label' => true,
			'label_block' => true,
			'separator' => 'after',
			'dynamic' => [
				'active' => true,
				'categories' => [
					\Elementor\Modules\DynamicTags\Module::TEXT_CATEGORY,
					\Elementor\Modules\DynamicTags\Module::NUMBER_CATEGORY
				],
			],
		];

	}

}