wp_get_typography_font_size_value( array $preset, bool|array $settings = array() ): string|null

Description

Parameters

$presetarray

Required. fontSizes preset value as seen in theme.json.

• $namestring

  Name of the font size preset.

• $slugstring

  Kebab-case, unique identifier for the font size preset.

• $sizestring|int|float

  CSS font-size value, including units if applicable.

$settingsbool|arrayoptional

Optional Theme JSON settings array that overrides any global theme settings. Default is false.Default: array()

Return

string|null

Font-size value or null if a size is not passed in $preset.

Uses · 6

• _deprecated_argument()Marks a function argument as deprecated and inform when it has been used.
• __()Retrieves the translation of $text.
• wp_get_global_settings()Gets the settings resulting of merging core, theme, and user data.
• wp_parse_args()Merges user defined arguments into defaults array.
• wp_get_typography_value_and_unit()Checks a string for a unit and value and returns an array consisting of `'value'` and `'unit'`, e.g. array( '42', 'rem' ).
• wp_get_computed_fluid_typography_value()Internal implementation of CSS clamp() based on available min/max viewport width and min/max font sizes.

Used by · 7

• WP_Theme_JSON::compute_style_properties()Given a styles array, it extracts the style properties and adds them to the $declarations array following the format:
• block_core_navigation_link_build_css_font_sizes()Build an array with CSS classes and inline styles defining the font sizes which will be applied to the navigation markup in the front-end.
• block_core_navigation_submenu_build_css_font_sizes()Build an array with CSS classes and inline styles defining the font sizes which will be applied to the navigation markup in the front-end.
• block_core_page_list_build_css_font_sizes()Build an array with CSS classes and inline styles defining the font sizes which will be applied to the pages markup in the front-end when it is a descendant of navigation.
• get_typography_styles_for_block_core_search()Returns typography styles to be included in an HTML style tag.
• wp_apply_typography_support()Adds CSS classes and inline styles for typography features such as font sizes to the incoming attributes array. This will be applied to the block markup in the front-end.
• wp_render_typography_support()Renders typography styles/content to the block wrapper.

Source

View on Trac ↗View on GitHub ↗

553function wp_get_typography_font_size_value( $preset, $settings = array() ) {554	if ( ! isset( $preset['size'] ) ) {555		return null;556	}557 558	/*559	 * Catches falsy values and 0/'0'. Fluid calculations cannot be performed on `0`.560	 * Also returns early when a preset font size explicitly disables fluid typography with `false`.561	 */562	$fluid_font_size_settings = $preset['fluid'] ?? null;563	if ( false === $fluid_font_size_settings || empty( $preset['size'] ) ) {564		return $preset['size'];565	}566 567	/*568	 * As a boolean (deprecated since 6.6), $settings acts as an override to switch fluid typography "on" (`true`) or "off" (`false`).569	 */570	if ( is_bool( $settings ) ) {571		_deprecated_argument( __FUNCTION__, '6.6.0', __( '`boolean` type for second argument `$settings` is deprecated. Use `array()` instead.' ) );572		$settings = array(573			'typography' => array(574				'fluid' => $settings,575			),576		);577	}578 579	// Fallback to global settings as default.580	$global_settings = wp_get_global_settings();581	$settings        = wp_parse_args(582		$settings,583		$global_settings584	);585 586	$typography_settings = $settings['typography'] ?? array();587 588	/*589	 * Return early when fluid typography is disabled in the settings, and there590	 * are no local settings to enable it for the individual preset.591	 *592	 * If this condition isn't met, either the settings or individual preset settings593	 * have enabled fluid typography.594	 */595	if ( empty( $typography_settings['fluid'] ) && empty( $fluid_font_size_settings ) ) {596		return $preset['size'];597	}598 599	$fluid_settings  = $typography_settings['fluid'] ?? array();600	$layout_settings = $settings['layout'] ?? array();601 602	// Defaults.603	$default_maximum_viewport_width       = '1600px';604	$default_minimum_viewport_width       = '320px';605	$default_minimum_font_size_factor_max = 0.75;606	$default_minimum_font_size_factor_min = 0.25;607	$default_scale_factor                 = 1;608	$default_minimum_font_size_limit      = '14px';609 610	// Defaults overrides.611	$minimum_viewport_width = $fluid_settings['minViewportWidth'] ?? $default_minimum_viewport_width;612	$maximum_viewport_width = isset( $layout_settings['wideSize'] ) && ! empty( wp_get_typography_value_and_unit( $layout_settings['wideSize'] ) ) ? $layout_settings['wideSize'] : $default_maximum_viewport_width;613	if ( isset( $fluid_settings['maxViewportWidth'] ) ) {614		$maximum_viewport_width = $fluid_settings['maxViewportWidth'];615	}616	$has_min_font_size       = isset( $fluid_settings['minFontSize'] ) && ! empty( wp_get_typography_value_and_unit( $fluid_settings['minFontSize'] ) );617	$minimum_font_size_limit = $has_min_font_size ? $fluid_settings['minFontSize'] : $default_minimum_font_size_limit;618 619	// Try to grab explicit min and max fluid font sizes.620	$minimum_font_size_raw = $fluid_font_size_settings['min'] ?? null;621	$maximum_font_size_raw = $fluid_font_size_settings['max'] ?? null;622 623	// Font sizes.624	$preferred_size = wp_get_typography_value_and_unit( $preset['size'] );625 626	// Protects against unsupported units.627	if ( empty( $preferred_size['unit'] ) ) {628		return $preset['size'];629	}630 631	/*632	 * Normalizes the minimum font size limit according to the incoming unit,

History

Introduced in 6.1.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.0.4 tag, from src/wp-includes/block-supports/typography.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.