WordPress unregisterBlockStyle

unregisterBlockStyle() is a function in WordPress that allows a developer to unregister a specific block style from a Gutenberg block.

When to use unregisterBlockStyle()

Sometimes, a developer might want to unregister a block style for a specific block because it doesn't fit the design or layout of their site. For example, a theme developer might want to unregister the "Wide Width" block style from the Cover block because it doesn't fit well with the theme's design.

How to use unregisterBlockStyle()

The unregisterBlockStyle() function takes two arguments:

1. The block's name
2. The name of the block style that is being unregistered.

Here's an example of how to unregister the "Wide Width" block style from the Cover block:

function my_unregister_block_style() {
    unregisterBlockStyle( 'core/cover', 'wide' );
}
add_action( 'init', 'my_unregister_block_style' );

In this example, we use add_action() to register a function, my_unregister_block_style(), to the init action. Inside this function, we call the unregisterBlockStyle() function with the block name (core/cover) and the name of the block style that we want to unregister (wide).

Conclusion

With unregisterBlockStyle(), a developer can easily unregister specific block styles for a specific block in their theme or plugin, and create a more customized user experience.