A method for adding block variants

[BinaryMoon]

I would like to add block variants to my theme, essentially adding classes to the block container. I already add css classes to the theme and they can be styled in the editor by adding the custom class in the advanced block settings, but if there was an easy way to add additional variants then it would improve discoverability for users.

Ideally this would be a simple php request added via add_theme_support. Something along the lines of:

add_theme_support(
   'block-variants',
   array(
      'block-name-1' => array(
         'variant-class-1',
         'variant-class-2',
         'variant-class-3',
      ),
      'block-name-2' => array(
         'variant-class-1',
         'variant-class-2',
         'variant-class-3',
      ),
   )
);

I guess a javascript option would be possible also, but using add_theme_support seems like a clean and elegant 'WordPressy' way to do it. But any method would be great.

[youknowriad]

It's already possible in JavaScript see #7997

Documentation is lacking though.

[BinaryMoon]

Ah ha - excellent. And I've now found a ticket for adding docs: #8145

Is there a way to escalate that ticket? The only way to get people to use these things (and test them) is if they know how they work.

[youknowriad]

Maybe you can help adding this to the docs :) The Block API page on the handbook seems like a good page for it :)

[youknowriad]

I'm closing this issue for now. but yeah I'll try to see if I can add docs if no one beats me to it. :)

[BinaryMoon]

I would happily add to the docs but since I don't understand how to use the command I can't document it :)