Stabilize the __experimentalBorder support #65968

benazeer-ben · 2024-10-09T07:00:06Z

What?

Updating php code and JS implementation to work both '--experimental' and non '--experimental ' prefix.
#64312

Why?

This issue outlines the tasks needed to stabilize the __experimentalBorder support. Doing so will make it easier for third-party extenders to confidently build custom blocks that provide border support and modify existing blocks with this support.

How?

Updating PHP block support code in lib/block-supports/border.php to use the non __experimental prefix, falling back to the __experimental prefix if available.

Also updated JS implementation to use the non __experimental prefix.

Testing Instructions

Open a post or page.
Apply border to any of the section in the post/ page/ template.
Border functionality will work fine even after updating the code with non experimental prefixes.

Note: Here we need to update the WP core blocks' block.json files to use the non __experimental prefixes.

… the non __experimental prefix

github-actions · 2024-10-09T07:00:22Z

The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. You can also manually ask me to refresh this list by adding the props-bot label.

If you're merging code through a pull request on GitHub, copy and paste the following into the bottom of the merge commit message.

Co-authored-by: benazeer-ben <benazeer@git.wordpress.org>
Co-authored-by: andrewserong <andrewserong@git.wordpress.org>
Co-authored-by: ndiego <ndiego@git.wordpress.org>
Co-authored-by: aaronrobertshaw <aaronrobertshaw@git.wordpress.org>

To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook.

github-actions · 2024-10-09T07:00:31Z

👋 Thanks for your first Pull Request and for helping build the future of Gutenberg and WordPress, @benazeer-ben! In case you missed it, we'd love to have you join us in our Slack community.

If you want to learn more about WordPress development in general, check out the Core Handbook full of helpful information.

ndiego · 2024-10-10T16:38:42Z

Thanks so much for working on this @benazeer-ben! There are a few WordPress coding standard issues that are flagged here, but otherwise, this is looking very good. @Mamaduka or @gziolo would you be able to do a more comprehensive code review?

I just tested it with my own Icon Block, which is currently using __experimentalBorder. It continues to work without issue with this PR and updating the support to border results is no changes, as expected.

With `__experimentalBorder`

Editor	Front end

With `border`

Editor	Front end

ndiego · 2024-10-10T16:45:46Z

I do want to note that as a follow-up to this PR, we will need to update all Core blocks that currently use __experimentalBorder.

benazeer-ben · 2024-10-24T12:17:47Z

Hi @ndiego

We are waiting for the code review feedback and accordingly proceed adding support for other blocks.

ndiego · 2024-10-24T16:59:32Z

We are waiting for the code review feedback and accordingly proceed adding support for other blocks.

Sorry for the delay. WordPress 6.7 is taking much of the focus right now. @andrewserong forgive the ping, but perhaps you might be able to do a code review whenever you have a sec? Everything seems to work correctly in my testing.

ndiego · 2024-10-24T17:15:49Z

I also want to note that additional PRs will be needed to complete the task list in the original issue, or you could bundle everything here.

andrewserong

Thanks for the ping @ndiego and for working on this @benazeer-ben! I'm a little short on time this week, so I've only given this a quick pass but will hopefully take it for a more detailed spin next week.

I've left a couple of small comments. Something I was wondering about is whether the PHP implementation should also perform a transformation? I tried that in #63401 for the Typography supports, but it did also add a little extra complexity.

Overall, I like that you've gone with the simplest possible change for this PR, that seems like a pragmatic path forwards. Having the Border support (in PHP) be aware of both the experimental and non experimental properties sounds reasonable to me 👍

Once this is ready for review, similar to #63401, I think it'd be good to do a wider ping / gather more folks to help testing and confidence check the approach. I'm a little biased as I already think this is a good way to do it, so I am a tiny bit cautious about approving on my own 🙂

andrewserong · 2024-10-25T01:23:45Z

lib/block-supports/border.php

@@ -17,7 +17,7 @@ function gutenberg_register_border_support( $block_type ) {
 		$block_type->attributes = array();
 	}

