← All changes | modules/atomic-widgets/styles/style-schema.php +69 -235 4.0.7 → 3.27.4 View file →

		@@ -1,30 +1,19 @@
1	1	<?php
2		-
3	2	namespace Elementor\Modules\AtomicWidgets\Styles;
4	3
5		-use Elementor\Modules\AtomicWidgets\DynamicTags\Dynamic_Prop_Types_Mapping;
6		-use Elementor\Modules\AtomicWidgets\PropTypes\Background_Image_Overlay_Prop_Type;
7		-use Elementor\Modules\AtomicWidgets\PropTypes\Background_Overlay_Prop_Type;
8	4	use Elementor\Modules\AtomicWidgets\PropTypes\Background_Prop_Type;
9	5	use Elementor\Modules\AtomicWidgets\PropTypes\Box_Shadow_Prop_Type;
10	6	use Elementor\Modules\AtomicWidgets\PropTypes\Border_Radius_Prop_Type;
11	7	use Elementor\Modules\AtomicWidgets\PropTypes\Border_Width_Prop_Type;
12	8	use Elementor\Modules\AtomicWidgets\PropTypes\Color_Prop_Type;
13		-use Elementor\Modules\AtomicWidgets\PropTypes\Dimensions_Prop_Type;
14		-use Elementor\Modules\AtomicWidgets\PropTypes\Filters\Backdrop_Filter_Prop_Type;
15		-use Elementor\Modules\AtomicWidgets\PropTypes\Filters\Filter_Prop_Type;
16		-use Elementor\Modules\AtomicWidgets\PropTypes\Layout_Direction_Prop_Type;
17		-use Elementor\Modules\AtomicWidgets\PropTypes\Position_Prop_Type;
	9	+use Elementor\Modules\AtomicWidgets\PropTypes\Linked_Dimensions_Prop_Type;
18	10	use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\Number_Prop_Type;
19	11	use Elementor\Modules\AtomicWidgets\PropTypes\Size_Prop_Type;
20	12	use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\String_Prop_Type;
21	13	use Elementor\Modules\AtomicWidgets\PropTypes\Stroke_Prop_Type;
22		-use Elementor\Modules\AtomicWidgets\PropTypes\Transform\Transform_Prop_Type;
23		-use Elementor\Modules\AtomicWidgets\PropTypes\Transition_Prop_Type;
24	14	use Elementor\Modules\AtomicWidgets\PropTypes\Union_Prop_Type;
25		-use Elementor\Modules\AtomicWidgets\PropTypes\Flex_Prop_Type;
26		-use Elementor\Modules\AtomicWidgets\PropDependencies\Manager as Dependency_Manager;
	15	+use Elementor\Modules\AtomicWidgets\PropTypes\Gap_Prop_Type;
27	16
28	17	if ( ! defined( 'ABSPATH' ) ) {
29	18	exit; // Exit if accessed directly.
30	19	}
		@@ -30,12 +19,8 @@
