选择控件
Elementor 选择控件显示一个简单的下拉选择框。它接受一个数组,其中 key 是选项的 value,而值则是选项名称。
该控件定义在继承 Base_Data_Control 类的 Control_Select 类中。
使用此控件时,应将 type 设置为 \Elementor\Controls_Manager::SELECT 常量。
参数
| 名称 | 类型 | 默认值 | 描述 |
|---|---|---|---|
type |
string |
select | 控件的类型。 |
label |
string |
显示在字段上方的标签。 | |
description |
string |
显示在字段下方的描述。 | |
show_label |
bool |
true | 是否显示标签。 |
label_block |
bool |
false | 是否在单独一行显示标签。 |
separator |
string |
default | 设置控件分隔符的位置。可用值为 default、before 和 after。default 将隐藏分隔符,除非控件类型有特定的分隔符设置。before / after 将分隔符定位在控件之前/之后。 |
options |
array |
一个 键 => 值 对的数组:[ '键' => '值', ... ] |
|
groups |
array |
分组选项的数组。 | |
default |
string |
字段的默认值。 |
Return Value
(string) The selected option 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(
'border_style',
[
'label' => esc_html__( 'Border Style', 'textdomain' ),
'type' => \Elementor\Controls_Manager::SELECT,
'default' => 'solid',
'options' => [
'' => esc_html__( 'Default', 'textdomain' ),
'none' => esc_html__( 'None', 'textdomain' ),
'solid' => esc_html__( 'Solid', 'textdomain' ),
'dashed' => esc_html__( 'Dashed', 'textdomain' ),
'dotted' => esc_html__( 'Dotted', 'textdomain' ),
'double' => esc_html__( 'Double', 'textdomain' ),
],
'selectors' => [
'{{WRAPPER}} .your-class' => 'border-style: {{VALUE}};',
],
]
);
$this->add_control(
'custom_animation',
[
'label' => esc_html__( 'Animation', 'textdomain' ),
'type' => Controls_Manager::SELECT,
'groups' => [
[
'label' => esc_html__( 'None', 'textdomain' ),
'options' => [
'' => esc_html__( 'None', 'textdomain' ),
],
],
[
'label' => esc_html__( 'Slide', 'textdomain' ),
'options' => [
'slide-from-right' => esc_html__( 'Slide In Right', 'textdomain' ),
'slide-from-left' => esc_html__( 'Slide In Left', 'textdomain' ),
'slide-from-top' => esc_html__( 'Slide In Up', 'textdomain' ),
'slide-from-bottom' => esc_html__( 'Slide In Down', 'textdomain' ),
],
],
[
'label' => esc_html__( 'Zoom', 'textdomain' ),
'options' => [
'grow' => esc_html__( 'Grow', 'textdomain' ),
'shrink' => esc_html__( 'Shrink', 'textdomain' ),
'zoom-in' => esc_html__( 'Zoom In', 'textdomain' ),
'zoom-out' => esc_html__( 'Zoom Out', 'textdomain' ),
],
],
],
'prefix_class' => 'custom-animation-',
]
);
$this->end_controls_section();
}
protected function render(): void {
$settings = $this->get_settings_for_display();
?>
<div class="your-class">
...
</div>
<?php
}
protected function content_template(): void {
?>
<div class="your-class">
...
</div>
<?php
}
}
这篇文档对你有帮助吗?
谢谢你的反馈!