弃用通知控件

Elementor 弃用通知控件在面板中显示一个预格式化的通知，警告该小部件已弃用并应被替换。

该控件在 Control_Deprecated_Notice 类中定义，该类继承自 Base_UI_Control 类。

使用此控件时，应将 type 设置为 \Elementor\Controls_Manager::DEPRECATED_NOTICE 常量。

参数

返回值

此控件不返回任何值。

用法

有两种方式可以为小部件添加弃用通知：

Using the Regular Add Control

Add a notice warning that the widget is deprecated using the regular add_control() method.

<?php
class Elementor_Test_Widget extends \Elementor\Widget_Base {

	protected function register_controls(): void {

		$this->start_controls_section(
			'content_section',
			[
				'label' => esc_html__( 'Content', 'textdomain' ),
				'tab' => \Elementor\Controls_Manager::TAB_CONTENT,
			]
		);

		$this->add_control(
			'deprecated_notice',
			[
				'type' => \Elementor\Controls_Manager::DEPRECATED_NOTICE,
				'widget' => 'your-old-widget',
				'since' => '3.10.0',
				'last' => '3.20.0',
				'plugin' => 'Your Great Plugin',
				'replacement' => 'your-new-widget',
				'content_classes' => 'your-class',
			]
		);

		// Register the rest of the controls as usual.

		$this->end_controls_section();

	}

}

Using a Deprecated Notice Method

Add a notice warning that the widget is deprecated using the deprecated_notice() method.

<?php
class Elementor_Test_Widget extends \Elementor\Widget_Base {

	protected function register_controls(): void {

		$this->start_controls_section(
			'content_section',
			[
				'label' => esc_html__( 'Content', 'textdomain' ),
				'tab' => \Elementor\Controls_Manager::TAB_CONTENT,
			]
		);

		$this->deprecated_notice(
			'Your Great Plugin',
			'3.10.0',
			'3.20.0',
			'your-new-widget'
		);

		// Register the rest of the controls as usual.

		$this->end_controls_section();

	}
}