Text Control

Elementor text control displays a simple text input field.

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

Note that when using the control, the type should be set using the \Elementor\Controls_Manager::TEXT constant.

Arguments

Name Type Default Description
type string text 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, after and none. default will position the separator depending on the control type. before / after will position the separator before/after the control. none will hide the separator.
input_type string text The input field type. Available values are all HTML5 supported types.
placeholder string The field placeholder that appears when the field has no values.
title string The field title that appears on mouse hover.
classes string Add custom classes to control wrapper in the panel.
default string The field default value.

Return Value

(string) The text field value.

Usage

<?php
class Elementor_Test_Widget extends \Elementor\Widget_Base {

	protected function _register_controls() {

		$this->start_controls_section(
			'content_section',
			[
				'label' => __( 'Content', 'plugin-name' ),
				'tab' => \Elementor\Controls_Manager::TAB_CONTENT,
			]
		);

		$this->add_control(
			'widget_title',
			[
				'label' => __( 'Title', 'plugin-domain' ),
				'type' => \Elementor\Controls_Manager::TEXT,
				'default' => __( 'Default title', 'plugin-domain' ),
				'placeholder' => __( 'Type your title here', 'plugin-domain' ),
			]
		);

		$this->end_controls_section();

	}

	protected function render() {
		$settings = $this->get_settings_for_display();
		echo '<h2>' . $settings['widget_title'] . '</h2>';
	}

	protected function _content_template() {
		?>
		<h2>{{{ settings.widget_title }}}</h2>
		<?php
	}


}