title: "按钮控件" post_status: publish comment_status: open taxonomy: category: - elementor-developers-docs post_tag: - Editor Controls - Src - Repos
按钮控件
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 {14-24}
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(); } } ``` ?>