WP_Block_Bindings_Source

20final class WP_Block_Bindings_Source {21 22	/**23	 * The name of the source.24	 *25	 * @since 6.5.026	 * @var string27	 */28	public $name;29 30	/**31	 * The label of the source.32	 *33	 * @since 6.5.034	 * @var string35	 */36	public $label;37 38	/**39	 * The function used to get the value from the source.40	 *41	 * @since 6.5.042	 * @var callable43	 */44	private $get_value_callback;45 46	/**47	 * The context added to the blocks needed by the source.48	 *49	 * @since 6.5.050	 * @var string[]|null51	 */52	public $uses_context = null;53 54	/**55	 * Constructor.56	 *57	 * Do not use this constructor directly. Instead, use the58	 * `WP_Block_Bindings_Registry::register` method or the `register_block_bindings_source` function.59	 *60	 * @since 6.5.061	 *62	 * @param string $name              The name of the source.63	 * @param array  $source_properties The properties of the source.64	 */65	public function __construct( string $name, array $source_properties ) {66		$this->name = $name;67		foreach ( $source_properties as $property_name => $property_value ) {68			$this->$property_name = $property_value;69		}70	}71 72	/**73	 * Calls the callback function specified in the `$get_value_callback` property74	 * with the given arguments and returns the result. It can be modified with75	 * `block_bindings_source_value` filter.76	 *77	 * @since 6.5.078	 * @since 6.7.0 `block_bindings_source_value` filter was added.79	 *80	 * @param array    $source_args    Array containing source arguments used to look up the override value, i.e. {"key": "foo"}.81	 * @param WP_Block $block_instance The block instance.82	 * @param string   $attribute_name The name of the target attribute.83	 * @return mixed The value of the source.84	 */85	public function get_value( array $source_args, $block_instance, string $attribute_name ) {86		$value = call_user_func_array( $this->get_value_callback, array( $source_args, $block_instance, $attribute_name ) );87		/**88		 * Filters the output of a block bindings source.89		 *90		 * @since 6.7.091		 *92		 * @param mixed    $value          The computed value for the source.93		 * @param string   $name           The name of the source.94		 * @param array    $source_args    Array containing source arguments used to look up the override value, i.e. { "key": "foo" }.95		 * @param WP_Block $block_instance The block instance.96		 * @param string   $attribute_name The name of an attribute.97		 */98		return apply_filters( 'block_bindings_source_value', $value, $this->name, $source_args, $block_instance, $attribute_name );99	}