按钮控件

---

• 参数
• Return Value
• Usage

---

Elementor 按钮控件可在面板中显示一个能够触发事件的按钮。

该控件定义在继承 Base_UI_Control 类的 Control_Button 类中。

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

参数

名称	类型	默认值	描述
type	string	button	控件的类型。
label	string		显示在字段上方的标签。
description	string		显示在字段下方的描述。
show_label	bool	true	是否显示标签。
label_block	bool	false	是否在单独一行显示标签。
separator	string	default	设置控件分隔符的位置。可用值为 default、before 和 after。default 将隐藏分隔符，除非控件类型有特定的分隔符设置。before / after 会将分隔符定位在控件之前/之后。
text	string		按钮文本。
button_type	string	default	按钮类型。可用值为 default、info、success、warning 和 danger。
event	string		按钮将触发的事件。该事件将通过 elementor.channels.editor.on( event ) 触发。

Return Value

This control does not return any value.

Usage

<?php
class Elementor_Test_Widget extends \Elementor\Widget_Base {

	protected function register_controls(): void {

		$this->start_controls_section(
			'style_section',
			[
				'label' => esc_html__( 'Style', 'textdomain' ),
				'tab' => \Elementor\Controls_Manager::TAB_STYLE,
			]
		);

		$this->add_control(
			'delete_content',
			[
				'label' => esc_html__( 'Delete Content', 'textdomain' ),
				'type' => \Elementor\Controls_Manager::BUTTON,
				'separator' => 'before',
				'button_type' => 'success',
				'text' => esc_html__( 'Delete', 'textdomain' ),
				'event' => 'namespace:editor:delete',
			]
		);

		$this->end_controls_section();

	}

}