# Select Control
Elementor Core BasicElementor select control displays a simple select box field. It accepts an array in which the key
is the option value
and the value is the option name.
The control is defined in Control_Select
class which extends Base_Data_Control
class.
When using this control, the type
should be set to \Elementor\Controls_Manager::SELECT
constant.
# Arguments
Name | Type | Default | Description |
---|---|---|---|
type | string | select | The type of the control. |
label | string | The label that appears above of the field. | |
description | string | The description that appears below the field. | |
show_label | bool | true | Whether to display the label. |
label_block | bool | false | Whether to display the label in a separate line. |
separator | string | default | Set the position of the control separator. Available values are default , before and after . default will hide the separator, unless the control type has specific separator settings. before / after will position the separator before/after the control. |
options | array | An array of key => value pairs: [ 'key' => 'value', ... ] | |
default | string | The field default value. |
# Return Value
(string
) The selected option value.
# Usage
<?php
class Elementor_Test_Widget extends \Elementor\Widget_Base {
protected function register_controls() {
$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->end_controls_section();
}
protected function render() {
$settings = $this->get_settings_for_display();
?>
<div class="your-class">
...
</div>
<?php
}
protected function content_template() {
?>
<div class="your-class">
...
</div>
<?php
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55