mirror of
https://github.com/WordPress/WordPress.git
synced 2024-12-25 18:48:57 +01:00
c0ed2c6f06
Adds logic that fixes the limitation for souces by allowing merging the `uses_context` defined by block bindings sources into supported block types. Each source defines the context it needs and it is added to the block types that are using the block bindings API. Fixes #60525. Props santosguillamot, gziolo, czapla, thekt12. Built from https://develop.svn.wordpress.org/trunk@57641 git-svn-id: http://core.svn.wordpress.org/trunk@57142 1a063a9b-81f0-0310-95a4-ce76da25c4cd
98 lines
2.1 KiB
PHP
98 lines
2.1 KiB
PHP
<?php
|
|
/**
|
|
* Block Bindings API: WP_Block_Bindings_Source class.
|
|
*
|
|
*
|
|
* @package WordPress
|
|
* @subpackage Block Bindings
|
|
* @since 6.5.0
|
|
*/
|
|
|
|
/**
|
|
* Class representing block bindings source.
|
|
*
|
|
* This class is designed for internal use by the Block Bindings registry.
|
|
*
|
|
* @since 6.5.0
|
|
* @access private
|
|
*
|
|
* @see WP_Block_Bindings_Registry
|
|
*/
|
|
final class WP_Block_Bindings_Source {
|
|
|
|
/**
|
|
* The name of the source.
|
|
*
|
|
* @since 6.5.0
|
|
* @var string
|
|
*/
|
|
public $name;
|
|
|
|
/**
|
|
* The label of the source.
|
|
*
|
|
* @since 6.5.0
|
|
* @var string
|
|
*/
|
|
public $label;
|
|
|
|
|
|
/**
|
|
* The function used to get the value from the source.
|
|
*
|
|
* @since 6.5.0
|
|
* @var callable
|
|
*/
|
|
private $get_value_callback;
|
|
|
|
/**
|
|
* The context added to the blocks needed by the source.
|
|
*
|
|
* @since 6.5.0
|
|
* @var array|null
|
|
*/
|
|
public $uses_context = null;
|
|
|
|
/**
|
|
* Constructor.
|
|
*
|
|
* Do not use this constructor directly. Instead, use the
|
|
* `WP_Block_Bindings_Registry::register` method or the `register_block_bindings_source` function.
|
|
*
|
|
* @since 6.5.0
|
|
*
|
|
* @param string $name The name of the source.
|
|
* @param array $source_properties The properties of the source.
|
|
*/
|
|
public function __construct( string $name, array $source_properties ) {
|
|
$this->name = $name;
|
|
foreach ( $source_properties as $property_name => $property_value ) {
|
|
$this->$property_name = $property_value;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Retrieves the value from the source.
|
|
*
|
|
* @since 6.5.0
|
|
*
|
|
* @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.
|
|
*
|
|
* @return mixed The value of the source.
|
|
*/
|
|
public function get_value( array $source_args, $block_instance, string $attribute_name ) {
|
|
return call_user_func_array( $this->get_value_callback, array( $source_args, $block_instance, $attribute_name ) );
|
|
}
|
|
|
|
/**
|
|
* Wakeup magic method.
|
|
*
|
|
* @since 6.5.0
|
|
*/
|
|
public function __wakeup() {
|
|
throw new \LogicException( __CLASS__ . ' should never be unserialized' );
|
|
}
|
|
}
|