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

Timestamp:

06/12/2024 12:42:28 PM (16 months 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.