elementor / includes / elements / column.php

column.php in Elementor Website Builder – more than just a page builder 3.19.0-dev3, at includes/elements/column.php

1,069 lines 26.8 KB

Raw Download Zip

1	<?php
2	namespace Elementor;
3
4	use Elementor\Core\Breakpoints\Manager as Breakpoints_Manager;
5
6	if ( ! defined( 'ABSPATH' ) ) {
7	exit; // Exit if accessed directly.
8	}
9
10	/**
11	* Elementor column element.
12	*
13	* Elementor column handler class is responsible for initializing the column
14	* element.
15	*
16	* @since 1.0.0
17	*/
18	class Element_Column extends Element_Base {
19
20	/**
21	* Get column name.
22	*
23	* Retrieve the column name.
24	*
25	* @since 1.0.0
26	* @access public
27	*
28	* @return string Column name.
29	*/
30	public function get_name() {
31	return 'column';
32	}
33
34	/**
35	* Get element type.
36	*
37	* Retrieve the element type, in this case `column`.
38	*
39	* @since 2.1.0
40	* @access public
41	* @static
42	*
43	* @return string The type.
44	*/
45	public static function get_type() {
46	return 'column';
47	}
48
49	/**
50	* Get column title.
51	*
52	* Retrieve the column title.
53	*
54	* @since 1.0.0
55	* @access public
56	*
57	* @return string Column title.
58	*/
59	public function get_title() {
60	return esc_html__( 'Column', 'elementor' );
61	}
62
63	/**
64	* Get column icon.
65	*
66	* Retrieve the column icon.
67	*
68	* @since 1.0.0
69	* @access public
70	*
71	* @return string Column icon.
72	*/
73	public function get_icon() {
74	return 'eicon-column';
75	}
76
77	/**
78	* Get initial config.
79	*
80	* Retrieve the current section initial configuration.
81	*
82	* Adds more configuration on top of the controls list, the tabs assigned to
83	* the control, element name, type, icon and more. This method also adds
84	* section presets.
85	*
86	* @since 2.9.0
87	* @access protected
88	*
89	* @return array The initial config.
90	*/
91	protected function get_initial_config() {
92	$config = parent::get_initial_config();
93
94	$config['controls'] = $this->get_controls();
95	$config['tabs_controls'] = $this->get_tabs_controls();
96
97	return $config;
98	}
99
100	/**
101	* Register column controls.
102	*
103	* Used to add new controls to the column element.
104	*
105	* @since 3.1.0
106	* @access protected
107	*/
108	protected function register_controls() {
109	// Section Layout.
110	$this->start_controls_section(
111	'layout',
112	[
113	'label' => esc_html__( 'Layout', 'elementor' ),
114	'tab' => Controls_Manager::TAB_LAYOUT,
115	]
116	);
117
118	// Element Name for the Navigator
119	$this->add_control(
120	'_title',
121	[
122	'label' => esc_html__( 'Title', 'elementor' ),
123	'type' => Controls_Manager::HIDDEN,
124	'render_type' => 'none',
125	]
126	);
127
128	$active_breakpoint_keys = array_reverse( array_keys( Plugin::$instance->breakpoints->get_active_breakpoints() ) );
129	$inline_size_device_args = [
130	Breakpoints_Manager::BREAKPOINT_KEY_MOBILE => [ 'placeholder' => 100 ],
131	];
132
133	foreach ( $active_breakpoint_keys as $breakpoint_key ) {
134	if ( ! isset( $inline_size_device_args[ $breakpoint_key ] ) ) {
135	$inline_size_device_args[ $breakpoint_key ] = [];
136	}
137
138	$inline_size_device_args[ $breakpoint_key ] = array_merge_recursive(
139	$inline_size_device_args[ $breakpoint_key ],
140	[
141	'max' => 100,
142	'required' => false,
143	]
144	);
145	}
146
147	if ( in_array( Breakpoints_Manager::BREAKPOINT_KEY_MOBILE_EXTRA, $active_breakpoint_keys, true ) ) {
148	$min_affected_device_value = Breakpoints_Manager::BREAKPOINT_KEY_MOBILE_EXTRA;
149	} else {
150	$min_affected_device_value = Breakpoints_Manager::BREAKPOINT_KEY_TABLET;
151	}
152
153	$this->add_responsive_control(
154	'_inline_size',
155	[
156	'label' => esc_html__( 'Column Width', 'elementor' ) . ' (%)',
157	'type' => Controls_Manager::NUMBER,
158	'min' => 2,
159	'max' => 98,
160	'required' => true,
161	'device_args' => $inline_size_device_args,
162	'min_affected_device' => [
163	Breakpoints_Manager::BREAKPOINT_KEY_DESKTOP => $min_affected_device_value,
164	Breakpoints_Manager::BREAKPOINT_KEY_LAPTOP => $min_affected_device_value,
165	Breakpoints_Manager::BREAKPOINT_KEY_TABLET_EXTRA => $min_affected_device_value,
166	Breakpoints_Manager::BREAKPOINT_KEY_TABLET => $min_affected_device_value,
167	Breakpoints_Manager::BREAKPOINT_KEY_MOBILE_EXTRA => $min_affected_device_value,
168	],
169	'selectors' => [
170	'{{WRAPPER}}' => 'width: {{VALUE}}%',
171	],
172	]
173	);
174
175	$this->add_responsive_control(
176	'content_position',
177	[
178	'label' => esc_html__( 'Vertical Alignment', 'elementor' ),
179	'type' => Controls_Manager::SELECT,
180	'default' => '',
181	'options' => [
182	'' => esc_html__( 'Default', 'elementor' ),
183	'top' => esc_html__( 'Top', 'elementor' ),
184	'center' => esc_html__( 'Middle', 'elementor' ),
185	'bottom' => esc_html__( 'Bottom', 'elementor' ),
186	'space-between' => esc_html__( 'Space Between', 'elementor' ),
187	'space-around' => esc_html__( 'Space Around', 'elementor' ),
188	'space-evenly' => esc_html__( 'Space Evenly', 'elementor' ),
189	],
190	'selectors_dictionary' => [
191	'top' => 'flex-start',
192	'bottom' => 'flex-end',
193	],
194	'selectors' => [
195	// TODO: The following line is for BC since 2.7.0
196	'.elementor-bc-flex-widget {{WRAPPER}}.elementor-column .elementor-widget-wrap' => 'align-items: {{VALUE}}',
197	// This specificity is intended to make sure column css overwrites section css on vertical alignment (content_position)
198	'{{WRAPPER}}.elementor-column.elementor-element[data-element_type="column"] > .elementor-widget-wrap.elementor-element-populated' => 'align-content: {{VALUE}}; align-items: {{VALUE}};',
199	],
200	]
201	);
202
203	$this->add_responsive_control(
204	'align',
205	[
206	'label' => esc_html__( 'Horizontal Alignment', 'elementor' ),
207	'type' => Controls_Manager::SELECT,
208	'default' => '',
209	'options' => [
210	'' => esc_html__( 'Default', 'elementor' ),
211	'flex-start' => esc_html__( 'Start', 'elementor' ),
212	'center' => esc_html__( 'Center', 'elementor' ),
213	'flex-end' => esc_html__( 'End', 'elementor' ),
214	'space-between' => esc_html__( 'Space Between', 'elementor' ),
215	'space-around' => esc_html__( 'Space Around', 'elementor' ),
216	'space-evenly' => esc_html__( 'Space Evenly', 'elementor' ),
217	],
218	'selectors' => [
219	'{{WRAPPER}}.elementor-column > .elementor-widget-wrap' => 'justify-content: {{VALUE}}',
220	],
221	]
222	);
223
224	$this->add_responsive_control(
225	'space_between_widgets',
226	[
227	'label' => esc_html__( 'Widgets Space', 'elementor' ) . ' (px)',
228	'type' => Controls_Manager::NUMBER,
229	'placeholder' => 20,
230	'selectors' => [
231	'{{WRAPPER}} > .elementor-widget-wrap > .elementor-widget:not(.elementor-widget__width-auto):not(.elementor-widget__width-initial):not(:last-child):not(.elementor-absolute)' => 'margin-bottom: {{VALUE}}px', //Need the full path for exclude the inner section
232	],
233	]
234	);
235
236	$possible_tags = [
237	'div',
238	'header',
239	'footer',
240	'main',
241	'article',
242	'section',
243	'aside',
244	'nav',
245	];
246
247	$options = [
248	'' => esc_html__( 'Default', 'elementor' ),
249	] + array_combine( $possible_tags, $possible_tags );
250
251	$this->add_control(
252	'html_tag',
253	[
254	'label' => esc_html__( 'HTML Tag', 'elementor' ),
255	'type' => Controls_Manager::SELECT,
256	'options' => $options,
257	'render_type' => 'none',
258	]
259	);
260
261	$this->end_controls_section();
262
263	$this->start_controls_section(
264	'section_style',
265	[
266	'label' => esc_html__( 'Background', 'elementor' ),
267	'tab' => Controls_Manager::TAB_STYLE,
268	]
269	);
270
271	$this->start_controls_tabs( 'tabs_background' );
272
273	$this->start_controls_tab(
274	'tab_background_normal',
275	[
276	'label' => esc_html__( 'Normal', 'elementor' ),
277	]
278	);
279
280	$this->add_group_control(
281	Group_Control_Background::get_type(),
282	[
283	'name' => 'background',
284	'types' => [ 'classic', 'gradient', 'slideshow' ],
285	'selector' => '{{WRAPPER}}:not(.elementor-motion-effects-element-type-background) > .elementor-widget-wrap, {{WRAPPER}} > .elementor-widget-wrap > .elementor-motion-effects-container > .elementor-motion-effects-layer',
286	'fields_options' => [
287	'background' => [
288	'frontend_available' => true,
289	],
290	'image' => [
291	'background_lazyload' => [
292	'active' => true,
293	'keys' => [ 'background_image', 'url' ],
294	'selector' => '.elementor-element-populated',
295	],
296	],
297	],
298	]
299	);
300
301	$this->end_controls_tab();
302
303	$this->start_controls_tab(
304	'tab_background_hover',
305	[
306	'label' => esc_html__( 'Hover', 'elementor' ),
307	]
308	);
309
310	$this->add_group_control(
311	Group_Control_Background::get_type(),
312	[
313	'name' => 'background_hover',
314	'selector' => '{{WRAPPER}}:hover > .elementor-element-populated',
315	]
316	);
317
318	$this->add_control(
319	'background_hover_transition',
320	[
321	'label' => esc_html__( 'Transition Duration', 'elementor' ) . ' (s)',
322	'type' => Controls_Manager::SLIDER,
323	'default' => [
324	'size' => 0.3,
325	],
326	'range' => [
327	'px' => [
328	'min' => 0,
329	'max' => 3,
330	'step' => 0.1,
331	],
332	],
333	'render_type' => 'ui',
334	'separator' => 'before',
335	]
336	);
337
338	$this->end_controls_tab();
339
340	$this->end_controls_tabs();
341
342	$this->end_controls_section();
343
344	// Section Column Background Overlay.
345	$this->start_controls_section(
346	'section_background_overlay',
347	[
348	'label' => esc_html__( 'Background Overlay', 'elementor' ),
349	'tab' => Controls_Manager::TAB_STYLE,
350	'condition' => [
351	'background_background' => [ 'classic', 'gradient' ],
352	],
353	]
354	);
355
356	$this->start_controls_tabs( 'tabs_background_overlay' );
357
358	$this->start_controls_tab(
359	'tab_background_overlay_normal',
360	[
361	'label' => esc_html__( 'Normal', 'elementor' ),
362	]
363	);
364
365	$this->add_group_control(
366	Group_Control_Background::get_type(),
367	[
368	'name' => 'background_overlay',
369	'selector' => '{{WRAPPER}} > .elementor-element-populated > .elementor-background-overlay',
370	'fields_options' => [
371	'image' => [
372	'background_lazyload' => [
373	'active' => true,
374	'keys' => [ '_background_overlay', 'url' ],
375	'selector' => '.elementor-background-overlay,',
376	],
377	],
378	],
379	]
380	);
381
382	$this->add_responsive_control(
383	'background_overlay_opacity',
384	[
385	'label' => esc_html__( 'Opacity', 'elementor' ),
386	'type' => Controls_Manager::SLIDER,
387	'default' => [
388	'size' => .5,
389	],
390	'range' => [
391	'px' => [
392	'max' => 1,
393	'step' => 0.01,
394	],
395	],
396	'selectors' => [
397	'{{WRAPPER}} > .elementor-element-populated > .elementor-background-overlay' => 'opacity: {{SIZE}};',
398	],
399	'condition' => [
400	'background_overlay_background' => [ 'classic', 'gradient' ],
401	],
402	]
403	);
404
405	$this->add_group_control(
406	Group_Control_Css_Filter::get_type(),
407	[
408	'name' => 'css_filters',
409	'selector' => '{{WRAPPER}} > .elementor-element-populated > .elementor-background-overlay',
410	]
411	);
412
413	$this->add_control(
414	'overlay_blend_mode',
415	[
416	'label' => esc_html__( 'Blend Mode', 'elementor' ),
417	'type' => Controls_Manager::SELECT,
418	'options' => [
419	'' => esc_html__( 'Normal', 'elementor' ),
420	'multiply' => esc_html__( 'Multiply', 'elementor' ),
421	'screen' => esc_html__( 'Screen', 'elementor' ),
422	'overlay' => esc_html__( 'Overlay', 'elementor' ),
423	'darken' => esc_html__( 'Darken', 'elementor' ),
424	'lighten' => esc_html__( 'Lighten', 'elementor' ),
425	'color-dodge' => esc_html__( 'Color Dodge', 'elementor' ),
426	'saturation' => esc_html__( 'Saturation', 'elementor' ),
427	'color' => esc_html__( 'Color', 'elementor' ),
428	'difference' => esc_html__( 'Difference', 'elementor' ),
429	'exclusion' => esc_html__( 'Exclusion', 'elementor' ),
430	'hue' => esc_html__( 'Hue', 'elementor' ),
431	'luminosity' => esc_html__( 'Luminosity', 'elementor' ),
432	],
433	'selectors' => [
434	'{{WRAPPER}} > .elementor-element-populated > .elementor-background-overlay' => 'mix-blend-mode: {{VALUE}}',
435	],
436	]
437	);
438
439	$this->end_controls_tab();
440
441	$this->start_controls_tab(
442	'tab_background_overlay_hover',
443	[
444	'label' => esc_html__( 'Hover', 'elementor' ),
445	]
446	);
447
448	$this->add_group_control(
449	Group_Control_Background::get_type(),
450	[
451	'name' => 'background_overlay_hover',
452	'selector' => '{{WRAPPER}}:hover > .elementor-element-populated > .elementor-background-overlay',
453	]
454	);
455
456	$this->add_responsive_control(
457	'background_overlay_hover_opacity',
458	[
459	'label' => esc_html__( 'Opacity', 'elementor' ),
460	'type' => Controls_Manager::SLIDER,
461	'default' => [
462	'size' => .5,
463	],
464	'range' => [
465	'px' => [
466	'max' => 1,
467	'step' => 0.01,
468	],
469	],
470	'selectors' => [
471	'{{WRAPPER}}:hover > .elementor-element-populated > .elementor-background-overlay' => 'opacity: {{SIZE}};',
472	],
473	'condition' => [
474	'background_overlay_hover_background' => [ 'classic', 'gradient' ],
475	],
476	]
477	);
478
479	$this->add_group_control(
480	Group_Control_Css_Filter::get_type(),
481	[
482	'name' => 'css_filters_hover',
483	'selector' => '{{WRAPPER}}:hover > .elementor-element-populated > .elementor-background-overlay',
484	]
485	);
486
487	$this->add_control(
488	'background_overlay_hover_transition',
489	[
490	'label' => esc_html__( 'Transition Duration', 'elementor' ) . ' (s)',
491	'type' => Controls_Manager::SLIDER,
492	'default' => [
493	'size' => 0.3,
494	],
495	'range' => [
496	'px' => [
497	'min' => 0,
498	'max' => 3,
499	'step' => 0.1,
500	],
501	],
502	'render_type' => 'ui',
503	'separator' => 'before',
504	]
505	);
506
507	$this->end_controls_tab();
508
509	$this->end_controls_tabs();
510
511	$this->end_controls_section();
512
513	$this->start_controls_section(
514	'section_border',
515	[
516	'label' => esc_html__( 'Border', 'elementor' ),
517	'tab' => Controls_Manager::TAB_STYLE,
518	]
519	);
520
521	$this->start_controls_tabs( 'tabs_border' );
522
523	$this->start_controls_tab(
524	'tab_border_normal',
525	[
526	'label' => esc_html__( 'Normal', 'elementor' ),
527	]
528	);
529
530	$this->add_group_control(
531	Group_Control_Border::get_type(),
532	[
533	'name' => 'border',
534	'selector' => '{{WRAPPER}} > .elementor-element-populated',
535	]
536	);
537
538	$this->add_responsive_control(
539	'border_radius',
540	[
541	'label' => esc_html__( 'Border Radius', 'elementor' ),
542	'type' => Controls_Manager::DIMENSIONS,
543	'size_units' => [ 'px', '%', 'em', 'rem', 'custom' ],
544	'selectors' => [
545	'{{WRAPPER}} > .elementor-element-populated, {{WRAPPER}} > .elementor-element-populated > .elementor-background-overlay, {{WRAPPER}} > .elementor-background-slideshow' => 'border-radius: {{TOP}}{{UNIT}} {{RIGHT}}{{UNIT}} {{BOTTOM}}{{UNIT}} {{LEFT}}{{UNIT}};',
546	],
547	]
548	);
549
550	$this->add_group_control(
551	Group_Control_Box_Shadow::get_type(),
552	[
553	'name' => 'box_shadow',
554	'selector' => '{{WRAPPER}} > .elementor-element-populated',
555	]
556	);
557
558	$this->end_controls_tab();
559
560	$this->start_controls_tab(
561	'tab_border_hover',
562	[
563	'label' => esc_html__( 'Hover', 'elementor' ),
564	]
565	);
566
567	$this->add_group_control(
568	Group_Control_Border::get_type(),
569	[
570	'name' => 'border_hover',
571	'selector' => '{{WRAPPER}}:hover > .elementor-element-populated',
572	]
573	);
574
575	$this->add_responsive_control(
576	'border_radius_hover',
577	[
578	'label' => esc_html__( 'Border Radius', 'elementor' ),
579	'type' => Controls_Manager::DIMENSIONS,
580	'size_units' => [ 'px', '%', 'em', 'rem', 'custom' ],
581	'selectors' => [
582	'{{WRAPPER}}:hover > .elementor-element-populated, {{WRAPPER}}:hover > .elementor-element-populated > .elementor-background-overlay' => 'border-radius: {{TOP}}{{UNIT}} {{RIGHT}}{{UNIT}} {{BOTTOM}}{{UNIT}} {{LEFT}}{{UNIT}};',
583	],
584	]
585	);
586
587	$this->add_group_control(
588	Group_Control_Box_Shadow::get_type(),
589	[
590	'name' => 'box_shadow_hover',
591	'selector' => '{{WRAPPER}}:hover > .elementor-element-populated',
592	]
593	);
594
595	$this->add_control(
596	'border_hover_transition',
597	[
598	'label' => esc_html__( 'Transition Duration', 'elementor' ) . ' (s)',
599	'type' => Controls_Manager::SLIDER,
600	'separator' => 'before',
601	'default' => [
602	'size' => 0.3,
603	],
604	'range' => [
605	'px' => [
606	'min' => 0,
607	'max' => 3,
608	'step' => 0.1,
609	],
610	],
611	'conditions' => [
612	'relation' => 'or',
613	'terms' => [
614	[
615	'name' => 'background_background',
616	'operator' => '!==',
617	'value' => '',
618	],
619	[
620	'name' => 'border_border',
621	'operator' => '!==',
622	'value' => '',
623	],
624	],
625	],
626	'selectors' => [
627	'{{WRAPPER}} > .elementor-element-populated' => 'transition: background {{background_hover_transition.SIZE}}s, border {{SIZE}}s, border-radius {{SIZE}}s, box-shadow {{SIZE}}s',
628	'{{WRAPPER}} > .elementor-element-populated > .elementor-background-overlay' => 'transition: background {{background_overlay_hover_transition.SIZE}}s, border-radius {{SIZE}}s, opacity {{background_overlay_hover_transition.SIZE}}s',
629	],
630	]
631	);
632
633	$this->end_controls_tab();
634
635	$this->end_controls_tabs();
636
637	$this->end_controls_section();
638
639	// Section Typography.
640	$this->start_controls_section(
641	'section_typo',
642	[
643	'label' => esc_html__( 'Typography', 'elementor' ),
644	'type' => Controls_Manager::SECTION,
645	'tab' => Controls_Manager::TAB_STYLE,
646	]
647	);
648
649	$this->add_control(
650	'heading_color',
651	[
652	'label' => esc_html__( 'Heading Color', 'elementor' ),
653	'type' => Controls_Manager::COLOR,
654	'default' => '',
655	'selectors' => [
656	'{{WRAPPER}} .elementor-element-populated .elementor-heading-title' => 'color: {{VALUE}};',
657	],
658	'separator' => 'none',
659	]
660	);
661
662	$this->add_control(
663	'color_text',
664	[
665	'label' => esc_html__( 'Text Color', 'elementor' ),
666	'type' => Controls_Manager::COLOR,
667	'default' => '',
668	'selectors' => [
669	'{{WRAPPER}} > .elementor-element-populated' => 'color: {{VALUE}};',
670	],
671	]
672	);
673
674	$this->add_control(
675	'color_link',
676	[
677	'label' => esc_html__( 'Link Color', 'elementor' ),
678	'type' => Controls_Manager::COLOR,
679	'default' => '',
680	'selectors' => [
681	'{{WRAPPER}} .elementor-element-populated a' => 'color: {{VALUE}};',
682	],
683	]
684	);
685
686	$this->add_control(
687	'color_link_hover',
688	[
689	'label' => esc_html__( 'Link Hover Color', 'elementor' ),
690	'type' => Controls_Manager::COLOR,
691	'default' => '',
692	'selectors' => [
693	'{{WRAPPER}} .elementor-element-populated a:hover' => 'color: {{VALUE}};',
694	],
695	]
696	);
697
698	$this->add_responsive_control(
699	'text_align',
700	[
701	'label' => esc_html__( 'Text Align', 'elementor' ),
702	'type' => Controls_Manager::CHOOSE,
703	'options' => [
704	'left' => [
705	'title' => esc_html__( 'Left', 'elementor' ),
706	'icon' => 'eicon-text-align-left',
707	],
708	'center' => [
709	'title' => esc_html__( 'Center', 'elementor' ),
710	'icon' => 'eicon-text-align-center',
711	],
712	'right' => [
713	'title' => esc_html__( 'Right', 'elementor' ),
714	'icon' => 'eicon-text-align-right',
715	],
716	'justify' => [
717	'title' => esc_html__( 'Justified', 'elementor' ),
718	'icon' => 'eicon-text-align-justify',
719	],
720	],
721	'selectors' => [
722	'{{WRAPPER}} > .elementor-element-populated' => 'text-align: {{VALUE}};',
723	],
724	]
725	);
726
727	$this->end_controls_section();
728
729	// Section Advanced.
730	$this->start_controls_section(
731	'section_advanced',
732	[
733	'label' => esc_html__( 'Advanced', 'elementor' ),
734	'type' => Controls_Manager::SECTION,
735	'tab' => Controls_Manager::TAB_ADVANCED,
736	]
737	);
738
739	$this->add_responsive_control(
740	'margin',
741	[
742	'label' => esc_html__( 'Margin', 'elementor' ),
743	'type' => Controls_Manager::DIMENSIONS,
744	'size_units' => [ 'px', '%', 'em', 'rem', 'vw', 'custom' ],
745	'selectors' => [
746	'{{WRAPPER}} > .elementor-element-populated' => 'margin: {{TOP}}{{UNIT}} {{RIGHT}}{{UNIT}} {{BOTTOM}}{{UNIT}} {{LEFT}}{{UNIT}};
747	--e-column-margin-right: {{RIGHT}}{{UNIT}}; --e-column-margin-left: {{LEFT}}{{UNIT}};',
748	],
749	]
750	);
751
752	$this->add_responsive_control(
753	'padding',
754	[
755	'label' => esc_html__( 'Padding', 'elementor' ),
756	'type' => Controls_Manager::DIMENSIONS,
757	'size_units' => [ 'px', '%', 'em', 'rem', 'vw', 'custom' ],
758	'selectors' => [
759	'{{WRAPPER}} > .elementor-element-populated' => 'padding: {{TOP}}{{UNIT}} {{RIGHT}}{{UNIT}} {{BOTTOM}}{{UNIT}} {{LEFT}}{{UNIT}};',
760	],
761	]
762	);
763
764	$this->add_responsive_control(
765	'z_index',
766	[
767	'label' => esc_html__( 'Z-Index', 'elementor' ),
768	'type' => Controls_Manager::NUMBER,
769	'min' => 0,
770	'selectors' => [
771	'{{WRAPPER}}' => 'z-index: {{VALUE}};',
772	],
773	]
774	);
775
776	$this->add_control(
777	'_element_id',
778	[
779	'label' => esc_html__( 'CSS ID', 'elementor' ),
780	'type' => Controls_Manager::TEXT,
781	'default' => '',
782	'ai' => [
783	'active' => false,
784	],
785	'dynamic' => [
786	'active' => true,
787	],
788	'title' => esc_html__( 'Add your custom id WITHOUT the Pound key. e.g: my-id', 'elementor' ),
789	'style_transfer' => false,
790	'classes' => 'elementor-control-direction-ltr',
791	]
792	);
793
794	$this->add_control(
795	'css_classes',
796	[
797	'label' => esc_html__( 'CSS Classes', 'elementor' ),
798	'type' => Controls_Manager::TEXT,
799	'default' => '',
800	'ai' => [
801	'active' => false,
802	],
803	'dynamic' => [
804	'active' => true,
805	],
806	'prefix_class' => '',
807	'title' => esc_html__( 'Add your custom class WITHOUT the dot. e.g: my-class', 'elementor' ),
808	'classes' => 'elementor-control-direction-ltr',
809	]
810	);
811
812	Plugin::$instance->controls_manager->add_display_conditions_controls( $this );
813
814	// TODO: Backward comparability for deprecated controls
815	$this->add_control(
816	'screen_sm',
817	[
818	'type' => Controls_Manager::HIDDEN,
819	]
820	);
821
822	$this->add_control(
823	'screen_sm_width',
824	[
825	'type' => Controls_Manager::HIDDEN,
826	'condition' => [
827	'screen_sm' => [ 'custom' ],
828	],
829	'prefix_class' => 'elementor-sm-',
830	]
831	);
832	// END Backward comparability
833
834	$this->end_controls_section();
835
836	$this->start_controls_section(
837	'section_effects',
838	[
839	'label' => esc_html__( 'Motion Effects', 'elementor' ),
840	'tab' => Controls_Manager::TAB_ADVANCED,
841	]
842	);
843
844	$this->add_responsive_control(
845	'animation',
846	[
847	'label' => esc_html__( 'Entrance Animation', 'elementor' ),
848	'type' => Controls_Manager::ANIMATION,
849	'frontend_available' => true,
850	]
851	);
852
853	$this->add_control(
854	'animation_duration',
855	[
856	'label' => esc_html__( 'Animation Duration', 'elementor' ),
857	'type' => Controls_Manager::SELECT,
858	'default' => '',
859	'options' => [
860	'slow' => esc_html__( 'Slow', 'elementor' ),
861	'' => esc_html__( 'Normal', 'elementor' ),
862	'fast' => esc_html__( 'Fast', 'elementor' ),
863	],
864	'prefix_class' => 'animated-',
865	'condition' => [
866	'animation!' => '',
867	],
868	]
869	);
870
871	$this->add_control(
872	'animation_delay',
873	[
874	'label' => esc_html__( 'Animation Delay', 'elementor' ) . ' (ms)',
875	'type' => Controls_Manager::NUMBER,
876	'default' => '',
877	'min' => 0,
878	'step' => 100,
879	'condition' => [
880	'animation!' => '',
881	],
882	'render_type' => 'none',
883	'frontend_available' => true,
884	]
885	);
886
887	$this->end_controls_section();
888
889	$this->start_controls_section(
890	'_section_responsive',
891	[
892	'label' => esc_html__( 'Responsive', 'elementor' ),
893	'tab' => Controls_Manager::TAB_ADVANCED,
894	]
895	);
896
897	$this->add_control(
898	'responsive_description',
899	[
900	'raw' => sprintf(
901	/* translators: 1: Link open tag, 2: Link close tag. */
902	esc_html__( 'Responsive visibility will take effect only on %1$s preview mode %2$s or live page, and not while editing in Elementor.', 'elementor' ),
903	'<a href="javascript: $e.run( \'panel/close\' )">',
904	'</a>'
905	),
906	'type' => Controls_Manager::RAW_HTML,
907	'content_classes' => 'elementor-descriptor',
908	]
909	);
910
911	$this->add_hidden_device_controls();
912
913	$this->end_controls_section();
914
915	Plugin::$instance->controls_manager->add_custom_attributes_controls( $this );
916
917	Plugin::$instance->controls_manager->add_custom_css_controls( $this );
918	}
919
920	/**
921	* Render column output in the editor.
922	*
923	* Used to generate the live preview, using a Backbone JavaScript template.
924	*
925	* @since 2.9.0
926	* @access protected
927	*/
928	protected function content_template() {
929	?>
930	<div class="elementor-widget-wrap">
931	<div class="elementor-background-overlay"></div>
932	</div>
933	<?php
934	}
935
936	/**
937	* Before column rendering.
938	*
939	* Used to add stuff before the column element.
940	*
941	* @since 1.0.0
942	* @access public
943	*/
944	public function before_render() {
945	$settings = $this->get_settings_for_display();
946
947	$has_background_overlay = in_array( $settings['background_overlay_background'], [ 'classic', 'gradient' ], true ) \|\|
948	in_array( $settings['background_overlay_hover_background'], [ 'classic', 'gradient' ], true );
949
950	$column_wrap_classes = [ 'elementor-widget-wrap' ];
951
952	if ( $this->get_children() ) {
953	$column_wrap_classes[] = 'elementor-element-populated';
954	}
955
956	$this->add_render_attribute( [
957	'_widget_wrapper' => [
958	'class' => $column_wrap_classes,
959	],
960	'_background_overlay' => [
961	'class' => [ 'elementor-background-overlay' ],
962	],
963	] );
964	?>
965	<<?php
966	// PHPCS - the method get_html_tag is safe.
967	echo $this->get_html_tag(); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
968	?> <?php $this->print_render_attribute_string( '_wrapper' ); ?>>
969	<div <?php $this->print_render_attribute_string( '_widget_wrapper' ); ?>>
970	<?php if ( $has_background_overlay ) : ?>
971	<div <?php $this->print_render_attribute_string( '_background_overlay' ); ?>></div>
972	<?php endif; ?>
973	<?php
974	}
975
976	/**
977	* After column rendering.
978	*
979	* Used to add stuff after the column element.
980	*
981	* @since 1.0.0
982	* @access public
983	*/
984	public function after_render() {
985	?>
986	</div>
987	</<?php
988	// PHPCS - the method get_html_tag is safe.
989	echo $this->get_html_tag(); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?>>
990	<?php
991	}
992
993	/**
994	* Add column render attributes.
995	*
996	* Used to add attributes to the current column wrapper HTML tag.
997	*
998	* @since 1.3.0
999	* @access protected
1000	*/
1001	protected function add_render_attributes() {
1002
1003	$is_inner = $this->get_data( 'isInner' );
1004
1005	$column_type = ! empty( $is_inner ) ? 'inner' : 'top';
1006
1007	$settings = $this->get_settings();
1008
1009	$this->add_render_attribute(
1010	'_wrapper', 'class', [
1011	'elementor-column',
1012	'elementor-col-' . $settings['_column_size'],
1013	'elementor-' . $column_type . '-column',
1014	]
1015	);
1016
1017	parent::add_render_attributes();
1018	}
1019
1020	/**
1021	* Get default child type.
1022	*
1023	* Retrieve the column child type based on element data.
1024	*
1025	* @since 1.0.0
1026	* @access protected
1027	*
1028	* @param array $element_data Element ID.
1029	*
1030	* @return Element_Base\|false Column default child type.
1031	*/
1032	protected function _get_default_child_type( array $element_data ) {
1033	if ( 'section' === $element_data['elType'] ) {
1034	return Plugin::$instance->elements_manager->get_element_types( 'section' );
1035	}
1036
1037	if ( 'container' === $element_data['elType'] ) {
1038	return Plugin::$instance->elements_manager->get_element_types( 'container' );
1039	}
1040
1041	// If the element doesn't exists (disabled element, experiment, etc.), return false to prevent errors.
1042	if ( empty( $element_data['widgetType'] ) ) {
1043	return false;
1044	}
1045
1046	return Plugin::$instance->widgets_manager->get_widget_types( $element_data['widgetType'] );
1047	}
1048
1049	/**
1050	* Get HTML tag.
1051	*
1052	* Retrieve the column element HTML tag.
1053	*
1054	* @since 1.5.3
1055	* @access private
1056	*
1057	* @return string Column HTML tag.
1058	*/
1059	private function get_html_tag() {
1060	$html_tag = $this->get_settings( 'html_tag' );
1061
1062	if ( empty( $html_tag ) ) {
1063	$html_tag = 'div';
1064	}
1065
1066	return Utils::validate_html_tag( $html_tag );
1067	}
1068	}
1069