30	19	}
31	20
32	21	class Style_Schema {
33	22	public static function get() {
34		- return apply_filters( 'elementor/atomic-widgets/styles/schema', static::get_style_schema() );
35		- }
36		-
37		- public static function get_style_schema(): array {
38	23	return array_merge(
39	24	self::get_size_props(),
40	25	self::get_position_props(),
41	26	self::get_typography_props(),
		@@ -44,75 +29,47 @@
44	29	self::get_background_props(),
45	30	self::get_effects_props(),
46	31	self::get_layout_props(),
47	32	self::get_alignment_props(),
48		- self::get_special_props(),
49	33	);
50	34	}
51	35
52	36	private static function get_size_props() {
53	37	return [
54		- 'width' => Size_Prop_Type::make()->description( 'The width of the element' ),
55		- 'height' => Size_Prop_Type::make()->description( 'The height of the element' ),
56		- 'min-width' => Size_Prop_Type::make()->description( 'The minimum width of the element' ),
57		- 'min-height' => Size_Prop_Type::make()->description( 'The minimum height of the element' ),
58		- 'max-width' => Size_Prop_Type::make()->description( 'The maximum width of the element' ),
59		- 'max-height' => Size_Prop_Type::make()->description( 'The maximum height of the element' ),
60		- 'overflow' => String_Prop_Type::make()->enum( [
	38	+ 'width' => Size_Prop_Type::make(),
	39	+ 'height' => Size_Prop_Type::make(),
	40	+ 'min-width' => Size_Prop_Type::make(),
	41	+ 'min-height' => Size_Prop_Type::make(),
	42	+ 'max-width' => Size_Prop_Type::make(),
	43	+ 'max-height' => Size_Prop_Type::make(),
	44	+ 'overflow' => String_Prop_Type::make()->enum([
61	45	'visible',
62	46	'hidden',
63	47	'auto',
64		- ] )->description( 'The overflow CSS property. CSS values: visible, hidden, auto' ),
65		- 'aspect-ratio' => String_Prop_Type::make()->description( 'Equivalent to CSS aspect-ration property' ),
66		- 'object-fit' => String_Prop_Type::make()->enum( [
67		- 'fill',
68		- 'cover',
69		- 'contain',
70		- 'none',
71		- 'scale-down',
72		- ] )->description( 'The object-fit CSS. CSS values: fill, cover, contain, none, scale-down' ),
73		- 'object-position' => Union_Prop_Type::make()
74		- ->add_prop_type( String_Prop_Type::make()->enum( Position_Prop_Type::get_position_enum_values() ) )
75		- ->add_prop_type( Position_Prop_Type::make() )
76		- ->set_dependencies(
77		- Dependency_Manager::make( Dependency_Manager::RELATION_AND )
78		- ->where( [
79		- 'operator' => 'ne',
80		- 'path' => [ 'object-fit' ],
81		- 'value' => 'fill',
82		- ] )
83		- ->where( [
84		- 'operator' => 'exists',
85		- 'path' => [ 'object-fit' ],
86		- ] )
87		- ->get()
88		- ),
	48	+ ]),
89	49	];
90	50	}
91	51
92	52	private static function get_position_props() {
93	53	return [
94		- 'position' => String_Prop_Type::make()->enum( [
	54	+ 'position' => String_Prop_Type::make()->enum([
95	55	'static',
96	56	'relative',
97	57	'absolute',
98	58	'fixed',
99		- 'sticky',
100		- ] )->description( 'The CSS position property specifies the type of positioning method used for an element (static, relative, absolute, fixed, or sticky).' ),
101		- 'inset-block-start' => Size_Prop_Type::make()->description( 'Size PropType for the inset-block-start CSS property' ),
102		- 'inset-inline-end' => Size_Prop_Type::make()->description( 'Size PropType for the inset-inline-end CSS property' ),
103		- 'inset-block-end' => Size_Prop_Type::make()->description( 'Size PropType for the inset-block-end CSS property' ),
104		- 'inset-inline-start' => Size_Prop_Type::make()->description( 'Size PropType for the inset-inline-start CSS property' ),
105		- 'z-index' => Number_Prop_Type::make()
106		- ->description( 'The z-index CSS property sets the z-order of a positioned element and its descendants or flex items. It specifies the stack order of elements.' ),
107		- 'scroll-margin-top' => Size_Prop_Type::make()->units( Size_Constants::anchor_offset() ),
	59	+ ]),
	60	+ 'top' => Size_Prop_Type::make(),
	61	+ 'right' => Size_Prop_Type::make(),
	62	+ 'bottom' => Size_Prop_Type::make(),
	63	+ 'left' => Size_Prop_Type::make(),
	64	+ 'z-index' => Number_Prop_Type::make(),
108	65	];
109	66	}
110	67
111	68	private static function get_typography_props() {
112	69	return [
113		- 'font-family' => String_Prop_Type::make()->description( 'The font family of the text content.' ),
114		- 'font-weight' => String_Prop_Type::make()->enum( [
	70	+ 'font-family' => String_Prop_Type::make(),
	71	+ 'font-weight' => String_Prop_Type::make()->enum([
115	72	'100',
116	73	'200',
117	74	'300',
118	75	'400',
		@@ -124,98 +81,57 @@
124	81	'normal',
125	82	'bold',
126	83	'bolder',
127	84	'lighter',
128		- ] )
129		- ->description( 'The weight (or boldness) of the font. Values should match css font-weight specifications.' ),
130		- 'font-size' => Size_Prop_Type::make()->units( Size_Constants::typography() )->description( 'The font size in Size PropType Format' ),
131		- 'color' => Color_Prop_Type::make()
132		- ->description( 'The text color, specified as a hex code, rgb(a), hsl(a), or a standard css color name.' ),
133		- 'letter-spacing' => Size_Prop_Type::make()->units( Size_Constants::typography() )->description( 'The spacing between letters in Size PropType format' ),
134		- 'word-spacing' => Size_Prop_Type::make()->units( Size_Constants::typography() )->description( 'The spacing between words in Size PropType format' ),
135		- 'column-count' => Number_Prop_Type::make()->description( 'The number of columns the text content should be divided into.' ),
136		- 'column-gap' => Size_Prop_Type::make()
137		- ->set_dependencies(
138		- Dependency_Manager::make()
139		- ->where( [
140		- 'operator' => 'gte',
141		- 'path' => [ 'column-count' ],
142		- 'value' => 1,
143		- ] )
144		- ->get()
145		- ),
146		- 'line-height' => Size_Prop_Type::make()->units( Size_Constants::typography() )->description( 'The line height of the text content in Size PropType format' ),
147		- 'text-align' => String_Prop_Type::make()->enum( [
148		- 'start',
	85	+ ]),
	86	+ 'font-size' => Size_Prop_Type::make(),
	87	+ 'color' => Color_Prop_Type::make(),
	88	+ 'letter-spacing' => Size_Prop_Type::make(),
	89	+ 'word-spacing' => Size_Prop_Type::make(),
	90	+ 'text-align' => String_Prop_Type::make()->enum([
	91	+ 'left',
149	92	'center',
150		- 'end',
	93	+ 'right',
151	94	'justify',
152		- ] )
153		- ->description( 'The horizontal alignment of the text content. Allowed values: start, center, end, justify.' ),
154		- 'font-style' => String_Prop_Type::make()->enum( [
	95	+ ]),
	96	+ 'font-style' => String_Prop_Type::make()->enum([
155	97	'normal',
156	98	'italic',
157	99	'oblique',
158		- ] )
159		- ->description( 'The font style of the text content. CSS values: normal, italic, oblique' ),
	100	+ ]),
160	101	// TODO: validate text-decoration in more specific way [EDS-524]
161		- 'text-decoration' => String_Prop_Type::make()
162		- ->description( 'The text decoration style. CSS values like: none, underline, overline, line-through, blink, etc.' ),
163		- 'text-transform' => String_Prop_Type::make()->enum( [
	102	+ 'text-decoration' => String_Prop_Type::make(),
	103	+ 'text-transform' => String_Prop_Type::make()->enum([
164	104	'none',
165	105	'capitalize',
166	106	'uppercase',
167	107	'lowercase',
168		- ] )
169		- ->description( 'Controls the capitalization of text. CSS values: none, capitalize, uppercase, lowercase' ),
170		- 'direction' => String_Prop_Type::make()->enum( [
	108	+ ]),
	109	+ 'direction' => String_Prop_Type::make()->enum([
171	110	'ltr',
172	111	'rtl',
173		- ] )->description( 'The text direction. CSS values: ltr (left to right), rtl (right to left)' ),
174		- 'stroke' => Stroke_Prop_Type::make(),
175		- 'all' => String_Prop_Type::make()->enum( [
176		- 'initial',
177		- 'inherit',
178		- 'unset',
179		- 'revert',
180		- 'revert-layer',
181		- ] )->description( 'The all CSS property. CSS values: initial, inherit, unset, revert, revert-layer' ),
182		- 'cursor' => String_Prop_Type::make()->enum( [
183		- 'pointer',
184		- ] )
185		- ->description( 'The type of cursor to be displayed when pointing over the element. E.g., pointer.' ),
	112	+ ]),
	113	+ '-webkit-text-stroke' => Stroke_Prop_Type::make(),
186	114	];
187	115	}
188	116
189	117	private static function get_spacing_props() {
190	118	return [
191		- 'padding' => Union_Prop_Type::make()
192		- ->add_prop_type( Dimensions_Prop_Type::make_with_units( Size_Constants::spacing() ) )
193		- ->add_prop_type(
194		- Size_Prop_Type::make()
195		- ->units( Size_Constants::spacing() )
196		- ->description( 'Padding css in Size PropType format' )
197		- ),
198		- 'margin' => Union_Prop_Type::make()
199		- ->add_prop_type( Dimensions_Prop_Type::make_with_units( Size_Constants::spacing_margin() ) )
200		- ->add_prop_type(
201		- Size_Prop_Type::make()
202		- ->units( Size_Constants::spacing_margin() )
203		- ->description( 'Margin css in Size PropType format' )
204		- ),
	119	+ 'padding' => Linked_Dimensions_Prop_Type::make(),
	120	+ 'margin' => Linked_Dimensions_Prop_Type::make(),
205	121	];
206	122	}
207	123
208	124	private static function get_border_props() {
209	125	return [
210		- 'border-radius' => Union_Prop_Type::make()
211		- ->add_prop_type( Border_Radius_Prop_Type::make() )
212		- ->add_prop_type( Size_Prop_Type::make()->units( Size_Constants::border() ) ),
213		- 'border-width' => Union_Prop_Type::make()
214		- ->add_prop_type( Border_Width_Prop_Type::make() )
215		- ->add_prop_type( Size_Prop_Type::make()->units( Size_Constants::border() ) ),
216		- 'border-color' => Color_Prop_Type::make()->description( 'The border color, specified as a hex code, rgb(a), hsl(a), or a standard css color name.' ),
217		- 'border-style' => String_Prop_Type::make()->enum( [
	126	+ 'border-radius' => Union_Prop_Type::make()->add_prop_type(
	127	+ Size_Prop_Type::make()
	128	+ )->add_prop_type(
	129	+ Border_Radius_Prop_Type::make()
	130	+ ),
	131	+ 'border-width' => Union_Prop_Type::make()->add_prop_type( Size_Prop_Type::make() )->add_prop_type( Border_Width_Prop_Type::make() ),
	132	+ 'border-color' => Color_Prop_Type::make(),
	133	+ 'border-style' => String_Prop_Type::make()->enum([
218	134	'none',
219	135	'hidden',
220	136	'dotted',
221	137	'dashed',
		@@ -224,77 +140,27 @@
224	140	'groove',
225	141	'ridge',
226	142	'inset',
227	143	'outset',
228		- ] )
229		- ->description( 'The border style in CSS values' ),
230		- 'outline-width' => Size_Prop_Type::make()
231		- ->units( Size_Constants::border() )
232		- ->description( 'The width of the outline in Size PropType format' ),
233		- 'outline-color' => Color_Prop_Type::make()->description( 'The color of the outline, specified as a hex code, rgb(a), hsl(a), or a standard css color name.' ),
234		- 'outline-style' => String_Prop_Type::make()->enum( [
235		- 'none',
236		- 'hidden',
237		- 'dotted',
238		- 'dashed',
239		- 'solid',
240		- 'double',
241		- 'groove',
242		- 'ridge',
243		- 'inset',
244		- 'outset',
245		- ] )->description( 'The outline style in CSS values' ),
246		- 'outline-offset' => Size_Prop_Type::make()->units( Size_Constants::border() )->description( 'The offset of the outline, specified as a length in Size PropType format' ),
247		-
	144	+ ]),
248	145	];
249	146	}
250	147
251	148	private static function get_background_props() {
252		- // Background image overlay as an exception
253		- $background_prop_type = Background_Prop_Type::make();
254		- $bg_overlay_prop_type = $background_prop_type->get_shape_field( Background_Overlay_Prop_Type::get_key() );
255		- $bg_image_overlay_prop_type = $bg_overlay_prop_type->get_item_type()->get_prop_type( Background_Image_Overlay_Prop_Type::get_key() );
256		- Dynamic_Prop_Types_Mapping::make()->get_extended_schema( $bg_image_overlay_prop_type->get_shape() );
257	149	return [
258		- 'background' => $background_prop_type,
	150	+ 'background' => Background_Prop_Type::make(),
259	151	];
260	152	}
261	153
262	154	private static function get_effects_props() {
263	155	return [
264		- 'mix-blend-mode' => String_Prop_Type::make()->enum( [
265		- 'normal',
266		- 'multiply',
267		- 'screen',
268		- 'overlay',
269		- 'darken',
270		- 'lighten',
271		- 'color-dodge',
272		- 'saturation',
273		- 'color',
274		- 'difference',
275		- 'exclusion',
276		- 'hue',
277		- 'luminosity',
278		- 'soft-light',
279		- 'hard-light',
280		- 'color-burn',
281		- ] )->description( 'Applied as mix-blend mode css effect.' ),
282	156	'box-shadow' => Box_Shadow_Prop_Type::make(),
283		- 'opacity' => Size_Prop_Type::make()
284		- ->description( 'The opacity of the element, specified as a percentage between 0 (fully transparent) and 100 (fully opaque).' )
285		- ->units( Size_Constants::opacity() )
286		- ->default_unit( Size_Constants::UNIT_PERCENT ),
287		- 'filter' => Filter_Prop_Type::make(),
288		- 'backdrop-filter' => Backdrop_Filter_Prop_Type::make(),
289		- 'transform' => Transform_Prop_Type::make(),
290		- 'transition' => Transition_Prop_Type::make(),
291	157	];
292	158	}
293	159
294	160	private static function get_layout_props() {
295	161	return [
296		- 'display' => String_Prop_Type::make()->enum( [
	162	+ 'display' => String_Prop_Type::make()->enum([
297	163	'block',
298	164	'inline',
299	165	'inline-block',
300	166	'flex',
		@@ -303,32 +169,30 @@
303	169	'inline-grid',
304	170	'flow-root',
305	171	'none',
306	172	'contents',
307		- ] )->description( 'The CSS display property defines the display behavior (the type of rendering box) of an element.' ),
308		- 'flex-direction' => String_Prop_Type::make()
309		- ->description( 'The direction of the contained items.' )
310		- ->enum( [
311		- 'row',
312		- 'row-reverse',
313		- 'column',
314		- 'column-reverse',
315		- ] ),
316		- 'gap' => Union_Prop_Type::make()
317		- ->add_prop_type( Layout_Direction_Prop_Type::make() )
318		- ->add_prop_type( Size_Prop_Type::make()->units( Size_Constants::layout() ) ),
319		- 'flex-wrap' => String_Prop_Type::make()->enum( [
	173	+ ]),
	174	+ 'flex-direction' => String_Prop_Type::make()->enum([
	175	+ 'row',
	176	+ 'row-reverse',
	177	+ 'column',
	178	+ 'column-reverse',
	179	+ ]),
	180	+ 'gap' => Gap_Prop_Type::make(),
	181	+ 'flex-wrap' => String_Prop_Type::make()->enum([
320	182	'wrap',
321	183	'nowrap',
322	184	'wrap-reverse',
323		- ] )->description( 'Specifies whether the flex items should wrap or not. CSS values: wrap, nowrap, wrap-reverse' ),
324		- 'flex' => Flex_Prop_Type::make(),
	185	+ ]),
	186	+ 'flex-grow' => Number_Prop_Type::make(),
	187	+ 'flex-shrink' => Number_Prop_Type::make(),
	188	+ 'flex-basis' => Size_Prop_Type::make(),
325	189	];
326	190	}
327	191
328	192	private static function get_alignment_props() {
329	193	return [
330		- 'justify-content' => String_Prop_Type::make()->enum( [
	194	+ 'justify-content' => String_Prop_Type::make()->enum([
331	195	'center',
332	196	'start',
333	197	'end',
334	198	'flex-start',
		@@ -339,11 +203,10 @@
339	203	'space-between',
340	204	'space-around',
341	205	'space-evenly',
342	206	'stretch',
343		- ] )
344		- ->description( 'Defines how the browser distributes space between and around content items along the main-axis of a flex container. CSS values: center, start, end, flex-start, flex-end, left, right, normal, space-between, space-around, space-evenly, stretch' ),
345		- 'justify-items' => String_Prop_Type::make()->enum( [
	207	+ ]),
	208	+ 'align-items' => String_Prop_Type::make()->enum([
346	209	'normal',
347	210	'stretch',
348	211	'center',
349	212	'start',
		@@ -349,34 +212,13 @@
349	212	'start',
350	213	'end',
351	214	'flex-start',
352	215	'flex-end',
353		- 'left',
354		- 'right',
355		- 'anchor-center',
356		- ] )->description( 'Defines how the browser distributes space between and around content items along the inline axis of a grid container. CSS values: center, start, end, flex-start, flex-end, left, right' ),
357		- 'align-content' => String_Prop_Type::make()->enum( [
358		- 'center',
359		- 'start',
360		- 'end',
361		- 'space-between',
362		- 'space-around',
363		- 'space-evenly',
364		- ] )
365		- ->description( 'Aligns a flex container\'s lines within when there is extra space in the cross-axis. CSS values: center, start, end, space-between, space-around, space-evenly' ),
366		- 'align-items' => String_Prop_Type::make()->enum( [
367		- 'normal',
368		- 'stretch',
369		- 'center',
370		- 'start',
371		- 'end',
372		- 'flex-start',
373		- 'flex-end',
374	216	'self-start',
375	217	'self-end',
376	218	'anchor-center',
377		- ] )->description( 'Defines the default behavior for how flex items are laid out along the cross axis on the current line. CSS values: normal, stretch, center, start, end, flex-start, flex-end, self-start, self-end, anchor-center' ),
378		- 'align-self' => String_Prop_Type::make()->enum( [
	219	+ ]),
	220	+ 'align-self' => String_Prop_Type::make()->enum([
379	221	'auto',
380	222	'normal',
381	223	'center',
382	224	'start',
		@@ -389,17 +231,9 @@
389	231	'baseline',
390	232	'first baseline',
391	233	'last baseline',
392	234	'stretch',
393		- ] )->description( 'Allows the default alignment (or the one specified by align-items) to be overridden for individual flex items. CSS values: auto, normal, center, start, end, self-start, self-end, flex-start, flex-end, anchor-center, baseline, first baseline, last baseline, stretch' ),
394		- 'order' => Number_Prop_Type::make()->description( 'Specifies the order of the flex items. Items with lower order values are displayed first.' ),
395		- ];
396		- }
397		-
398		- private static function get_special_props() {
399		- return [
400		- 'content' => String_Prop_Type::make()->description( 'The string content for pseudo-element content property' ),
401		- 'appearance' => String_Prop_Type::make()->enum( [ 'none', 'auto' ] )->description( 'The appearance of the element. CSS values: none, auto' ),
402		- 'clip-path' => String_Prop_Type::make()->description( 'The clip-path CSS property defines a shape to be used as clipping region.' ),
	235	+ ]),
	236	+ 'order' => Number_Prop_Type::make(),
403	237	];
404	238	}
405	239	}