-	if ( block_has_support( $block_type, array( '__experimentalBorder' ) ) && ! array_key_exists( 'style', $block_type->attributes ) ) {
+	if ( block_has_support( $block_type, array( 'border', '__experimentalBorder' ) ) && ! array_key_exists( 'style', $block_type->attributes ) ) {


I haven't tested this, but I think this needs to have two block_has_supports checks (one for border and one for __experimentalBorder) as an array passed to this function is treated as a path, rather than an OR. I see there's a similar check down in line 158 that looks correct to me.

Thanks for your suggestions @andrewserong

I have updated this case in the recent commit.

andrewserong · 2024-10-25T01:31:05Z

lib/block-supports/border.php

-				'width' => isset( $border['width'] ) && ! wp_should_skip_block_supports_serialization( $block_type, '__experimentalBorder', 'width' ) ? $border['width'] : null,
-				'color' => isset( $border['color'] ) && ! wp_should_skip_block_supports_serialization( $block_type, '__experimentalBorder', 'color' ) ? $border['color'] : null,
-				'style' => isset( $border['style'] ) && ! wp_should_skip_block_supports_serialization( $block_type, '__experimentalBorder', 'style' ) ? $border['style'] : null,
+				'width' => isset( $border['width'] ) && ! wp_should_skip_block_supports_serialization( $block_type, 'border', 'width' ) ? $border['width'] : null,
+				'color' => isset( $border['color'] ) && ! wp_should_skip_block_supports_serialization( $block_type, 'border', 'color' ) ? $border['color'] : null,
+				'style' => isset( $border['style'] ) && ! wp_should_skip_block_supports_serialization( $block_type, 'border', 'style' ) ? $border['style'] : null,


Does this need to handle the skip serialization for the __experimentalBorder case, too?

In order to make sure that, now I have added the skip serialization for the __experimentalBorder case too.

andrewserong · 2024-10-25T01:34:27Z

packages/blocks/src/store/process-block-type.js

@@ -61,7 +61,22 @@ function mergeBlockVariations(

 	return result;
 }
+function handleExperimentalBorder( rawSupports ) {


We'll also need to handle the transformation for Typography at some point (which I worked on in #63401). Would it be worth renaming this to stabilizeSupports so that we have one function call, and we can add other stabilized supports to the body of the function in follow-ups?

Function name has been updated as you mentioned above.

…o iteration/stabilize-experimental-border-prefixes

aaronrobertshaw · 2024-11-12T08:13:34Z

Thank you for all your work and patience here @benazeer-ben 🙇

There have been a number of PRs attempting to stabilize the border block supports, each a little different from the last. Now that the typography block support stabilization in #63401 has landed we have a best practice guide on how to achieve this.

An alternative PR (#64330) has mostly been on my radar but both that PR and this have some missing pieces in different ways. I've put up a fresh PR that extends the approach in #63401.

I'd like to propose closing this PR in favour of #66918 so we can all consolidate around a single approach. How's that sound to you?

I'd also like to stress that the work you've done here has been great and is appreciated!

Update PHP block support code in lib/block-supports/border.php to use…

cace01d

… the non __experimental prefix

benazeer-ben requested a review from spacedmonkey as a code owner October 9, 2024 07:00

github-actions bot added the First-time Contributor Pull request opened by a first-time contributor to Gutenberg repository label Oct 9, 2024

Update JS implementations to use the non __experimental prefix

344e635

benazeer-ben requested a review from tellthemachines as a code owner October 9, 2024 09:30

benazeer-ben changed the title ~~Update PHP block support code in lib/block-supports/border.php to use…~~ Update PHP block support code & JS implementations to use… Oct 9, 2024

annezazu changed the title ~~Update PHP block support code & JS implementations to use…~~ Stabilize the __experimentalBorder support Oct 9, 2024

justintadlock mentioned this pull request Oct 9, 2024

Tracking: A curated list of high-priority extensibility issues and enhancements #64848

Open

24 tasks

ndiego added [Feature] Design Tools Tools that impact the appearance of blocks both to expand the number of tools and improve the experi [Package] Block library /packages/block-library labels Oct 10, 2024

ndiego added the [Type] Enhancement A suggestion for improvement. label Oct 10, 2024

PHPCS FIX

5277b53

andrewserong reviewed Oct 25, 2024

View reviewed changes

andrewserong mentioned this pull request Oct 28, 2024

Stabilize the Experimental block supports property #65912

Open

benazeer-ben added 4 commits October 28, 2024 20:00

Merge branch 'trunk' of https://github.com/benazeer-ben/gutenberg int…

aae3411

…o iteration/stabilize-experimental-border-prefixes

Review feedback changes

97a8dd1

PHPCS fixex

f9dbbfc

PHPCS fixes

849a6d3

benazeer-ben mentioned this pull request Oct 30, 2024

Stabilize --experimentalBorder php file changes WordPress/wordpress-develop#7686

Closed

Backport changelog

5f2cd17

aaronrobertshaw mentioned this pull request Nov 12, 2024

Borders: Stabilize border block supports within block processing #66918

Merged

benazeer-ben closed this Nov 12, 2024

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Stabilize the __experimentalBorder support #65968

Stabilize the __experimentalBorder support #65968

benazeer-ben commented Oct 9, 2024 •

edited

Loading

github-actions bot commented Oct 9, 2024 •

edited

Loading

github-actions bot commented Oct 9, 2024

ndiego commented Oct 10, 2024

ndiego commented Oct 10, 2024

benazeer-ben commented Oct 24, 2024

ndiego commented Oct 24, 2024

ndiego commented Oct 24, 2024

andrewserong left a comment

andrewserong Oct 25, 2024

benazeer-ben Oct 29, 2024

andrewserong Oct 25, 2024

benazeer-ben Oct 29, 2024

andrewserong Oct 25, 2024

benazeer-ben Oct 29, 2024

aaronrobertshaw commented Nov 12, 2024 •

edited

Loading

Stabilize the __experimentalBorder support #65968

Stabilize the __experimentalBorder support #65968

Conversation

benazeer-ben commented Oct 9, 2024 • edited Loading

github-actions bot commented Oct 9, 2024 • edited Loading

github-actions bot commented Oct 9, 2024

ndiego commented Oct 10, 2024

With __experimentalBorder

With border

ndiego commented Oct 10, 2024

benazeer-ben commented Oct 24, 2024

ndiego commented Oct 24, 2024

ndiego commented Oct 24, 2024

andrewserong left a comment

Choose a reason for hiding this comment

andrewserong Oct 25, 2024

Choose a reason for hiding this comment

benazeer-ben Oct 29, 2024

Choose a reason for hiding this comment

andrewserong Oct 25, 2024

Choose a reason for hiding this comment

benazeer-ben Oct 29, 2024

Choose a reason for hiding this comment

andrewserong Oct 25, 2024

Choose a reason for hiding this comment

benazeer-ben Oct 29, 2024

Choose a reason for hiding this comment

aaronrobertshaw commented Nov 12, 2024 • edited Loading

benazeer-ben commented Oct 9, 2024 •

edited

Loading

github-actions bot commented Oct 9, 2024 •

edited

Loading

With `__experimentalBorder`

With `border`

aaronrobertshaw commented Nov 12, 2024 •

edited

Loading