elementor / modules / atomic-widgets / elements / div-block / div-block.php

div-block.php in Elementor Website Builder – more than just a page builder 4.3.4, at modules/atomic-widgets/elements/div-block/div-block.php

213 lines 6.1 KB

Raw Download Zip

1	<?php
2	namespace Elementor\Modules\AtomicWidgets\Elements\Div_Block;
3
4	use Elementor\Modules\AtomicWidgets\Elements\Base\Atomic_Element_Base;
5	use Elementor\Modules\AtomicWidgets\Elements\Base\Has_Element_Template;
6	use Elementor\Modules\AtomicWidgets\Elements\Base\Html_Tag_Computer;
7	use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\String_Prop_Type;
8	use Elementor\Modules\AtomicWidgets\PropTypes\Size_Prop_Type;
9	use Elementor\Modules\AtomicWidgets\Styles\Style_Definition;
10	use Elementor\Modules\AtomicWidgets\PropTypes\Attributes_Prop_Type;
11	use Elementor\Modules\AtomicWidgets\Styles\Style_Variant;
12	use Elementor\Modules\AtomicWidgets\Controls\Section;
13	use Elementor\Modules\AtomicWidgets\Controls\Types\Link_Control;
14	use Elementor\Modules\AtomicWidgets\Controls\Types\Html_Tag_Control;
15	use Elementor\Modules\AtomicWidgets\Controls\Types\Text_Control;
16	use Elementor\Modules\AtomicWidgets\PropDependencies\Manager as Dependency_Manager;
17	use Elementor\Modules\AtomicWidgets\PropTypes\Classes_Prop_Type;
18	use Elementor\Modules\AtomicWidgets\PropTypes\Link_Prop_Type;
19	use Elementor\Modules\Components\PropTypes\Overridable_Prop_Type;
20
21	if ( ! defined( 'ABSPATH' ) ) {
22	exit; // Exit if accessed directly.
23	}
24
25	class Div_Block extends Atomic_Element_Base {
26	use Has_Element_Template;
27
28	const BASE_STYLE_KEY = 'base';
29
30	public function __construct( $data = [], $args = null ) {
31	parent::__construct( $data, $args );
32	$this->meta( 'is_container', true );
33	}
34
35	public static function get_type() {
36	return 'e-div-block';
37	}
38
39	public static $widget_description = 'A block container (div) for grouping and wrapping content, with default styles (see llm_guidance.default_styles).';
40
41	public static function get_element_type(): string {
42	return 'e-div-block';
43	}
44
45	public function get_title() {
46	return esc_html__( 'Div block', 'elementor' );
47	}
48
49	public function get_keywords() {
50	return [ 'ato', 'atom', 'atoms', 'atomic', 'container', 'wrapper', 'section', 'row', 'column', 'div', 'box', 'layout' ];
51	}
52
53	public function get_icon() {
54	return 'eicon-div-block';
55	}
56
57	public static function get_computed_html_tag( array $settings ): string {
58	return Html_Tag_Computer::compute( $settings, 'div' );
59	}
60
61	protected static function define_props_schema(): array {
62	$tag_dependencies = Dependency_Manager::make( Dependency_Manager::RELATION_AND )
63	->where( [
64	'operator' => 'ne',
65	'path' => [ 'link', 'destination' ],
66	'nestedPath' => [ 'group' ],
67	'value' => 'action',
68	'newValue' => [
69	'$$type' => 'string',
70	'value' => 'button',
71	],
72	] )->where( [
73	'operator' => 'not_exist',
74	'path' => [ 'link', 'destination' ],
75	'newValue' => [
76	'$$type' => 'string',
77	'value' => 'a',
78	],
79	] )->get();
80
81	return [
82	'classes' => Classes_Prop_Type::make()
83	->default( [] ),
84	'tag' => String_Prop_Type::make()
85	->enum( [ 'div', 'header', 'section', 'article', 'aside', 'footer', 'a', 'button', 'main', 'nav' ] )
86	->default( 'div' )
87	->description( 'The HTML tag for the div block container. One of: div, header, section, article, aside, footer, main, nav, a (link), or button. Do not use heading or paragraph tags.' )
88	->set_dependencies( $tag_dependencies ),
89	'link' => Link_Prop_Type::make(),
90	'attributes' => Attributes_Prop_Type::make()->meta( Overridable_Prop_Type::ignore() ),
91	];
92	}
93
94	protected function define_atomic_controls(): array {
95	return [
96	Section::make()
97	->set_label( __( 'Settings', 'elementor' ) )
98	->set_id( 'settings' )
99	->set_items( [
100	Html_Tag_Control::bind_to( 'tag' )
101	->set_options( [
102	[
103	'value' => 'div',
104	'label' => 'Div',
105	],
106	[
107	'value' => 'header',
108	'label' => 'Header',
109	],
110	[
111	'value' => 'section',
112	'label' => 'Section',
113	],
114	[
115	'value' => 'article',
116	'label' => 'Article',
117	],
118	[
119	'value' => 'aside',
120	'label' => 'Aside',
121	],
122	[
123	'value' => 'footer',
124	'label' => 'Footer',
125	],
126	[
127	'value' => 'main',
128	'label' => 'Main',
129	],
130	[
131	'value' => 'nav',
132	'label' => 'Nav',
133	],
134	])
135	->set_fallback_labels( [
136	'a' => 'a (link)',
137	] )
138	->set_label( esc_html__( 'HTML Tag', 'elementor' ) ),
139	Link_Control::bind_to( 'link' )
140	->set_placeholder( __( 'Type or paste your URL', 'elementor' ) )
141	->set_label( __( 'Link', 'elementor' ) )
142	->set_meta( [
143	'topDivider' => true,
144	] ),
145	Text_Control::bind_to( '_cssid' )
146	->set_label( __( 'ID', 'elementor' ) )
147	->set_meta( $this->get_css_id_control_meta() ),
148	] ),
149	];
150	}
151
152	protected function define_base_styles(): array {
153	$display = String_Prop_Type::generate( 'block' );
154
155	return [
156	static::BASE_STYLE_KEY => Style_Definition::make()
157	->add_variant(
158	Style_Variant::make()
159	->add_prop( 'display', $display )
160	->add_prop( 'padding', $this->get_base_padding() )
161	->add_prop( 'min-width', $this->get_base_min_width() )
162	),
163	];
164	}
165
166	protected function get_base_padding(): array {
167	return Size_Prop_Type::generate( [
168	'size' => 10,
169	'unit' => 'px',
170	] );
171	}
172
173	protected function get_base_min_width(): array {
174	return Size_Prop_Type::generate( [
175	'size' => 30,
176	'unit' => 'px',
177	] );
178	}
179
180	protected function add_render_attributes() {
181	parent::add_render_attributes();
182	$settings = $this->get_atomic_settings();
183	$base_style_class = $this->get_base_styles_dictionary()[ static::BASE_STYLE_KEY ];
184	$initial_attributes = $this->define_initial_attributes();
185
186	$attributes = [
187	'class' => [
188	'e-con',
189	'e-atomic-element',
190	$base_style_class,
191	...( $settings['classes'] ?? [] ),
192	],
193	];
194
195	if ( ! empty( $settings['_cssid'] ) ) {
196	$attributes['id'] = esc_attr( $settings['_cssid'] );
197	}
198
199	if ( ! empty( $settings['link']['href'] ) ) {
200	$link_attributes = $this->get_link_attributes( $settings['link'] );
201	$attributes = array_merge( $attributes, $link_attributes );
202	}
203
204	$this->add_render_attribute( '_wrapper', array_merge( $initial_attributes, $attributes ) );
205	}
206
207	protected function get_templates(): array {
208	return [
209	'elementor/elements/div-block' => __DIR__ . '/div-block.html.twig',
210	];
211	}
212	}
213