滑块控件
Elementor 滑块控件显示一个可拖动的范围滑块。该控件可选择性地包含多种单位类型 (size_units) 供用户选择。控件还接受一个 range 参数,允许您为每种单位类型设置 min、max 和 step 值。
此控件在继承 Control_Base_Units 类的 Control_Slider 类中定义。
使用此控件时,应将 type 设置为 \Elementor\Controls_Manager::SLIDER 常量。
参数
| 名称 | 类型 | 默认值 | 描述 |
|---|---|---|---|
type |
string |
slider | 控件的类型。 |
label |
string |
显示在字段上方的标签。 | |
description |
string |
显示在字段下方的描述。 | |
show_label |
bool |
true | 是否显示标签。 |
label_block |
bool |
true | 是否在单独一行显示标签。 |
separator |
string |
default | 设置控件分隔符的位置。可用值为 default、before 和 after。default 将隐藏分隔符,除非控件类型有特定的分隔符设置。before / after 会将分隔符定位在控件之前/之后。 |
size_units |
array |
[ 'px' ] | 可用 CSS 单位的数组,例如 px、em、rem、%、deg、vh 或 custom。 |
range |
array |
每个注册尺寸的范围数组。
|
|
default |
array |
滑块默认值。
|
返回值
[
'unit' => '',
'size' => '',
]
(array) 一个包含尺寸值的数组:
- $unit (
string) 选定的单位。 - $size (
int) 选定的尺寸。
用法
<?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(
'width',
[
'label' => esc_html__( 'Width', 'textdomain' ),
'type' => \Elementor\Controls_Manager::SLIDER,
'size_units' => [ 'px', '%', 'em', 'rem', 'custom' ],
'range' => [
'px' => [
'min' => 0,
'max' => 1000,
'step' => 5,
],
'%' => [
'min' => 0,
'max' => 100,
],
],
'default' => [
'unit' => '%',
'size' => 50,
],
'selectors' => [
'{{WRAPPER}} .your-class' => 'width: {{SIZE}}{{UNIT}};',
],
]
);
$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
}
}
这篇文档对你有帮助吗?
谢谢你的反馈!