elementor / includes / controls / groups / typography.php

typography.php in Elementor Website Builder – more than just a page builder 3.4.5, at includes/controls/groups/typography.php

313 lines 7.7 KB

Raw Download Zip

1	<?php
2	namespace Elementor;
3
4	use Elementor\Core\Settings\Page\Manager as PageManager;
5
6	if ( ! defined( 'ABSPATH' ) ) {
7	exit; // Exit if accessed directly.
8	}
9
10	/**
11	* Elementor typography control.
12	*
13	* A base control for creating typography control. Displays input fields to define
14	* the content typography including font size, font family, font weight, text
15	* transform, font style, line height and letter spacing.
16	*
17	* @since 1.0.0
18	*/
19	class Group_Control_Typography extends Group_Control_Base {
20
21	/**
22	* Fields.
23	*
24	* Holds all the typography control fields.
25	*
26	* @since 1.0.0
27	* @access protected
28	* @static
29	*
30	* @var array Typography control fields.
31	*/
32	protected static $fields;
33
34	/**
35	* Scheme fields keys.
36	*
37	* Holds all the typography control scheme fields keys.
38	* Default is an array containing `font_family` and `font_weight`.
39	*
40	* @since 1.0.0
41	* @access private
42	* @static
43	*
44	* @var array Typography control scheme fields keys.
45	*/
46	private static $_scheme_fields_keys = [ 'font_family', 'font_weight' ];
47
48	/**
49	* Get scheme fields keys.
50	*
51	* Retrieve all the available typography control scheme fields keys.
52	*
53	* @since 1.0.0
54	* @access public
55	* @static
56	*
57	* @return array Scheme fields keys.
58	*/
59	public static function get_scheme_fields_keys() {
60	return self::$_scheme_fields_keys;
61	}
62
63	/**
64	* Get typography control type.
65	*
66	* Retrieve the control type, in this case `typography`.
67	*
68	* @since 1.0.0
69	* @access public
70	* @static
71	*
72	* @return string Control type.
73	*/
74	public static function get_type() {
75	return 'typography';
76	}
77
78	/**
79	* Init fields.
80	*
81	* Initialize typography control fields.
82	*
83	* @since 1.2.2
84	* @access protected
85	*
86	* @return array Control fields.
87	*/
88	protected function init_fields() {
89	$fields = [];
90
91	$kit = Plugin::$instance->kits_manager->get_active_kit_for_frontend();
92
93	/**
94	* Retrieve the settings directly from DB, because of an open issue when a controls group is being initialized
95	* from within another group
96	*/
97	$kit_settings = $kit->get_meta( PageManager::META_KEY );
98
99	$default_fonts = isset( $kit_settings['default_generic_fonts'] ) ? $kit_settings['default_generic_fonts'] : 'Sans-serif';
100
101	if ( $default_fonts ) {
102	$default_fonts = ', ' . $default_fonts;
103	}
104
105	$fields['font_family'] = [
106	'label' => _x( 'Family', 'Typography Control', 'elementor' ),
107	'type' => Controls_Manager::FONT,
108	'default' => '',
109	'selector_value' => 'font-family: "{{VALUE}}"' . $default_fonts . ';',
110	];
111
112	$fields['font_size'] = [
113	'label' => _x( 'Size', 'Typography Control', 'elementor' ),
114	'type' => Controls_Manager::SLIDER,
115	'size_units' => [ 'px', 'em', 'rem', 'vw' ],
116	'range' => [
117	'px' => [
118	'min' => 1,
119	'max' => 200,
120	],
121	'vw' => [
122	'min' => 0.1,
123	'max' => 10,
124	'step' => 0.1,
125	],
126	],
127	'responsive' => true,
128	'selector_value' => 'font-size: {{SIZE}}{{UNIT}}',
129	];
130
131	$typo_weight_options = [
132	'' => esc_html__( 'Default', 'elementor' ),
133	];
134
135	foreach ( array_merge( [ 'normal', 'bold' ], range( 100, 900, 100 ) ) as $weight ) {
136	$typo_weight_options[ $weight ] = ucfirst( $weight );
137	}
138
139	$fields['font_weight'] = [
140	'label' => _x( 'Weight', 'Typography Control', 'elementor' ),
141	'type' => Controls_Manager::SELECT,
142	'default' => '',
143	'options' => $typo_weight_options,
144	];
145
146	$fields['text_transform'] = [
147	'label' => _x( 'Transform', 'Typography Control', 'elementor' ),
148	'type' => Controls_Manager::SELECT,
149	'default' => '',
150	'options' => [
151	'' => esc_html__( 'Default', 'elementor' ),
152	'uppercase' => _x( 'Uppercase', 'Typography Control', 'elementor' ),
153	'lowercase' => _x( 'Lowercase', 'Typography Control', 'elementor' ),
154	'capitalize' => _x( 'Capitalize', 'Typography Control', 'elementor' ),
155	'none' => _x( 'Normal', 'Typography Control', 'elementor' ),
156	],
157	];
158
159	$fields['font_style'] = [
160	'label' => _x( 'Style', 'Typography Control', 'elementor' ),
161	'type' => Controls_Manager::SELECT,
162	'default' => '',
163	'options' => [
164	'' => esc_html__( 'Default', 'elementor' ),
165	'normal' => _x( 'Normal', 'Typography Control', 'elementor' ),
166	'italic' => _x( 'Italic', 'Typography Control', 'elementor' ),
167	'oblique' => _x( 'Oblique', 'Typography Control', 'elementor' ),
168	],
169	];
170
171	$fields['text_decoration'] = [
172	'label' => _x( 'Decoration', 'Typography Control', 'elementor' ),
173	'type' => Controls_Manager::SELECT,
174	'default' => '',
175	'options' => [
176	'' => esc_html__( 'Default', 'elementor' ),
177	'underline' => _x( 'Underline', 'Typography Control', 'elementor' ),
178	'overline' => _x( 'Overline', 'Typography Control', 'elementor' ),
179	'line-through' => _x( 'Line Through', 'Typography Control', 'elementor' ),
180	'none' => _x( 'None', 'Typography Control', 'elementor' ),
181	],
182	];
183
184	$fields['line_height'] = [
185	'label' => _x( 'Line-Height', 'Typography Control', 'elementor' ),
186	'type' => Controls_Manager::SLIDER,
187	'desktop_default' => [
188	'unit' => 'em',
189	],
190	'tablet_default' => [
191	'unit' => 'em',
192	],
193	'mobile_default' => [
194	'unit' => 'em',
195	],
196	'range' => [
197	'px' => [
198	'min' => 1,
199	],
200	],
201	'responsive' => true,
202	'size_units' => [ 'px', 'em' ],
203	'selector_value' => 'line-height: {{SIZE}}{{UNIT}}',
204	];
205
206	$fields['letter_spacing'] = [
207	'label' => _x( 'Letter Spacing', 'Typography Control', 'elementor' ),
208	'type' => Controls_Manager::SLIDER,
209	'range' => [
210	'px' => [
211	'min' => -5,
212	'max' => 10,
213	'step' => 0.1,
214	],
215	],
216	'responsive' => true,
217	'selector_value' => 'letter-spacing: {{SIZE}}{{UNIT}}',
218	];
219
220	return $fields;
221	}
222
223	/**
224	* Prepare fields.
225	*
226	* Process typography control fields before adding them to `add_control()`.
227	*
228	* @since 1.2.3
229	* @access protected
230	*
231	* @param array $fields Typography control fields.
232	*
233	* @return array Processed fields.
234	*/
235	protected function prepare_fields( $fields ) {
236	array_walk(
237	$fields, function( &$field, $field_name ) {
238
239	if ( in_array( $field_name, [ 'typography', 'popover_toggle' ] ) ) {
240	return;
241	}
242
243	$selector_value = ! empty( $field['selector_value'] ) ? $field['selector_value'] : str_replace( '_', '-', $field_name ) . ': {{VALUE}};';
244
245	$field['selectors'] = [
246	'{{SELECTOR}}' => $selector_value,
247	];
248	}
249	);
250
251	return parent::prepare_fields( $fields );
252	}
253
254	/**
255	* Add group arguments to field.
256	*
257	* Register field arguments to typography control.
258	*
259	* @since 1.2.2
260	* @access protected
261	*
262	* @param string $control_id Typography control id.
263	* @param array $field_args Typography control field arguments.
264	*
265	* @return array Field arguments.
266	*/
267	protected function add_group_args_to_field( $control_id, $field_args ) {
268	$field_args = parent::add_group_args_to_field( $control_id, $field_args );
269
270	$field_args['groupPrefix'] = $this->get_controls_prefix();
271	$field_args['groupType'] = 'typography';
272
273	$args = $this->get_args();
274
275	if ( in_array( $control_id, self::get_scheme_fields_keys() ) && ! empty( $args['scheme'] ) ) {
276	$field_args['scheme'] = [
277	'type' => self::get_type(),
278	'value' => $args['scheme'],
279	'key' => $control_id,
280	];
281	}
282
283	return $field_args;
284	}
285
286	/**
287	* Get default options.
288	*
289	* Retrieve the default options of the typography control. Used to return the
290	* default options while initializing the typography control.
291	*
292	* @since 1.9.0
293	* @access protected
294	*
295	* @return array Default typography control options.
296	*/
297	protected function get_default_options() {
298	return [
299	'popover' => [
300	'starter_name' => 'typography',
301	'starter_title' => _x( 'Typography', 'Typography Control', 'elementor' ),
302	'settings' => [
303	'render_type' => 'ui',
304	'groupType' => 'typography',
305	'global' => [
306	'active' => true,
307	],
308	],
309	],
310	];
311	}
312	}
313