Skip to content

Color Control

Elementor Core BasicColor Control

Elementor color control displays a color picker field with an alpha slider. It includes a customizable color palette that can be preset by the user.

The control is defined in Control_Color class which extends Base_Data_Control class.

When using this control, the type should be set to \Elementor\Controls_Manager::COLOR constant.

Arguments

NameTypeDefaultDescription
typestringcolorThe type of the control.
labelstringThe label that appears above of the field.
descriptionstringThe description that appears below the field.
show_labelbooltrueWhether to display the label.
label_blockboolfalseWhether to display the label in a separate line.
separatorstringdefaultSet 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.
alphabooltrueWhether to allow alpha channel.
defaultstringDefault color in RGB, RGBA, or HEX format.

Return Value

(string) The color value in RGB, RGBA, or HEX format.

Usage

php
<?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(
			'text_color',
			[
				'label' => esc_html__( 'Text Color', 'textdomain' ),
				'type' => \Elementor\Controls_Manager::COLOR,
				'selectors' => [
					'{{WRAPPER}} .your-class' => 'color: {{VALUE}}',
				],
			]
		);

		$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
	}

}

Notes

Learn how to use Global Colors, set in the Site Settings panel, on your color controls.