Changeset 58395 for trunk/src/wp-includes/class-wp-block-bindings-registry.php

Timestamp:

06/12/2024 12:42:28 PM (2 years ago)

Author:

SergeyBiryukov

Message:

Docs: Correct alignment in WP_Block_Bindings_Registry::register() DocBlock.

Follow-up to [57373], [57375], [57641].

Props nareshbheda, mukesh27.
Fixes #61412.

File:

• trunk/src/wp-includes/class-wp-block-bindings-registry.php (modified) (1 diff)

trunk/src/wp-includes/class-wp-block-bindings-registry.php

@@ -73 +73 @@
          * @since 6.5.0
          *
-         * @param string   $source_name       The name of the source. It must be a string containing a namespace prefix, i.e.
-         *                                    `my-plugin/my-custom-source`. It must only contain lowercase alphanumeric
-         *                                    characters, the forward slash `/` and dashes.
-         * @param array    $source_properties {
+         * @param string $source_name       The name of the source. It must be a string containing a namespace prefix, i.e.
+         *                                  `my-plugin/my-custom-source`. It must only contain lowercase alphanumeric
+         *                                  characters, the forward slash `/` and dashes.
+         * @param array  $source_properties {
          *     The array of arguments that are used to register a source.
          *
-         *     @type string   $label                   The label of the source.
-         *     @type callable $get_value_callback      A callback executed when the source is processed during block rendering.
-         *                                             The callback should have the following signature:
-         *
-         *                                             `function ($source_args, $block_instance,$attribute_name): mixed`
-         *                                                 - @param array    $source_args    Array containing source arguments
-         *                                                                                   used to look up the override value,
-         *                                                                                   i.e. {"key": "foo"}.
-         *                                                 - @param WP_Block $block_instance The block instance.
-         *                                                 - @param string   $attribute_name The name of the target attribute.
-         *                                             The callback has a mixed return type; it may return a string to override
-         *                                             the block's original value, null, false to remove an attribute, etc.
-         *     @type string[] $uses_context (optional) Array of values to add to block `uses_context` needed by the source.
+         *     @type string   $label              The label of the source.
+         *     @type callable $get_value_callback A callback executed when the source is processed during block rendering.
+         *                                        The callback should have the following signature:
+         *
+         *                                        `function( $source_args, $block_instance, $attribute_name ): mixed`
+         *                                            - @param array    $source_args    Array containing source arguments
+         *                                                                              used to look up the override value,
+         *                                                                              i.e. {"key": "foo"}.
+         *                                            - @param WP_Block $block_instance The block instance.
+         *                                            - @param string   $attribute_name The name of the target attribute.
+         *                                        The callback has a mixed return type; it may return a string to override
+         *                                        the block's original value, null, false to remove an attribute, etc.
+         *     @type string[] $uses_context       Optional. Array of values to add to block `uses_context` needed by the source.
          * }
          * @return WP_Block_Bindings_Source|false Source when the registration was successful, or `false` on failure.