wp_apply_typography_support( WP_Block_Type $block_type, array $block_attributes ): array

Parameters

$block_typeWP_Block_Type

Block type.

$block_attributesarray

Block attributes.

Return

array

Typography CSS classes and inline styles.

Uses · 4

• wp_should_skip_block_supports_serialization()Checks whether serialization of the current block's supported properties should occur.
• wp_get_typography_font_size_value()Returns a font-size value based on a given font-size preset.
• wp_typography_get_preset_inline_style_value()Generates an inline style value for a typography feature e.g. text decoration, text transform, and font style.
• wp_style_engine_get_styles()Global public interface method to generate styles from a single style object, e.g. the value of a block's attributes.style object or the top level styles in theme.json.

Source

View on Trac ↗View on GitHub ↗

89function wp_apply_typography_support( $block_type, $block_attributes ) {90	if ( ! ( $block_type instanceof WP_Block_Type ) ) {91		return array();92	}93 94	$typography_supports = isset( $block_type->supports['typography'] )95		? $block_type->supports['typography']96		: false;97	if ( ! $typography_supports ) {98		return array();99	}100 101	if ( wp_should_skip_block_supports_serialization( $block_type, 'typography' ) ) {102		return array();103	}104 105	$has_font_family_support     = isset( $typography_supports['__experimentalFontFamily'] ) ? $typography_supports['__experimentalFontFamily'] : false;106	$has_font_size_support       = isset( $typography_supports['fontSize'] ) ? $typography_supports['fontSize'] : false;107	$has_font_style_support      = isset( $typography_supports['__experimentalFontStyle'] ) ? $typography_supports['__experimentalFontStyle'] : false;108	$has_font_weight_support     = isset( $typography_supports['__experimentalFontWeight'] ) ? $typography_supports['__experimentalFontWeight'] : false;109	$has_letter_spacing_support  = isset( $typography_supports['__experimentalLetterSpacing'] ) ? $typography_supports['__experimentalLetterSpacing'] : false;110	$has_line_height_support     = isset( $typography_supports['lineHeight'] ) ? $typography_supports['lineHeight'] : false;111	$has_text_align_support      = isset( $typography_supports['textAlign'] ) ? $typography_supports['textAlign'] : false;112	$has_text_columns_support    = isset( $typography_supports['textColumns'] ) ? $typography_supports['textColumns'] : false;113	$has_text_decoration_support = isset( $typography_supports['__experimentalTextDecoration'] ) ? $typography_supports['__experimentalTextDecoration'] : false;114	$has_text_transform_support  = isset( $typography_supports['__experimentalTextTransform'] ) ? $typography_supports['__experimentalTextTransform'] : false;115	$has_writing_mode_support    = isset( $typography_supports['__experimentalWritingMode'] ) ? $typography_supports['__experimentalWritingMode'] : false;116 117	// Whether to skip individual block support features.118	$should_skip_font_size       = wp_should_skip_block_supports_serialization( $block_type, 'typography', 'fontSize' );119	$should_skip_font_family     = wp_should_skip_block_supports_serialization( $block_type, 'typography', 'fontFamily' );120	$should_skip_font_style      = wp_should_skip_block_supports_serialization( $block_type, 'typography', 'fontStyle' );121	$should_skip_font_weight     = wp_should_skip_block_supports_serialization( $block_type, 'typography', 'fontWeight' );122	$should_skip_line_height     = wp_should_skip_block_supports_serialization( $block_type, 'typography', 'lineHeight' );123	$should_skip_text_align      = wp_should_skip_block_supports_serialization( $block_type, 'typography', 'textAlign' );124	$should_skip_text_columns    = wp_should_skip_block_supports_serialization( $block_type, 'typography', 'textColumns' );125	$should_skip_text_decoration = wp_should_skip_block_supports_serialization( $block_type, 'typography', 'textDecoration' );126	$should_skip_text_transform  = wp_should_skip_block_supports_serialization( $block_type, 'typography', 'textTransform' );127	$should_skip_letter_spacing  = wp_should_skip_block_supports_serialization( $block_type, 'typography', 'letterSpacing' );128	$should_skip_writing_mode    = wp_should_skip_block_supports_serialization( $block_type, 'typography', 'writingMode' );129 130	$typography_block_styles = array();131	if ( $has_font_size_support && ! $should_skip_font_size ) {132		$preset_font_size                    = array_key_exists( 'fontSize', $block_attributes )133			? "var:preset|font-size|{$block_attributes['fontSize']}"134			: null;135		$custom_font_size                    = isset( $block_attributes['style']['typography']['fontSize'] )136			? $block_attributes['style']['typography']['fontSize']137			: null;138		$typography_block_styles['fontSize'] = $preset_font_size ? $preset_font_size : wp_get_typography_font_size_value(139			array(140				'size' => $custom_font_size,141			)142		);143	}144 145	if ( $has_font_family_support && ! $should_skip_font_family ) {146		$preset_font_family                    = array_key_exists( 'fontFamily', $block_attributes )147			? "var:preset|font-family|{$block_attributes['fontFamily']}"148			: null;149		$custom_font_family                    = isset( $block_attributes['style']['typography']['fontFamily'] )150			? wp_typography_get_preset_inline_style_value( $block_attributes['style']['typography']['fontFamily'], 'font-family' )151			: null;152		$typography_block_styles['fontFamily'] = $preset_font_family ? $preset_font_family : $custom_font_family;153	}154 155	if (156		$has_font_style_support &&157		! $should_skip_font_style &&158		isset( $block_attributes['style']['typography']['fontStyle'] )159	) {160		$typography_block_styles['fontStyle'] = wp_typography_get_preset_inline_style_value(161			$block_attributes['style']['typography']['fontStyle'],162			'font-style'163		);164	}165 166	if (167		$has_font_weight_support &&168		! $should_skip_font_weight &&

History

Introduced in 5.6.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 6.8.8 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.