WP_Block_Styles_Registry

15#[AllowDynamicProperties]16final class WP_Block_Styles_Registry {17	/**18	 * Registered block styles, as `$block_name => $block_style_name => $block_style_properties` multidimensional arrays.19	 *20	 * @since 5.3.021	 *22	 * @var array[]23	 */24	private $registered_block_styles = array();25 26	/**27	 * Container for the main instance of the class.28	 *29	 * @since 5.3.030	 *31	 * @var WP_Block_Styles_Registry|null32	 */33	private static $instance = null;34 35	/**36	 * Registers a block style for the given block type.37	 *38	 * If the block styles are present in a standalone stylesheet, register it and pass39	 * its handle as the `style_handle` argument. If the block styles should be inline,40	 * use the `inline_style` argument. Usually, one of them would be used to pass CSS41	 * styles. However, you could also skip them and provide CSS styles in any stylesheet42	 * or with an inline tag.43	 *44	 * @since 5.3.045	 * @since 6.6.0 Added ability to register style across multiple block types along with theme.json-like style data.46	 *47	 * @link https://developer.wordpress.org/block-editor/reference-guides/block-api/block-styles/48	 *49	 * @param string|string[] $block_name       Block type name including namespace or array of namespaced block type names.50	 * @param array           $style_properties {51	 *     Array containing the properties of the style.52	 *53	 *     @type string $name         The identifier of the style used to compute a CSS class.54	 *     @type string $label        A human-readable label for the style.55	 *     @type string $inline_style Inline CSS code that registers the CSS class required56	 *                                for the style.57	 *     @type string $style_handle The handle to an already registered style that should be58	 *                                enqueued in places where block styles are needed.59	 *     @type bool   $is_default   Whether this is the default style for the block type.60	 *     @type array  $style_data   Theme.json-like object to generate CSS from.61	 * }62	 * @return bool True if the block style was registered with success and false otherwise.63	 */64	public function register( $block_name, $style_properties ) {65 66		if ( ! is_string( $block_name ) && ! is_array( $block_name ) ) {67			_doing_it_wrong(68				__METHOD__,69				__( 'Block name must be a string or array.' ),70				'6.6.0'71			);72			return false;73		}74 75		if ( ! isset( $style_properties['name'] ) || ! is_string( $style_properties['name'] ) ) {76			_doing_it_wrong(77				__METHOD__,78				__( 'Block style name must be a string.' ),79				'5.3.0'80			);81			return false;82		}83 84		if ( str_contains( $style_properties['name'], ' ' ) ) {85			_doing_it_wrong(86				__METHOD__,87				__( 'Block style name must not contain any spaces.' ),88				'5.9.0'89			);90			return false;91		}92 93		$block_style_name = $style_properties['name'];94		$block_names      = is_string( $block_name ) ? array( $block_name ) : $block_name;