尺寸控制

Elementor 尺寸控制显示上、右、下、左的输入字段，并提供将它们链接在一起的选项。该控件可选择包含多种单位类型 (size_units) 供用户选择。它还接受 range 参数，允许您为每种单位类型设置 min、max 和 step 值。

该控件在继承 Control_Base_Units 类的 Control_Dimensions 类中定义。

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

参数

返回值

[
	'top' => '',
	'right' => '',
	'bottom' => '',
	'left' => '',
	'unit' => '',
	'isLinked' => '',
]

(array) 包含尺寸值的数组：

• $top (int) 顶部尺寸。
• $right (int) 右侧尺寸。
• $bottom (int) 底部尺寸。
• $left (int) 左侧尺寸。
• $unit (string) CSS 单位类型。
• $isLinked (bool) 是否将所有值链接在一起。

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(
			'margin',
			[
				'label' => esc_html__( 'Margin', 'textdomain' ),
				'type' => \Elementor\Controls_Manager::DIMENSIONS,
				'size_units' => [ 'px', '%', 'em', 'rem', 'custom' ],
				'default' => [
					'top' => 2,
					'right' => 0,
					'bottom' => 2,
					'left' => 0,
					'unit' => 'em',
					'isLinked' => false,
				],
				'selectors' => [
					'{{WRAPPER}} .your-class' => 'margin: {{TOP}}{{UNIT}} {{RIGHT}}{{UNIT}} {{BOTTOM}}{{UNIT}} {{LEFT}}{{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
	}

}