A WordPress-centric search engine for devs and theme authors



register_block_style_handle ›

Since5.5.0
Deprecatedn/a
› register_block_style_handle ( $metadata, $field_name )
Parameters: (2)
  • (array) $metadata Block metadata.
    Required: Yes
  • (string) $field_name Field name to pick from metadata.
    Required: Yes
Returns:
  • (string|false) Style handle provided directly or created through style's registration, or false on failure.
Defined at:
Codex:

Finds a style handle for the block metadata field. It detects when a path to file was provided and registers the style under automatically generated handle name. It returns unprocessed style handle otherwise.



Related Functions: register_block_script_handle, register_block_style, unregister_block_style, register_block_type, unregister_block_type

Source 

function register_block_style_handle( $metadata, $field_name ) {
	if ( empty( $metadata[ $field_name ] ) ) {
		return false;
	}
	$style_handle = $metadata[ $field_name ];
	$style_path   = remove_block_asset_path_prefix( $metadata[ $field_name ] );
	if ( $style_handle === $style_path ) {
		return $style_handle;
	}

	$style_handle = generate_block_asset_handle( $metadata['name'], $field_name );
	$block_dir    = dirname( $metadata['file'] );
	$style_file   = realpath( "$block_dir/$style_path" );
	$result       = wp_register_style(
		$style_handle,
		plugins_url( $style_path, $metadata['file'] ),
		array(),
		filemtime( $style_file )
	);
	if ( file_exists( str_replace( '.css', '-rtl.css', $style_file ) ) ) {
		wp_style_add_data( $style_handle, 'rtl', 'replace' );
	}

	return $result ? $style_handle : false;
}