Block Support: Add anchor support for dynamic blocks

Author: t-hamano

docs/reference-guides/core-blocks.md

@@ -0,0 +1,63 @@
+<?php
+/**
+ * Anchor block support flag.
+ *
+ * @package gutenberg
+ */
+
+/**
+ * Registers the anchor block attribute for block types that support it.
+ *
+ * @param WP_Block_Type $block_type Block Type.
+ */
+function gutenberg_register_anchor_support( $block_type ) {
+	$has_anchor_support = block_has_support( $block_type, array( 'anchor' ), false );
+
+	if ( ! $has_anchor_support ) {
+		return;
+	}
+
+	if ( ! $block_type->attributes ) {
+		$block_type->attributes = array();
+	}
+
+	if ( ! array_key_exists( 'anchor', $block_type->attributes ) ) {
+		$block_type->attributes['anchor'] = array(
+			'type' => 'string',
+		);
+	}
+}
+
+/**
+ * Add the anchor to the output.
+ *
+ * @param WP_Block_Type $block_type Block Type.
+ * @param array         $block_attributes Block attributes.
+ *
+ * @return array Block anchor.
+ */
+function gutenberg_apply_anchor_support( $block_type, $block_attributes ) {
+	if ( ! $block_attributes ) {
+		return array();
+	}
+
+	$has_anchor_support = block_has_support( $block_type, array( 'anchor' ), false );
+	if ( ! $has_anchor_support ) {
+		return array();
+	}
+
+	$has_anchor = array_key_exists( 'anchor', $block_attributes );
+	if ( ! $has_anchor ) {
+		return array();
+	}
+	return array( 'id' => $block_attributes['anchor'] );
+}
+
+// Register the block support.
+WP_Block_Supports::get_instance()->register(
+	'anchor',
+	array(
+		'register_attribute' => 'gutenberg_register_anchor_support',
+		'apply'              => 'gutenberg_apply_anchor_support',
+	)
+);

lib/block-supports/anchor.php

@@ -151,6 +151,7 @@ function gutenberg_is_experiment_enabled( $name ) {
 require __DIR__ . '/block-supports/shadow.php';
 require __DIR__ . '/block-supports/background.php';
 require __DIR__ . '/block-supports/block-style-variations.php';
+require __DIR__ . '/block-supports/anchor.php';
 require __DIR__ . '/block-supports/aria-label.php';
 
 // Data views.

lib/load.php

@@ -26,6 +26,7 @@
 	},
 	"supports": {
 		"align": true,
+		"anchor": true,
 		"__experimentalBorder": {
 			"radius": true,
 			"color": true,

packages/block-library/src/archives/block.json

@@ -27,6 +27,7 @@
 	"supports": {
 		"html": false,
 		"align": true,
+		"anchor": true,
 		"alignWide": false,
 		"spacing": {
 			"margin": true,

packages/block-library/src/avatar/block.json

@@ -17,6 +17,7 @@
 	},
 	"supports": {
 		"align": true,
+		"anchor": true,
 		"html": false,
 		"color": {
 			"link": true,

packages/block-library/src/calendar/block.json

@@ -44,6 +44,7 @@
 	"usesContext": [ "enhancedPagination" ],
 	"supports": {
 		"align": true,
+		"anchor": true,
 		"html": false,
 		"spacing": {
 			"margin": true,

packages/block-library/src/categories/block.json

@@ -20,6 +20,7 @@
 	},
 	"usesContext": [ "commentId" ],
 	"supports": {
+		"anchor": true,
 		"html": false,
 		"inserter": false,
 		"__experimentalBorder": {

packages/block-library/src/comment-author-avatar/block.json

@@ -22,6 +22,7 @@
 	},
 	"usesContext": [ "commentId" ],
 	"supports": {
+		"anchor": true,
 		"html": false,
 		"spacing": {
 			"margin": true,

packages/block-library/src/comment-author-name/block.json

@@ -14,6 +14,7 @@
 		}
 	},
 	"supports": {
+		"anchor": true,
 		"color": {
 			"gradients": true,
 			"link": true,